Android 命令行界面

android-cli
分类编程
作者Agentic Awesome Skills 社区
许可MIT
评分4.40/5
使用8.6K

Android CLI 专家

本技能提供了使用 android CLI 工具的指令。该工具包含多种命令，用于创建项目、运行应用程序、与设备交互以及管理 CLI 环境。

使用场景

  • 需要通过命令行创建、配置或分析 Android 项目时。
  • 需要与运行中的 Android 设备交互、部署应用或截屏时。
  • 需要管理 Android SDK 组件、版本或虚拟设备（模拟器）时。
  • 需要检查 UI 布局或运行 XML 指定的 Journey 测试时。

安装

如果 android 工具不在路径中，请将平台安装程序下载到私有临时目录并进行检查，仅在用户确认来源和内容后运行：

bash
tmpdir="$(mktemp -d "${TMPDIR:-/tmp}/android-cli.XXXXXX")" || exit 1
curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh -o "$tmpdir/install.sh"
sed -n '1,160p' "$tmpdir/install.sh"

在审查并获得用户明确确认后：

bash "$tmpdir/install.sh"

macOS 或 Windows 请使用对应的 darwin_arm64/install.sh 或 windows_x86_64/install.cmd URL。不要将可变的网络安装脚本直接通过管道传输到 shell 中。

SDK 管理

使用 sdk 命令管理 Android SDK 和工具的安装。例如：

  • android sdk install <package>[@<version>]...: 安装指定包。可以指定多个包，用空格分隔。<version> 默认为最新版本。例如：android sdk install platforms/android-30@2 platforms/android-34
  • android sdk update [<pkg-name>]: 将特定包或所有包更新至最新版本。
  • android sdk remove <pkg-name>: 从本地 SDK 中移除某个包。
  • android sdk list --all: 列出已安装和可用的 SDK 包。

项目创建

使用 create 命令通过模板创建项目。

例如：

bash
android create empty-activity --name="My App" --output=./my-app

与设备交互

有关与运行中设备交互的更多信息，请参阅 此处。

运行 Journey 测试

有关运行 Journey 测试的更多信息，请参阅 此处。

文档搜索

docs 命令可在 Android 知识库中搜索权威、高质量的 Android 开发者文档。
通过提供几个关键词，该工具将返回包含 Android API 或库的使用示例或指南的高质量文章。
使用此工具获取关于如何完成 Android 特定任务的额外信息，或深入了解 Android API、界面、库或设备。

请始终使用此工具以获取关于 Android 概念的最新信息。典型的适用场景包括：
- 查找 API 迁移指南。
- 查找 API 示例。

  • 查找最新的 Android API 信息。

- 查找 Android 概念的最佳实践。

运行 APK

使用 run 命令运行 Android 应用。

管理模拟器

使用 android emulator 命令管理 Android 虚拟设备 (AVD)。

截屏

使用 android screen capture -o <文件路径> 命令截取已连接 Android 设备的当前屏幕图像并输出到文件。

管理技能 (Skills)

使用 android skills 命令管理 Android 的 antigravity agent 技能。

检查 UI 布局

使用 android layout 命令检查 Android 应用程序的 UI 布局。该命令以 JSON 格式返回应用程序的布局树。在调试 UI 错误时，这种方法通常比截屏快得多。

更新 CLI

使用 android update 命令更新 Android CLI。

限制条件

  • 必须安装 android CLI 并将其添加到 PATH 中；否则请先安装或参考上文的平台特定设置指南。
  • 设备、模拟器、SDK 和文档相关命令可能依赖于本地 Android SDK 状态、网络访问以及连接的硬件。
  • 生成的命令对环境敏感：在运行之前，请检查路径、包名、设备序列号以及安装/更新目标。

Android 帮助输出

text
Usage: android [-hV] [--sdk=PARAM] [COMMAND]
  -h, --help        显示此帮助信息并退出。
      --sdk=PARAM   Android SDK 的路径
  -V, --version     打印版本信息并退出。
