友盟 Android 统计 SDK 集成助手

要解决什么问题

友盟统计 SDK 的 Android 集成并不只是加一条依赖：还要配 Maven 仓库、Manifest 权限、ProGuard 规则，并在 Application 里按 appkey 与 channel 初始化。多模块工程还要选对 app 模块；Kotlin DSL、Version Catalogs 与传统 Groovy 写法也不一致。手工改 Gradle 和 Manifest 时，漏一步往往要到真机或模拟器上靠 logcat 才发现没上报。

技能如何工作

本技能把集成收成一条可重复流程：

1. 环境与项目检查 — 检测 JDK 17+、ANDROID_HOME/ANDROID_SDK_ROOT 等；确认目标工程能编译。
2. 参数采集 — 交互式或非交互式收集 appkey、channel，也支持占位符先打通工程。
3. 自动改工程 — 写入仓库与依赖（优先 Version Catalogs）、权限、混淆规则；创建或追加现有 Application 的初始化代码，并注册 Manifest。
4. 验证与回滚 — 集成后编译；可选通过 adb logcat 看上报日志；失败可用备份目录脚本恢复。

多模块场景用 --app-module 指定模块名即可。

适用边界与注意

• 集成前项目必须已能成功编译；SDK 不能替你在 Android Studio 里修编译错误。
• logcat 验证需要 adb 与设备/模拟器；只做集成、不做运行时验证时可以没有。
• 占位符模式适合先验流程，上线前务必在友盟后台拿到真实 appkey 并替换 YOUR_UMENG_APPKEY 等常量。
• 官方行为与版本以友盟文档为准；本技能是对常见 Gradle/Kotlin 项目的自动化封装，不是友盟官方安装包。