在已连接的设备或模拟器上部署并启动 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