123 lines
3.1 KiB
Markdown
123 lines
3.1 KiB
Markdown
# 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 空間 |