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:指定要啟動的活動或元件類別名稱 (如果 APK 宣告多個可啟動的活動,則為必要)。
  • --type:指定要啟動的元件類型,而非標準 UI 活動。支援的值包括 ACTIVITY、WATCH_FACE、TILE、COMPLICATION、DECLARATIVE_WATCH_FACE 和 WEAR_WIDGET。
  • --debug:以偵錯模式啟動應用程式,並等待 Android Studio 或指令列工具的偵錯工具附加。

範例

部署單一偵錯 APK,並在預設連結裝置上啟動其主要活動:

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 並在偵錯模式中啟動特定活動:

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