用途
MAUI Release Notes 技能适用于应用团队需要回答“这个 .NET 或 MAUI 版本对我们的应用意味着什么”的场景。它的关注点是应用开发者的采纳指导,而非发布 MAUI SDK 本身。适用对象为仓库负责人、应用开发者、QA 和 CI 负责人。
主要能力
从发布说明中提取以下与应用相关的内容:
- 影响应用代码、项目文件或部署的破坏性变更或弃用项。
- 必需的环境更新,例如 Xcode、JDK、Android SDK、Visual Studio 或会影响应用构建与发布的工作负载集变更。
- 应用仓库需要的 MAUI 包、工作负载或 CI 更新。
- 可能阻碍升级的已知问题、回归或不受支持的组合。
- 应用团队在升级后应规划的验证工作。
- 如果新版本引入应用特定风险时的回滚考虑。
当需要精确的工作负载或环境依赖数据时,可使用 dotnet-workload-info 确认。版本发现用于支持应用升级规划,除非用户明确要求,否则不输出仅维护者需要的清单数据。
使用方式
典型输入包括:
- 应用当前的 .NET 版本、工作负载集和 MAUI 包基线。
- 团队正在考虑的目标发布版本。
- 涉及范围平台:Android、iOS、Mac Catalyst、macOS、Windows。
- 输出形式:简短摘要、升级清单还是推广指导。
如果缺少精确的工作负载、包、Xcode、JDK 或 Android SDK 版本数据,使用 dotnet-workload-info 确认。
推荐工作流:
- 建立应用当前基线:目标框架、工作负载、包、CI 镜像/工具链和支持的平台。
- 阅读目标版本的官方 .NET 和 MAUI 发布说明。
- 只提取与应用构建者相关的变化:环境要求、面向应用的破坏性变更、工具链变动和已知问题。
- 当团队需要精确升级命令或权威工作负载依赖要求时,使用 dotnet-workload-info。
- 将发布内容转化为应用特定的行动、风险和测试,而不是复述框架内部细节。
建议的输出结构:
# Upgrade notes for <app/team> adopting .NET MAUI <version>
## Should we upgrade now?
- Recommendation
- Main benefits
- Main risks or blockers
## What changes for our app?
- Breaking or behavior changes that touch app code, project files, CI, or dependencies
## Required environment updates
- Xcode / JDK / Android SDK / workloads / IDE requirements
## Repo and CI changes
- global.json, workload install/update, package pinning, CI image/tooling updates
## Validation checklist
- Clean restore/build
- Device or simulator smoke tests
- Critical app flows such as auth, notifications, payments, deep links, or media
- Archive, signing, and store submission checks if relevant
## Known issues and mitigations
## Rollback plan
仅当用户明确要求该详细程度时,才包含清单或包版本表。
适用场景
- 应用团队评估是否升级到某个 .NET 或 MAUI 版本。
- 将发布说明转化为具体升级清单、风险与验证计划。
- 梳理跨平台(Android、iOS、Mac Catalyst、macOS、Windows)的环境前提。
- 为 CI 和仓库变更提供升级指导。
限制
- 不面向 MAUI 工作负载维护者视角撰写。
- 除非用户要求,不默认输出清单表、包内部信息或仓库发布说明。
- 将 App Store 或 Play Store 营销说明与框架升级说明分开。
- 在平台和工具链前提未确认前,不建议升级。
- 优先使用官方发布说明和链接问题,而非记忆或猜测。
- 输出面向应用构建者、QA 和 CI 负责人;应用侧变更与框架内部细节分开标注;环境前提与应用的发布平台匹配;升级命令和 CI 指导与目标版本一致;已知问题、缓解措施和验证步骤应足够具体,可用于真实应用推广。