CommunityApp

本專案為使用 Flutter 開發的社區應用程式。

---

🛠️ 開發環境安裝流程

1. 安裝工具與開發環境

• 安裝 Flutter SDK
• 安裝 Android Studio（內含 Android 模擬器）
• （如需打包 iOS）安裝 Xcode（限 MacOS）
• 在 Android Studio 中安裝 Flutter Plugin
• 執行以下指令檢查環境設定是否正確：

flutter doctor

---

2. 設定系統變數（加入 Flutter 至 PATH）

• Windows
  控制台 → 環境變數 → 系統變數 → Path → 新增：<你的 flutter 路徑>\bin

• Mac/Linux 在 ~/.bashrc 或 ~/.zshrc 加入以下內容：

  export PATH="$PATH:/你的/flutter/bin/路徑"
  

---

3. 驗證安裝是否成功

flutter --version
flutter doctor

---

🐞 常見錯誤與解法

❗ cmdline-tools component is missing

解法：

1. 開啟 Android Studio
2. 選單：Settings → Appearance & Behavior → System Settings → Android SDK
3. 切到 SDK Tools 分頁
4. 勾選 Android SDK Command-line Tools (latest)
5. 點選 Apply 安裝

---

❗ Android license status unknown

解法：

flutter doctor --android-licenses

出現授權條文時，請一律輸入 y 接受。

---

🚀 建立與執行專案

⚠️ 注意：資料夾與檔案名稱請勿含中文、空格或大寫！

flutter create communityapp
cd communityapp
flutter run

執行後會看到 Flutter 的預設計數器 App 出現在模擬器上。

---

📦 打包 APK 並讓手機掃 QRCode 安裝

1. 建立 APK 檔案

flutter build apk --release

2. 啟動本機伺服器

cd build/app/outputs/flutter-apk
python -m http.server 8000

3. 找出本機 IP

ipconfig  # Windows
ifconfig  # Mac/Linux

記下你的 IP，例如 192.168.1.100

4. 手機下載安裝 APK

在手機瀏覽器輸入：

http://192.168.1.100:8000/app-release.apk

或者你也可以產生一個 QRCode，掃描後直接下載。建議使用網路工具或程式碼自動產生。

---