Android CLI 与技能实战：用智能体把 Android 构建速度提上来

1. 构建慢这件事到底卡在哪Android 项目构建慢多数时候不是 Gradle 本身的问题而是整条链路里塞了太多手工动作SDK 组件版本对不上、模拟器要手动开、APK 构建完还得自己 adb install、装完还要点开界面确认。一个改动从保存到看见效果中间夹着五六个终端窗口来回切时间全耗在等待和找命令上。Android CLI 就是冲着这个场景来的。它把环境设置、项目创建、设备管理、APK 部署、界面布局抓取这些动作收进一套android命令里让脚本或者智能体可以直接调用不用再靠人肉记参数。配合 Android 技能skills和知识库docs智能体在编排构建流程时能拿到官方推荐的做法而不是凭训练数据里的老模式瞎猜。这篇面向的是已经在用 Android Studio 或命令行构建、但觉得每次验证一轮太慢的开发者。我会给出一套可复制的 CLI 配置骨架讲清怎么让智能体参与构建编排以及怎么用构建耗时对比来验证提速效果。最后说明如何通过 TaoToken 统一 Key 和 API 通道把智能体工具链接进来省去每个工具单独配 Key 的麻烦。2. 前置准备装好 Android CLI 并让智能体认识它Android CLI 是整套流程的入口。先确认本机有没有装which android || command -v android返回路径说明已安装。没装的话去官方渠道下载装完先更新到最新版本避免用到旧命令集android update装好之后关键一步是让智能体知道有这个工具。运行 init 会安装android-cli技能到检测到的智能体技能目录android init这一步的意义在于智能体后续在编排构建任务时会优先调用android命令而不是自己拼 adb 和 gradle 参数。我试过在没跑 init 的情况下让智能体部署 APK它会绕一圈去调 adb install路径和参数都容易出错。接着把 Android 技能装上。技能是模块化的 Markdown 指令集覆盖 Navigation 3 迁移、edge-to-edge、AGP 9、R8 配置分析等常见工作流。一次性装全部android skills add --all如果只想装某个技能比如性能相关的android skills find performance android skills add --skillskill-name注意一点如果你自己改过某个技能文件更新前先重命名否则skills add会直接覆盖你的改动。知识库通过 docs 命令访问两步走——先搜再取android docs search How do I improve my app performance? android docs fetch kb://android/topic/performance/overview搜索结果里的kb://开头的地址就是给 fetch 用的。这样智能体拿到的指南是当前官方文档不受模型训练截止时间限制。3. 可复制的 CLI 配置骨架3.1 用 .androidrc 固定常用参数每次敲命令都带--sdk很烦。在用户目录建一个.androidrc把要自动应用的标志写进去每行一个macOS / Linux 路径~/.androidrcWindows 路径%USERPROFILE%\.androidrc内容示例--sdk/Users/yourname/Library/Android/sdk这样每次调用android都会默认用这个 SDK。想临时换一个命令行里显式传--sdk覆盖即可。查看当前默认 SDKandroid info3.2 项目描述与产物定位构建提速的前提是让智能体知道产物在哪。describe会分析项目结构输出 JSON 元数据里面包含 build 目标和对应产物路径android describe --project_dir/path/to/your/project拿到产物路径后部署就不用猜 APK 位置了。部署命令android run --apksapp/build/outputs/apk/debug/app-debug.apk多设备时指定序列号android run --apksapp-debug.apk --deviceemulator-55543.3 设备生命周期交给 CLI模拟器创建、启动、停止都能脚本化android emulator create --profilemedium_phone android emulator list android emulator start medium_phone android emulator stop emulator-5554emulator create --list-profiles可以看有哪些设备配置可选。这样智能体在跑构建验证时可以自己拉起设备、装包、抓布局全程不用人插手。3.4 界面验证layout 与 screen装完应用要确认界面对不对layout直接返回 JSON 格式的界面树android layout --output./hierarchy.json android layout --diff--diff只返回自上次快照以来变化的元素做回归对比时很有用。截图加坐标解析android screen capture --outputui.png --annotate android screen resolve --screenshotui.png --stringinput tap #5--annotate会在界面元素上画带标签的边界框resolve把标签#5换成实际坐标脚本点击就不用硬编码位置了。3.5 接入 TaoToken 统一 Key 通道智能体工具链里往往有好几个需要模型能力的环节——代码补全、构建日志分析、报错归因。每个工具单独配 Key 很乱。TaoToken 提供统一的 API 通道把 Key 集中管理。API 地址https://taotoken.net/api在工具的环境变量或配置里指向这个地址Key 从控制台生成。生成入口在 API Keys 页面接入细节看文档。这样智能体在分析构建日志、生成修复建议时走的是同一条通道换工具不用重新配。4. 验证请求与构建耗时对比4.1 先验证 CLI 链路通不通跑一遍完整链路确认每一步都有输出android info android describe --project_dir. android emulator listinfo返回 SDK 路径describe返回 JSON 文件路径emulator list列出可用设备。三个都有正常输出说明 CLI 和智能体的接口是通的。4.2 构建耗时对比方法提速效果要用数据说话。建议固定同一个项目、同一台机器、同一个模拟器配置对比两组流程。第一组传统手工流程。记录从改代码到在设备上看到界面的总时间中间包含手动 gradle 构建、手动 adb install、手动点开应用。第二组CLI 编排流程。用脚本或智能体串起来./gradlew assembleDebug android run --apksapp/build/outputs/apk/debug/app-debug.apk android layout --output./after.json每组跑三到五次取平均排除首次构建的缓存冷启动影响。重点看两个指标单轮验证总耗时以及一轮里人工干预的次数。CLI 流程的价值不只是快还在于智能体可以连续跑多轮不用人盯着。4.3 用 studio 命令做深度检查如果项目在 Android Studio 里开着studio系列命令能让智能体直接查符号、看用法、渲染 Compose 预览。先确认连接状态android studio check输出会列出运行中的实例 PID 和打开的项目。然后可以查符号声明android studio find-declaration --short HotelDetailScreen android studio find-usages --short HotelDetailScreen渲染 Compose 预览并输出语义树android studio render-compose-preview \ --output-image-filepreview_hotel.png \ --print-semantics \ app/src/main/java/com/example/myapp/ui/DetailScreen.kt \ HotelDetailScreenPreview查依赖版本android studio version-lookup androidx.compose.ui:ui com.android.application agp kotlin这些命令让智能体在构建之外还能做静态分析和视觉验证减少来回切 IDE 的次数。5. 本篇常见错排查android命令找不到。先跑which android确认是否在 PATH 里。没装的话先下载安装装完android update。Windows PowerShell 目前不支持直接下载 Android CLI需要换方式获取。android emulator在 Windows 上不可用。这是已知问题Windows 平台的 emulator 命令目前停用。可以改用 Android Studio 的 Device Manager 管理设备或者在其他平台跑模拟器。skills add覆盖了自定义技能。如果你改过技能文件更新前先重命名。skills add会把已安装技能更新到最新版同名文件会被覆盖。run命令报找不到 APK。--apks的路径是相对于当前文件系统位置的不是相对于项目根目录。先android describe拿到产物路径再传绝对路径或正确的相对路径。studio命令连不上。需要 Android Studio Quail 2 Canary 1 或更高版本且项目已打开、Gemini 已启用并登录。先跑android studio check看连接状态多个实例时用--pid指定。layout返回空或报错。确认设备已连接且应用在前台。layout需要有效运行的应用通过实体设备或模拟器连接。先android emulator list确认设备在再android run把应用装上去。docs fetch的 kb 地址无效。kb://地址必须从docs search的结果里拿不能自己拼。先搜再取两步不能省。6. 把智能体接进构建流程的下一步CLI 骨架搭好之后智能体参与构建编排的入口就清晰了用android create起项目android sdk install按需装组件android emulator管设备android run部署android layout和screen做界面验证。每一步都有确定的命令和输出智能体可以据此判断下一步动作。模型能力这块通过 TaoToken 统一通道接入Key 在控制台生成API 地址指向 https://taotoken.net/api。需要跑模型对话验证构建日志分析效果走模型对话入口长期做编码和 Agent 编排看 Coding Plan接入细节查文档。构建提速不是靠某个单点优化而是把等待和手工动作从链路里挤出去。CLI 让动作可脚本化技能和知识库让智能体的决策有官方依据统一 Key 通道让工具链不用反复配。三者叠起来一轮验证的时间才能真正降下来。