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

71 lines
2.0 KiB
Markdown

# 開發環境設定工具
## 📂 目錄結構
本目錄包含各種開發環境的設定指南和工具。
### 📱 iOS 開發環境 (Xcode)
**文件位置**: `docs/04_technical/environment/xcode_setup_guide.md`
**工具位置**: `tools/environment/xcode/`
**可用工具**:
- `complete_xcode_setup.sh` - 完整 Xcode 設定腳本
- `xcode_verification.sh` - Xcode 安裝驗證工具
- `monitor_xcode_installation.sh` - 安裝進度監控
**使用方法**:
```bash
# 監控 Xcode 安裝進度
./tools/environment/xcode/monitor_xcode_installation.sh
# Xcode 安裝完成後執行完整設定
./tools/environment/xcode/complete_xcode_setup.sh
# 驗證 Xcode 設定
./tools/environment/xcode/xcode_verification.sh
```
### 🤖 Android 開發環境 (Android Studio)
**工具位置**: `tools/environment/android/`
**可用工具**:
- `android_setup_verification.sh` - Android 開發環境驗證工具
**使用方法**:
```bash
# 驗證 Android 開發環境
./tools/environment/android/android_setup_verification.sh
```
## 🛠️ 工具設計原則
1. **目錄分離**: 所有設定工具都放在 `tools/environment/` 下對應的子目錄中
2. **文檔分離**: 設定指南放在 `docs/04_technical/environment/`
3. **功能專一**: 每個腳本都有明確的單一功能
4. **路徑規範**: 所有腳本從專案根目錄執行,使用相對路徑
## 📋 新增環境工具
當需要新增其他開發環境設定工具時,請遵循以下結構:
```
tools/environment/
├── android/ # Android 相關工具
├── xcode/ # iOS/Xcode 相關工具
├── flutter/ # Flutter 相關工具
├── node/ # Node.js 相關工具
└── [new-env]/ # 新環境工具
docs/04_technical/environment/
├── README.md # 本文件
├── xcode_setup_guide.md
├── android_setup_guide.md
└── [new-env]_setup_guide.md
```
---
**最後更新**: 2025-09-08
**維護者**: Drama Ling 開發團隊