android run

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

用法

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

选项

  • --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 - 输出版本信息并退出。

位置参数

  • <apks_or_reference> - APK 文件路径或 build 引用 ([system://][path]?[target])。
  • -- <build_args> - 逐字传递给构建系统的参数。使用 -- 与其他参数分隔。

说明

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

传递 build 引用 ([system://][path]?[target]) 以从源代码构建和部署,或传递预构建的 APK 文件路径(在 <apks_or_reference> 中或使用 --apks)。

指定要运行的内容(--type 和 --activity)

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

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

示例

在当前 Gradle 工作区中构建、部署和启动 :app 的默认调试变体:

android run :app

从 $HOME/my-app 处的 Gradle 工作区构建并运行 :app (:app@debug) 的 debug 变体,并将额外参数传递给 Gradle:

android run $HOME/my-app?:app@debug -- --offline

部署单个调试 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