Android CLI 版本说明

Android CLI 是通过终端进行 Android 开发的主要界面,旨在让您能够使用自己选择的智能体和工具来赋能开发工作流。

本页面列出了每个 Android CLI 版本中的新功能。如需下载 Android CLI,请前往下载页面。如需了解详情,请参阅 Android CLI 概览。

版本 1.1.16919734(2026 年 11 月)

  • 增量安装会重复使用重新定位的文件:android install 和 android run 不再重新发送在 APK 中位置发生变化的未更改文件。如需停用,请传递 --use-delta-install-instructions=COPY,DATA。
  • Compose 跟踪:android profiler systemtrace 可以记录 Jetpack Compose 在应用中的操作。传递 --enable=compose.composition 可为运行的每个可组合函数记录一个切片,传递 --enable=compose.recomposition 还可记录导致重组的状态读取和写入。该应用需要 androidx.compose.runtime:runtime-tracing 1.13 或更高版本。跟踪记录会保存为 ZIP 归档文件,您可以在 Android Studio 性能分析器中打开该文件。
  • Perfetto 堆转储:将 --type=perfetto 传递给 android profiler heapdump capture,以将堆转储记录为 Perfetto 跟踪记录。它包含对象以及对象之间的引用,但不包含对象的值,因此比 .hprof 文件小。它需要 Android 12(API 级别 31)或更高版本,以及可分析或可调试的应用。
  • 分析 JSON 中的库 DEX 大小格式:在库工件(AAR 和 JAR)的 android analyze --format=json 输出中,d8CompileResult 和 r8CompileResult 中的 dexSizeBytes 字段现在是序列化为字符串(而非数字)的 64 位整数。
  • 以 JSON 格式输入结果:android input 子命令在标准输出中以 JSON 对象的形式输出结果,其中包含 results 列表,每个子命令的格式相同。没有匹配元素或多个匹配等失败情况会在每个结果的 status 字段中报告,而不是作为标准错误中的文本报告。
  • 模拟器退出代码:android emulator create、start、stop 和 remove 现在会在失败时退出并返回非零代码,并将错误输出到标准错误。

版本 1.1.16717390(2026 年 10 月)

  • 现场崩溃信号:使用新的 android signals 命令,通过 Firebase Crashlytics 调查应用在现场的行为。使用 android auth login 登录后,使用 android signals context 查找您的项目和应用,然后使用 android signals crashes list、facets、describe 和 samples 列出、过滤和细分崩溃、ANR 和非严重问题。
  • 现场堆转储:使用 android signals heaps 列出、描述和下载 Crashlytics 在发生内存不足崩溃和内存限制器终止事件时收集的堆转储,以及生成这些堆转储的会话的元数据、自定义键和日志。
  • 应用性能分析:使用新的 android profiler 命令,在已连接的设备或模拟器上通过 android profiler systemtrace 记录系统跟踪,并通过 android profiler heapdump capture 捕获 JVM 堆转储。使用 android profiler session list、status 和 terminate 管理性能分析会话。
  • 制品分析:使用新的 android analyze 命令检查一个或多个 APK、AAB、AAR 和 JAR,并报告其软件包详细信息、DEX 大小、R8 缩减和优化指标,以及有关库保留规则和低优化的警告。传递 --format=json 或 --format=textproto 以获得机器可读的输出。
  • Compose 预览:使用新的 android preview list 命令在目标中查找 Jetpack Compose @Preview 函数,并使用 android preview render --fqn <name> 将其渲染为 PNG 图片和组件树 JSON 文件,而无需使用 Android Studio。传递 --output 以选择文件的写入位置。
  • 运行和安装中的 build 引用:android run 和 android install 接受位置 build 引用,以构建和部署特定目标。没有变体的 Gradle 目标(例如 :app)现在默认使用 debug 变体。
  • 设备镜像窗口:使用新的 android device hub 命令打开桌面窗口,以便实时镜像屏幕并以交互方式控制已连接的实体 Android 设备(包括通过 android device remote connect 连接的远程设备)和 Android 模拟器。

版本 1.0.16625370(2026 年 10 月)

  • 界面互动:使用新的 android input 命令在已连接的设备或模拟器上点按、滚动、滑动、输入文本和按键。使用 text=Submit 或 id=email,class=EditText 等选择器定位界面元素,并将其与 android layout 结合使用,以查找要与之互动的元素。

版本 1.0.16500706(2026 年 10 月)

  • 预留时连接:android device remote create 现在会自动将新预留连接到 adb。传递 --connect=false 以仅创建预留,并在稍后使用 android device remote connect 进行连接。

版本 1.0.16457483(2026 年 9 月)

  • 登录 Google 服务:使用 android auth login 登录 Android CLI,以便它可以调用需要身份验证的 Google 服务。
  • 远程设备目录:使用 android device remote projects 查找可从中流式传输设备的 Google Cloud 项目,并使用 android device remote models 浏览可用的实体设备。
  • 远程设备预留:使用 android device remote create 预留远程实体设备,然后使用 list、extend --duration <minutes> 和 remove 管理预留。
  • 连接到远程设备:使用 android device remote connect 通过后台连接将预留设备连接到 adb,使其能够像本地设备一样与 android run、android install 和其他设备命令搭配使用。使用 android device remote disconnect 将其分离。

