dramaling-app/tools/environment/android/emulator_setup_guide.md

Android 模擬器設置指南

📱 當前狀態

• ✅ Android Studio 已安裝
• ❌ Android SDK 需要安裝
• ❌ Android 模擬器需要設置

🚀 第一步：完成 Android Studio 設置向導

Android Studio 應該已經啟動。請按照以下步驟：

1. 初始設置向導

1. 歡迎頁面 - 點擊 "Next"
2. 安裝類型 - 選擇 "Standard" (標準安裝)
3. UI 主題 - 選擇您喜歡的主題
4. SDK 組件驗證 - 確認以下組件會被安裝：
   • Android SDK Platform
   • Android SDK Platform-Tools
   • Android SDK Build-Tools
   • Android Emulator
   • Android SDK Platform-Tools
   • Intel x86 Emulator Accelerator (HAXM installer) 或 Android Emulator Hypervisor Driver

2. 授權協議

• 接受所有 SDK 授權協議
• 點擊 "Accept" 對所有許可證

3. 組件下載

• 等待 SDK 組件下載和安裝（可能需要 10-15 分鐘）
• 確保網路連線穩定

📱 第二步：創建 Android 模擬器

SDK 安裝完成後：

1. 打開 AVD Manager

• 在 Android Studio 中，點擊 "Tools" → "AVD Manager"
• 或點擊工具欄中的手機圖標

2. 創建虛擬設備

1. 點擊 "Create Virtual Device"
2. 選擇設備：
   • 推薦：Pixel 4 或 Pixel 6
   • 類別：Phone
3. 選擇系統映像：
   • 推薦：最新的 API 34 (Android 14)
   • 如果沒有下載，點擊 "Download"
4. 配置 AVD：
   • AVD 名稱：Pixel_4_API_34 （或類似）
   • 啟動方向：Portrait
   • 其他設置保持預設

3. 啟動模擬器

• 點擊模擬器旁的 "Play" 按鈕
• 首次啟動需要較長時間

🔍 第三步：驗證設置

模擬器啟動後，執行以下驗證：

1. 檢查 Android 工具鏈

./tools/environment/android/android_setup_verification.sh

2. 檢查 Flutter 支援

/Users/jettcheng1018/flutter/bin/flutter doctor

應該看到：

• ✅ Android toolchain - develop for Android devices
• ✅ Android Studio (version 2025.1)

3. 檢查可用設備

/Users/jettcheng1018/flutter/bin/flutter devices

應該顯示您的模擬器設備

🚨 常見問題解決

問題1：HAXM 安裝失敗

# 檢查是否支援虛擬化
sysctl -a | grep machdep.cpu.features

問題2：模擬器啟動緩慢

• 在 AVD 設置中啟用 "Graphics: Hardware - GLES 2.0"
• 增加 RAM 到 4GB 或更多

問題3：SDK 找不到

# 設置環境變數
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

📋 檢查清單

完成以下所有項目：

• Android Studio 設置向導已完成
• Android SDK 已安裝到 ~/Library/Android/sdk
• Android 模擬器已創建
• 模擬器可以成功啟動
• Flutter doctor 顯示 Android 工具鏈正常
• Flutter devices 可以檢測到模擬器

⏭️ 下一步

完成上述設置後，您可以：

1. 在模擬器中測試 Flutter 應用
2. 進行 Drama Ling APP 的開發和調試
3. 測試不同的 Android 版本相容性

---

估計時間: 20-30 分鐘
網路需求: 需要穩定的網路連線下載 SDK
硬碟空間: 約需要 10GB 空間