Google Mobile Ads Next-Gen 迁移助手
指导 Android 应用从旧版 GMA SDK 迁移到 Next-Gen SDK。
内容未显示恶意行为、凭证窃取或隐蔽外泄；迁移范围基本限定于 Android 广告 SDK，并提醒保留应用 ID 元数据。但它要求通过 curl 获取未固定的 latest 依赖版本、全局排除旧依赖，未要求用户确认、未说明数据流或提供回滚方案，因此扣分。
工作流包含 Gradle 配置、逐文件迁移和构建检查，主路径较清楚。但初始化回调类型在映射表与方法签名之间存在不一致，依赖版本未固定，使用 gradle build -x test 排除了测试，也缺少异常输入、失败诊断和恢复指导，因此不超过静态评估上限并扣分。
目标用户和迁移场景明确，API 与方法映射覆盖面较广。但输入前置条件、非适用范围、触发边界和不同项目配置的处理不足；未提供中文支持说明，且关键版本获取依赖外部 Maven 服务，环境适配证据有限，因此扣分。
技能具有清晰的元数据版本、分层标题、检查清单、映射表，并可由仓库 README、Apache-2.0 许可证和官方组织来源提供基本治理线索。但缺少具体示例、FAQ、已知限制、变更记录和明确维护责任/更新路径，因此扣分。
映射表和关键迁移规则可直接帮助完成部分 API 重构，核心任务价值明确。但没有完整端到端示例、可直接应用的补丁或验证过的代表性输出，且构建命令跳过测试，用户仍需较多人工核对，因此按静态上限保守扣分。
文件本身包含可审计的迁移规则、签名和映射材料，仓库还提供版本与许可证信息。但未提供引用、提交测试、覆盖关键路径的 CI 或第三方执行证据，结论主要依赖单一文档来源，因此扣分。
- 不要未经确认直接使用 curl 获取未固定的 latest SDK 版本；应记录并审查具体版本。
- 全局排除旧版 play-services-ads 依赖可能影响其他模块或中介适配器，执行前应检查依赖图并保留可回滚变更。
- 初始化回调类型存在文档不一致，需依据实际 SDK 官方 API 和编译结果核对。
- 建议补充不跳过测试的验证、失败诊断、完整示例及中文环境说明。
这个 Skill 能做什么，适合哪些场景？
该技能面向将 Android 应用从旧版 Google Mobile Ads SDK 迁移到 GMA Next-Gen SDK 的开发者。它提供 Gradle 配置检查、逐文件迁移步骤，以及涵盖导入、类和方法签名的映射表。内容覆盖初始化、横幅、原生、插屏、激励广告、预加载、响应信息和 Ad Manager 相关迁移。它还强调应用 ID、初始化顺序和回调中的 UI 线程要求。
检查并指导将 play-services-ads 替换为 ads-mobile-sdk，更新 minSdk 与 compileSdk，并排除旧版广告依赖；指导根据映射表修改导入、类名和方法签名；要求使用 AndroidManifest.xml 中的 APPLICATION_ID 初始化 GMA SDK；说明横幅、原生、插屏、激励广告、预加载和响应信息的 API 替换；建议运行 gradle build -x test 验证构建。
- 负责维护旧版 Google Mobile Ads SDK Android 应用的开发者，需要规划完整迁移步骤。
- 正在升级广告 SDK、同时需要核对导入和方法签名变化的 Android 工程师。
- 使用横幅、原生、插屏、激励或预加载广告，并需要逐格式迁移参考的团队。
- 遇到初始化顺序、回调线程、应用 ID或旧版依赖冲突问题的开发者。
这个 Skill 有哪些优点和局限？
- 提供覆盖导入、类和方法签名的详细迁移映射表。
- 明确列出 Gradle、初始化、线程和依赖排除要求。
- 覆盖多种广告格式、预加载和响应信息。
- Apache-2.0 许可，仓库处于积极开发状态。
- 内容是迁移指导和映射资料，不是自动化迁移脚本。
- 源材料未提供测试套件、示例项目或平台兼容性验证结果。
- 部分步骤要求访问 Maven，并依赖现有 Android/Gradle 工程环境。
- 回调在后台线程执行，UI 操作必须由使用者自行切换到 UI 线程。
如何安装这个 Skill？
安装整个仓库中的技能集合：npx skills add google/skills。安装过程中选择目标技能。仓库包含约 90 个技能；本条目对应 skills/ads/google-mobile-ads-android-migrate-to-next-gen/SKILL.md。README 未说明其他客户端的专用安装步骤。
如何使用这个 Skill？
在已安装该技能的 Agent Skills 客户端中，提供一个需要迁移的 Android GMA 项目，并请求其将旧版 com.google.android.gms:play-services-ads 迁移到 com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk。例如：“请按 Google Mobile Ads Next-Gen 迁移清单检查并迁移这个 Android 项目。”随后根据建议修改 Gradle、AndroidManifest.xml 和源代码，并运行 gradle build -x test。源文件未规定客户端专用触发语法。
这个 Skill 与同类方案有什么区别？
相较于继续使用旧版 Google Mobile Ads SDK 或手工逐项查找差异，该技能直接对照旧版与 GMA Next-Gen SDK 的 API、回调和配置映射；它不提供其他广告 SDK 的迁移方案。