Commands:
  create    创建新的 Android 项目
  describe  分析 Android 项目以生成描述性元数据。
  docs      Android 文档命令
  emulator  模拟器命令
  help      显示所有命令的帮助
  info      打印环境信息（SDK 位置等）
  init      初始化 Android CLI 的环境（例如技能）
  layout    返回应用程序的布局树
  run       部署 Android 应用程序
  screen    查看设备的命令
  sdk       下载并列出 SDK 包
  skills    管理技能
  update    更新 Android CLI

create
          Usage: android create [-h] [--verbose] [--list] [--minSdk=api]
                                --name=applicationName [-o=dest-path] [template-name]
          创建新的 Android 项目
                [template-name]      模板名称
            -h, --help               显示此帮助信息并退出。
                --minSdk=api         应用程序支持的 'minSdk'（默认值在模板中定义）
                --name=applicationName
                                      应用程序名称（例如 'My Application'）
            -o, --output=dest-path   目标项目目录路径（默认为 '.'）
                --verbose            启用详细输出
                --list               列出所有可用模板


describe
          Usage: android describe [-hV] [--project_dir=PARAM]
          分析 Android 项目以生成描述性元数据。
          此命令识别并输出 JSON 文件的路径，其中详细记录了项目的结构，
          包括构建目标及其对应的输出产物位置（例如 APK）。这些信息
          使其他工具和命令能够高效地定位构建产物。

-h, --help 显示此帮助信息并退出。
--project_dir=PARAM 要描述的项目目录
-V, --version 打印版本信息并退出。

docs
用法: android docs [-h] [COMMAND]
Android 文档命令
-h, --help 显示此帮助信息并退出。
命令:
search 搜索 Android 文档
fetch 获取 Android 文档

emulator
用法: android emulator [-h] [COMMAND]
模拟器命令
-h, --help 显示此帮助信息并退出。
命令:
create 创建虚拟设备
start 启动指定的虚拟设备。当模拟器完全启动并准备就绪时，此命令将返回。
stop 停止指定的虚拟设备
list 列出可用的虚拟设备
remove 删除虚拟设备

help
用法: android help [COMMAND]
显示所有命令的帮助
[COMMAND] 要显示帮助的命令

info
用法: android info <field>
打印环境信息（SDK 位置等）
<field> 要打印值的具体字段。如果省略，则打印所有内容。

init
用法: android init
初始化 Android CLI 的环境（例如 skills）。

layout
用法: android layout [-dhp] [--device=PARAM] [-o=PARAM]
返回应用程序的布局树
-d, --diff 返回自上次调用 ui-dump 以来发生变化的布局元素扁平列表
--device=PARAM 设备序列号
-h, --help 显示此帮助信息并退出。
-o, --output=PARAM 将布局树写入指定文件或目录。如果省略，则将树打印到标准输出
-p, --pretty 美化打印返回的 JSON

run
用法: android run [-h] [--debug] [--activity=PARAM] [--device=PARAM]
[--type=PARAM] [--apks=PARAM[,PARAM...]]...
部署 Android 应用程序
--activity=PARAM Activity 名称
--apks=PARAM[,PARAM...]
APK 的路径
--debug 以调试模式运行
--device=PARAM 设备序列号
-h, --help 显示此帮助信息并退出。
--type=PARAM 组件类型（ACTIVITY, SERVICE 等）

screen
用法: android screen [-h] [COMMAND]
查看设备的命令
-h, --help 显示此帮助信息并退出。
命令:
capture 将设备屏幕输出为 PNG
resolve 可视化定位 UI 元素

sdk
用法: android sdk [COMMAND]
下载并列出 SDK 包
命令:
install 安装 SDK 包
update 将一个或所有包更新到最新版本
remove 从 SDK 中移除包
list 列出已安装和可用的 SDK 包

skills
用法: android skills [COMMAND]
管理 skills
命令:
add 安装一个 skill
remove 删除技能
list 列出可用技能
find 通过关键词查找技能

update
用法: android update [--url=PARAM]
更新 Android CLI
--url=PARAM 下载更新的 URL 地址
```