萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 模擬器 (AVD) 命令列完整操作手冊

前置準備

  • 安裝 Android SDK Command Line Tools:sdkmanager "platform-tools" "emulator" "system-images;android-34;google_apis;x86_64"
  • 將 $ANDROID_SDK_ROOT/emulator、$ANDROID_SDK_ROOT/platform-tools 加入 PATH。

核心命令速查表

操作命令說明
列出可用系統映像sdkmanager --list | grep system-images或 avdmanager list (舊)
列出已安裝映像sdkmanager --list_installed | grep system-images
建立 AVDavdmanager create avd -n Pixel8_API34 -k "system-images;android-34;google_apis;x86_64" -d "pixel_8" --force-d 指定裝置定義 (可用 avdmanager list device 查看)
列出已建立 AVDavdmanager list avd 或 emulator -list-avds
啟動 AVD (前景)emulator -avd Pixel8_API34終端機會佔用,輸出日誌
啟動 AVD (背景/無頭)emulator -avd Pixel8_API34 -no-window -no-audio -no-boot-anim -gpu swiftshader_indirect &CI/CD 適用,-no-window 無 GUI
指定啟動參數emulator -avd Pixel8_API34 -netdelay gsm -netspeed edge -scale 0.8 -memory 2048 -partition-size 4096網路模擬、縮放、記憶體、資料分區大小
快照管理emulator -avd Pixel8_API34 -snapshot-list / -snapshot snap_name / -no-snapshot-load -no-snapshot-save快速儲存/恢復狀態
刪除 AVDavdmanager delete avd -n Pixel8_API34刪除 ~/.android/avd/Pixel8_API34.avd 目錄
查看模擬器進程adb devices (顯示 emulator-5554 等)
關閉模擬器adb -s emulator-5554 emu kill 或 Ctrl+C (前景模式)

常用進階參數

  • -gpu host / swiftshader_indirect / angle_indirect:GPU 加速模式,Mac/Windows 建議 host,Linux CI 建議 swiftshader_indirect。
  • -camera-back emulated / -camera-front webcam0:模擬相機。
  • -writable-system:系統分區可寫 (需 root,配合 adb root adb remount)。
  • -selinux disabled:暫時關閉 SELinux 測試。
  • -feature -Vulkan:停用 Vulkan 相容性測試。
  • -prop persist.adb.tcp.port=5555:啟用 TCP/IP ADB (需重啟)。

疑難排解

問題原因/解決
啟動卡在 "Boot animation" / 黑屏關閉 Hyper-V / Windows Hypervisor Platform (關閉後需重啟);或啟用 WHPX (-feature +Whpx);確認 BIOS 開啟 VT-x/SVM。
emulator: ERROR: x86 emulation requires hardware acceleration安裝 Intel HAXM (Intel CPU) 或啟用 WHPX (Windows 10 1803+),AMD CPU 需開啟 SVM + Windows Hypervisor Platform。
無法連網檢查宿主機網路、DNS、代理;模擬器預設 10.0.2.2 對應宿主機 localhost。
磁碟空間不足emulator -avd X -wipe-data 清理快照;遷移 AVD 目錄到大磁碟 (ANDROID_AVD_HOME 環境變數)。
鍵盤不輸入Extended controls → Settings → "Send keyboard shortcuts to virtual device" 勾選;或使用軟鍵盤。

自動化腳本範例 (CI/CD)

#!/bin/bash
set -e
AVD_NAME="ci_pixel8_api34"
# 1. 確保 AVD 存在
if ! emulator -list-avds | grep -q "^${AVD_NAME}$"; then
  echo "Creating AVD..."
  avdmanager create avd -n "$AVD_NAME" -k "system-images;android-34;google_apis;x86_64" -d "pixel_8" --force
fi
# 2. 啟動無頭模擬器
emulator -avd "$AVD_NAME" -no-window -no-audio -no-boot-anim -gpu swiftshader_indirect -no-snapshot-load &
EMU_PID=$!
# 3. 等待啟動完成 (boot_completed)
adb wait-for-device shell 'while [[ -z $(getprop sys.boot_completed) ]]; do sleep 1; done'
echo "Emulator ready."
# 4. 執行測試
./gradlew connectedAndroidTest
# 5. 關閉
adb -s emulator-5554 emu kill
wait $EMU_PID

鍵盤快捷鍵 (模擬器視窗焦點時)

  • Ctrl+F11 / Ctrl+F12:切換橫/直向
  • F1:選單鍵
  • Esc:返回鍵
  • Home:Home 鍵
  • F2:音量減 / F3:音量增
  • F5:電源鍵
  • Ctrl+F:全螢幕切換

熟練命令列操作 AVD,讓本地開發、CI/CD、自動化測試流程更順暢。

copyright © 萬盛學電腦網 all rights reserved