助力 .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的作者也参与编写该功能的官方文档，因为你是最了解该功能的人。当然，如果你的英语不好，我们也很乐意帮你审阅编辑。 

参考链接：

• .NET MAUI Toolkit 示例应用：

  https://github.com/CommunityToolkit/Maui/tree/main/samples

• Microsoft文档GitHub库：

  https://github.com/MicrosoftDocs

• 待定文档标签：

  https://github.com/CommunityToolkit/Maui/issues?q=is%3Aissue+is%3Aopen+label%3A%22pending+documentation%22

批准文档 

文档完成后，将由.NET MAUI Community Toolkit团队的成员进行审查、批准和合并。

文档完成后，就可以合并该Pull Request了。

完成 

终于完成了，Pull Request已被合并，正式将你的代码添加到 .NET MAUI Community Toolkit中。

另外，我们还为大家准备了 .NET 6 和 Visual Studio 2022 的技术干货合集，全新的集成开发环境、多项改进以及配套资源上新，为开发者们带来生产力的提升和工作质量的改善。

扫码获取详情

获取11月资源