android run

在已连接的设备或模拟器上构建、部署和启动 Android 应用。

用法

android run [-h] [--activity=PARAM] [--apks=PARAM] [--debug] [--device=PARAM] [--install-options=PARAM] [--type=PARAM] [--use-delta-install]

选项

  • --activity=PARAM - 活动名称。
  • --apks=PARAM - 以英文逗号分隔的 APK 路径。
  • --debug - 在调试模式下运行。
  • --device=PARAM - 设备序列号。
  • -h,--help - 显示指定命令的帮助消息。
  • --install-options=PARAM - 要传递给软件包管理系统安装的其他选项或标志（例如 -g、-d）。
  • --type=PARAM - 组件类型（ACTIVITY、WATCH_FACE、TILE、COMPLICATION、DECLARATIVE_WATCH_FACE、WEAR_WIDGET）。
  • --use-delta-install - 使用快速增量安装（仅传输修改后的代码和资源，从而加快增量更新速度；默认值：true）。

android 个选项：

  • --sdk=PARAM - Android SDK 的路径。
  • -v,--verbose - 启用详细输出以进行问题排查。
  • -V,--version - 打印版本信息并退出。

说明

android run 将一个或多个 APK 文件部署到已连接的 Android 设备或模拟器，并立即启动目标应用组件。

指定要运行的内容（--type 和 --activity）

默认情况下，android run 会启动应用清单中声明的默认主 activity。您可以使用以下选项来替换启动的内容：

  • --activity：指定要启动的 activity 或组件类名称（如果 APK 声明了多个可启动的 activity，则必须指定此参数）。
  • --type：指定要启动的组件类型，而不是标准界面 activity。支持的值包括 ACTIVITY、WATCH_FACE、TILE、COMPLICATION、DECLARATIVE_WATCH_FACE 和 WEAR_WIDGET。
  • --debug：以调试模式启动应用，并等待 Android Studio 或命令行工具中的调试程序附加到该应用。

示例

部署单个调试 APK，并在默认已连接的设备上启动其主 activity：

android run --apks=app/build/outputs/apk/debug/app-debug.apk

将多个拆分 APK 部署到特定模拟器：

android run --device=emulator-5554 --apks=base.apk,density-hdpi.apk,lang-en.apk

在调试模式下部署 APK 并启动特定 activity：

android run --debug --activity=.ui.MainActivity --apks=app-debug.apk