助力 .NET MAUI Community Toolkit

微软中国MSDN 点击上方蓝字关注我们

最近，我们推出了.NET MAUI Community Toolkit，并且现在已做好了接受社区贡献的准备。

我们修改了添加新功能的工作流程，在此分享给各位，以方便大家今后继续完善，做出贡献。

我们还为此创建了一个项目看板，以便您在这里跟踪新的工作流程：

参考链接：

.NET MAUI Community Toolkit：
https://devblogs.microsoft.com/dotnet/introducing-the-net-maui-community-toolkit-preview/?WT.mc_id=mobile-44689-bramin
接受社区贡献：
https://github.com/CommunityToolkit/Maui/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22
新功能工作流程：
https://github.com/CommunityToolkit/Maui/projects/1
项目看板:
https://github.com/CommunityToolkit/Maui/projects/1

新功能工作流程

新功能工作流程在很大程度上受到了C#团队当前工作流程的启发，能够优化其Discussions and Proposals的实施。

展开讨论

所有的新功能都将以讨论的形式开始。

作为一个社区，我们可以在此讨论新功能的优点和缺点，确定它的范围，它的API表面的形态，并就其实施达成共识。

参考链接：

新功能工作流程：
https://github.com/CommunityToolkit/Maui#submitting-a-new-feature
C#团队当前工作流程：
https://github.com/dotnet/csharplang#discussions
讨论：
https://github.com/CommunityToolkit/Maui/discussions

开启新功能提案

一旦某个新功能的实施在讨论中达成一致，就可以提交新功能提案了。

新功能提案是相当深入的，需要以下信息：

摘要
详细设计
使用句法（XAML的用法和C#的用法）
缺点
替代方案
未解决的问题

参考链接：

提交新功能提案：
https://github.com/CommunityToolkit/Maui/issues/new?assignees=&labels=new%2C+proposal&template=open-a-new-feature-proposal.md&title=%5BProposal%5D+

提案负责人

在出现一个新提案后， .NET MAUI Community Toolkit 团队的一名成员将被选为负责人，意味着该团队成员同意将其纳入.NET MAUI Community Toolkit，他们将在下一次 .NET MAUI Community Toolkit 月度讨论会上对该提议进行投票。

在每个月的第一个星期四下午12点，我们会在.NET基金会的YouTube频道上直播我们的会议，除此之外，我们会对新功能提案进行投票。如果某个提案得到核心团队50%以上的支持，它就被正式批准了。

参考链接：

.NET MAUI Community Toolkit 团队：
https://github.com/orgs/CommunityToolkit/teams/maui
.NET MAUI Community Toolkit阅读讨论会：
https://www.youtube.com/watch?v=0ZBh2Hl54ZY5

批准提案

一旦提案被批准，就终于到了开始写代码的时候了。

在该阶段，我们将把提案分配给任何愿意为之做出贡献的社区成员。

请在任何提案上留下评论，标记为需要帮助，我们会很高兴地把它分配给你。

我们要求每个Pull Request在合并前包括以下项目：

实施
iOS 支持
Android 支持
macOS 支持
Windows 支持
单元测试
示例
XML文档

参考链接：

需要帮助： https://github.com/CommunityToolkit/Maui/tree/main/src/CommunityToolkit.Maui.UnitTests
样本：
https://github.com/CommunityToolkit/Maui/tree/main/samples

批准Pull Request

在这一步，代码已经完成，包括单元测试、XML文档和 .NET MAUI Toolkit 示例应用中包含的内容。

现在唯一阻碍该Pull Request被合并的是Microsoft文档GitHub库中的官方文档的完成情况。由于官方文档在不同的仓库中，我们添加了待定文档标签，以确保我们一定会完成此文档。

我们要求Pull Request的作者也参与编写该功能的官方文档，因为你是最了解该功能的人。当然，如果你的英语不好，我们也很乐意帮你审阅编辑。

参考链接：