以下是根據你提供的資訊整理的 README.md
,已加上標題、格式化及必要的提示,適合放在你的 Flutter 專案根目錄中:
# CommunityApp
本專案為使用 Flutter 開發的社區應用程式。
---
## 🛠️ 開發環境安裝流程
### 1. 安裝工具與開發環境
- 安裝 [Flutter SDK](https://flutter.dev/docs/get-started/install)
- 安裝 [Android Studio](https://developer.android.com/studio)(內含 Android 模擬器)
- (如需打包 iOS)安裝 Xcode(限 MacOS)
- 在 Android Studio 中安裝 Flutter Plugin
- 執行以下指令檢查環境設定是否正確:
```bash
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
解法:
- 開啟 Android Studio
- 選單:
Settings → Appearance & Behavior → System Settings → Android SDK
- 切到
SDK Tools
分頁 - 勾選
Android SDK Command-line Tools (latest)
- 點選 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,掃描後直接下載。建議使用網路工具或程式碼自動產生。
📝 備註
- 建議使用 Android 實機測試(模擬器有時會限制安裝
.apk
) - 可在
pubspec.yaml
自行新增套件與資源檔案
---
如果你需要我幫你 **產生 QRCode 並放進網頁或 README 中**,也可以幫你加上!要嗎?
Description
Languages
Dart
72%
C++
14%
CMake
11.3%
Swift
1.1%
C
0.8%
Other
0.7%