版本 1.0.16406183(2026 年 9 月)

  • 启动速度更快:Android CLI 的启动速度大约是原来的两倍,因为原生下载器库仅在使用时加载,并且不再在每次调用时解压缩到临时目录。
  • 修复了退出代码:命令现在会在失败时返回非零退出代码,包括 create、run、install、describe、layout、docs、info、skills 和 update,这使得脚本编写和 CI 更加可靠。
  • 屏幕注释调优:android screen --annotate 公开了其特征检测的调优参数,包括边缘检测阈值、形状过滤和聚类策略,如 --help 中所述。
  • 项目创建选项:android create 支持 --application-id 和 --namespace 标志以及带连字符的选项名称,例如 --min-sdk。Compose 模板现在使用 src/main/kotlin 源代码集和 Material 3 主题。
  • 无头模拟器:使用 android emulator start --headless 启动没有窗口的模拟器。
  • SDK 可靠性:android sdk 命令会采用进程间锁,以便并发调用不会发生冲突,验证已安装软件包的路径和版本,仅在需要时更新旧版 XML 文件,并报告更清晰的错误。
  • Compose 预览输出:android studio render-compose-preview 会输出渲染图片的绝对路径,并确认写入操作,即使使用了 --print-semantics 也是如此。
  • 支持较低的 API 级别:修复了在搭载 API 级别 32 及更低版本的设备上发生的设备交互失败问题,例如 android layout。

版本 1.0.16261425(2026 年 9 月)

  • 布局修复:修复了布局命令在某些情况下不起作用的问题。如需暂时还原为旧版布局行为,请export ANDROID_CLI_LAYOUT_V1=1。

版本 1.0.16251017(2026 年 9 月)

  • 布局转储:android layout 现在支持 --no-idle 标志,无需等待空闲状态即可提取布局。android layout 还支持 --full 标志,以返回整个布局树而不进行过滤;默认情况下,layout 仅返回互动元素。
  • Shell 补全:使用新的 android completion 命令为 Bash 和 Zsh 生成并安装 shell 自动补全脚本。
  • 更新技能:使用新的 android skills update 命令让技能保持最新状态,并在一次调用中安装或移除多项技能(例如 android skills install <skill1> <skill2>)。
  • 按智能体列出技能:android skills list 现在默认显示详细信息,包括技能说明和安装了该技能的智能体。android skills list 还支持 --agent <agent> 标志,用于列出为代理安装的所有技能。
  • 增量安装性能:使用零复制内核系统调用,加快了 android install 中的增量 APK 修补速度。
  • 屏幕边缘检测:使用 Canny 边缘检测算法改进了 android screen 中的特征和边缘检测。

版本 1.0.15985488(2026 年 7 月)

  • 专用安装命令:使用独立的 android install 命令安装 APK,该命令具有增量 APK 推送功能,使增量安装速度比 adb 快几个数量级。
  • 运行增量安装:同样,在 android run 中使用新的 --use-delta-install 标志,以便更快地将增量 APK 部署到设备。
  • 跨平台 SDK 管理器:在 android sdk 命令(install、update、materialize)中使用新的 --platform <os_arch> 标志,以针对非主机平台检查、解析和安装跨操作系统和 CPU 架构的组件。
  • 技能 CLI 增强功能:扩展了 android skills 子命令(add、remove、list、find),增加了 --help 文档、技能缺失时的清晰反馈,以及具有自动回滚功能的更安全的原子下载暂存。

版本 1.0.15857036(2026 年 7 月)

  • 更广泛的智能体技能支持:使用 android skills install 在数十个智能体环境(包括 Claude Code、Cursor、Cline、OpenHands、Windsurf、Zed 和 Devin)中安装技能。
  • 支持代理的原生下载器:使用原生 HTTP 下载器可靠地下载网络资源,该下载器开箱即用,支持企业代理。
  • SDK 软件包管理:在 android sdk remove 中通过多软件包移除功能管理 SDK 软件包,并在 android sdk resolve 中通过基于 SHA 的解析功能管理 SDK 软件包。
  • 描述和屏幕改进:直接在 android describe 的标准输出中查看 Gradle 构建错误,并使用 android screen 中的 --device 标志定位特定设备。
  • CLI 易用性和 Error Reporting:输入未知命令或无效的项目创建目标时,会显示更清晰的出错提示,android emulator 命令不区分大小写。

版本 1.0.15498356(2026 年 5 月)

  • 动态 SDK 模板加载:android create 的项目模板现在从 Android SDK 软件包动态下载,而不是捆绑在 CLI 二进制文件中,从而确保新项目始终使用最新模板。
  • SDK 许可兼容性:android sdk 保存的已接受 SDK 许可现在与旧版 Android SDK 工具和 Gradle 插件预期的文件格式相匹配。
  • 符号链接支持:添加了对跨 CLI 命令和文件操作的符号链接的支持。
  • 原子二进制文件提取:在并发多进程 CLI 调用期间,通过将二进制文件解压缩到临时目录,然后以原子方式将其移动到目标位置,防止提取竞态条件。
  • Windows 稳定性:改进了 Windows 11 上的 Windows 兼容性和性能,并修复了主目录路径解析问题。

版本 1.0.15433482(2026 年 5 月)

  • Antigravity 集成:Android CLI 和技能现已正式集成到 Google Antigravity 2.0 中,作为可选的资源包,可简化智能体开发。
  • Android Studio 命令:使用新的 android studio 命令,让您的智能体能够利用 Android Studio 的深度上下文功能,包括代码分析、语义查找和 Compose 渲染。
  • 支持历程:使用历程验证关键用户体验,历程是对用户体验流程的自然语言描述,您的代理可以从终端或在 CI/CD 中运行这些流程。
  • 全新 Android 技能:访问全新 Android 技能库,包括 CameraX 迁移、自适应界面、AppFunctions 和 Compose 样式等技能。
  • 更多安装选项:使用 apt-get、winget 和 homebrew 等常用软件包管理器安装和更新 Android CLI。如需了解详情,请参阅下载选项。

版本 0.7(2026 年 4 月)

首次发布!