用途:该技能用于把 dev.nx.gradle.project-graph 插件升级到新版本。这是一项重复性任务,每次都以相同模式改动 5 个文件。
必要输入:开始前需从主分支收集三项值。NEW_VERSION 为要升级到的版本,可在 packages/gradle/project-graph/build.gradle.kts 的 version 字段找到旧版本,新版本为旧版本加一。NX_MIGRATION_VERSION 为触发版本升级迁移的 Nx 版本,可在 package.json 的 devDependencies 中查看 nx 版本,新版本为旧版本加一。MIGRATION_FOLDER 为 packages/gradle/src/migrations/ 下存放迁移文件的文件夹名,取版本号并把点替换为连字符、去掉 beta 或 rc 后缀。
主要步骤:一、更新 packages/gradle/src/utils/versions.ts 中的 gradleProjectGraphVersion 常量。二、更新 packages/gradle/project-graph/build.gradle.kts 第 13 行的 version。三、在 packages/gradle/src/migrations/MIGRATION_FOLDER/ 下创建 change-plugin-version-NEW_VERSION.ts 迁移文件,模板使用 @nx/devkit 的 Tree、readNxJson,以及 hasGradlePlugin、addNxProjectGraphPlugin、updateNxPluginVersionInCatalogsAst 等工具,先经 AST 更新版本目录再更新 build.gradle(.kts)。四、创建同名 .md 迁移文档,说明版本变更并给出前后示例。五、在 packages/gradle/migrations.json 的 generators 对象末尾新增条目,包含 version、description、implementation 与 documentation,路径带 dist 前缀。
验证与提交:运行 nx run-many -t test,build,lint -p gradle;提交信息采用 chore(gradle): bump gradle project graph plugin version to NEW_VERSION。最后对照最近一次 Gradle 版本升级 PR,改动文件数量应一致,否则应停止并索取更多信息。
限制:资料未提供该技能的具体安装方式、适用平台与收费信息。