在已連結的裝置或模擬器上建構、部署及啟動 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