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-tracing1.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 sessionlist、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 月)
首次发布!