SuperAPI AI 工具集

maui-release-notes

编程与开发

查看项目

更新于 10-16 06:55

技能介绍

用途

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 确认。

推荐工作流:

  1. 建立应用当前基线:目标框架、工作负载、包、CI 镜像/工具链和支持的平台。
  2. 阅读目标版本的官方 .NET 和 MAUI 发布说明。
  3. 只提取与应用构建者相关的变化:环境要求、面向应用的破坏性变更、工具链变动和已知问题。
  4. 当团队需要精确升级命令或权威工作负载依赖要求时,使用 dotnet-workload-info。
  5. 将发布内容转化为应用特定的行动、风险和测试,而不是复述框架内部细节。

建议的输出结构:

# 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 指导与目标版本一致;已知问题、缓解措施和验证步骤应足够具体,可用于真实应用推广。