開發環境設置指南

📋 系統需求

macOS: xcode (15.4) 以上
- 建議使用最新的穩定版本以獲得最佳開發體驗

boheng 備註

抱歉，有點忘記因為什麼套件，需要較新 Xcode 的版本 (15.4) 以上的樣子，所以建議將 Xcode 維持在 15.4 以上，當初有特別將 MacOS 版本升級上去。

📋 前置需求

在開始開發 Valo 專案前，請確保您的開發環境滿足以下需求：

1. 環境配置文件 & Android 平台配置

專案使用 .env 文件管理不同環境的配置：

# 開發環境使用 .env.dev
# 測試環境使用 .env.test
# 生產環境使用 .env.prod

# 確認環境文件存在
ls -la .env*

重要提醒

如果您沒有環境配置文件，請聯繫專案負責人取得。

[這些文件包含 Agora SDK 密鑰等敏感資訊，不該被提交到版本控制，團隊私人保管。]

Android 平台需要配置 -> 可問 David 對 Andriod 調適較熟悉

android/key.properties #Android 簽名文件配置
android/local.properties

2. flutter 環境

# 檢查 flutter 版本 (私心建議：3.32.7 以上)
flutter --version

# 檢查 Flutter 環境是否都正確配置
flutter doctor

3. 初始化專案

# clone 主要專案
git clone https://gitlab.valo-chat.site/valo/valoapp.flutter.git

# main project
cd valoapp.flutter

# 切換到該開發分支
git checkout develop

# flutter lib update
flutter pub get

# 生成必要的代碼 (auto_route, retrofit, json_serializable)
flutter packages pub run build_runner build

4. IDE 或編輯器

不限制，使用你習慣的 IDE 順手即可。

boheng:

專案期間使用過 Cursor, Claude Code 這兩套 AI Editor, 目前皆留有一些使用痕跡(.cursor/, CLAUDE.md) 當時開發習慣是有幾個工作視窗、工具：

Cursor 當主要 IDE，在一些需要自己手改時，搭配 Cursor 的 code 猜測提示。
Claude Code 在另一個 Terminal，當程式助手，有些想法問題、新需求、"較無腦"重構，會喂它試試。
GitKraken 是我額外的 Git GUI 工具，看 code diff 為主
當我喂了比較大的問題，改的範圍比較大的問題時，我會開啟 GitKraken review AI 改了哪些
- 不滿意可能會手動調整
- 不滿意可能會重新喂問題
- 不滿意全部 diff reset cancel 掉，重新餵

5. Project Run

flutter run