# 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 工具鏈
```bash
./tools/environment/android/android_setup_verification.sh
```

### 2. 檢查 Flutter 支援
```bash
/Users/jettcheng1018/flutter/bin/flutter doctor
```

應該看到：
- ✅ Android toolchain - develop for Android devices
- ✅ Android Studio (version 2025.1)

### 3. 檢查可用設備
```bash
/Users/jettcheng1018/flutter/bin/flutter devices
```

應該顯示您的模擬器設備

## 🚨 常見問題解決

### 問題1：HAXM 安裝失敗
```bash
# 檢查是否支援虛擬化
sysctl -a | grep machdep.cpu.features
```

### 問題2：模擬器啟動緩慢
- 在 AVD 設置中啟用 "Graphics: Hardware - GLES 2.0"
- 增加 RAM 到 4GB 或更多

### 問題3：SDK 找不到
```bash
# 設置環境變數
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 空間