dramaling-app/docs/04_technical/environment/xcode_setup_guide.md

Xcode 安裝和配置指南

📱 Xcode 安裝步驟

方法1: 透過 Mac App Store（推薦）

1. 打開 Mac App Store
2. 搜尋 "Xcode"
3. 點擊 "取得" 或 "安裝"
4. 等待下載完成（約 10-15GB，需要較長時間）

方法2: 透過 Apple Developer（進階用戶）

1. 訪問 https://developer.apple.com/xcode/
2. 下載最新版本的 Xcode
3. 解壓縮並移動到 Applications 資料夾

🔧 安裝後配置步驟

1. 設定 Xcode 開發者路徑

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

2. 執行首次設定

sudo xcodebuild -runFirstLaunch

3. 接受授權條款

sudo xcodebuild -license accept

4. 安裝額外組件

• 啟動 Xcode
• 等待首次載入和索引完成
• 安裝建議的額外組件

📋 驗證安裝

執行驗證腳本：

./xcode_verification.sh

🚨 注意事項

• 空間需求: 確保有至少 15GB 的可用空間
• 時間需求: 下載和安裝可能需要 30-60 分鐘
• 網路需求: 穩定的網路連線
• Apple ID: 可能需要登入 Apple ID

📱 iOS 模擬器設定

1. 開啟 Xcode
2. 前往 Window > Devices and Simulators
3. 點擊 "Simulators" 標籤
4. 下載所需的 iOS 模擬器版本

🔐 開發者憑證設定（選用）

對於真實設備開發需要：

1. Apple Developer Program 帳號
2. 開發者憑證配置
3. Provisioning Profile 設定

---

建立時間: 2025-09-08
適用版本: Xcode 15+, macOS 15+