Android 安装

在已连接的设备或模拟器上安装 Android 应用(一个或多个 APK),而不激活任何组件,并使用增量优化功能,从而实现比 adb 更快的部署速度。

用法

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

选项

  • --apks=PARAM - APK 的路径,以英文逗号分隔。
  • --device=PARAM - 设备序列号。
  • -h,--help - 显示指定命令的帮助消息。
  • --install-options=PARAM - 要传递给软件包管理器安装的其他选项或标志(例如 -g、-d)。
  • --use-delta-install - 使用快速增量安装(通过仅传输修改后的代码和资源来加快增量更新速度;默认值:true)。

android 个选项:

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

位置参数

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

说明

android install 会将一个或多个 APK 文件部署到已连接的 Android 设备或模拟器,而不会启动任何 activity 或服务。

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

与 android run 不同,android install 仅执行软件包安装步骤。默认情况下,它使用增量 delta 安装,仅推送自上次部署以来发生更改的字节,从而使迭代更新速度比 adb install 更快。

切换增量安装 (--use-delta-install)

增量安装默认处于启用状态。传递 --use-delta-install=false 以停用增量修补,改为执行完整的 APK 安装。

指定目标设备 (--device)

如果连接了多个实体设备或模拟器,请传递 --device=<serial-number>(由 adb devices 报告)以选择目标设备。

示例

在当前 Gradle 工作区中构建和安装 :app 的默认调试变体:

android install :app

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

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

将单个调试 APK 安装到已连接的设备上:

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

在不进行增量修补的情况下,将多个拆分 APK 安装到特定模拟器上:

android install --use-delta-install=false --device=emulator-5554 --apks=base.apk,config.hdpi.apk