Termux Flutter IDE

🚀 Android 上的 Flutter IDE - 基於 Termux 提供完整的 Flutter 開發環境

📖 文檔

• 開發指南 - 專案結構、待辦任務
• 背景與資源 - 資源研究、技術決策、參考專案

專案願景

結合 termux-flutter-wsl 專案，在 Android 設備上實現完整的 Flutter IDE：

📱 你的 Android 設備
    ↓
🖥️ Termux Flutter IDE
    ↓
✍️ 編寫程式碼 (語法高亮、自動完成)
    ↓
🔥 flutter run → Hot Reload!
    ↓
📦 flutter build apk → 產出 APK
    ↓
📲 直接安裝測試

不需要電腦、不需要模擬器、不需要雲端服務！

---

功能規劃

✅ Phase 1: 基礎框架 (已完成)

• Flutter 專案結構
• FVM 3.38.5 + 最新套件
• Catppuccin Mocha 深色主題
• Riverpod 3.x 狀態管理

✅ Phase 2: 程式碼編輯器 (已完成)

• 整合 flutter_code_editor (100+ 語言語法高亮)
• 多檔案分頁切換
• Dart/YAML/JSON 語法主題

✅ Phase 3: 檔案管理器 (部分完成)

• 專案檔案樹 Widget
• 真實檔案系統整合
• 新增/刪除/重新命名操作

🔄 Phase 4: Termux 整合 (進行中)

• 終端機 Widget (xterm)
• Termux Bridge 通訊機制
• 執行 flutter run / flutter build apk
• 輸出串流顯示

📋 Phase 5: Dart 分析器

• 整合 Dart Analysis Server
• 即時錯誤/警告顯示
• 跳轉到定義
• 自動完成增強

---

技術架構

┌─────────────────────────────────────────────────────────────┐
│                     Termux Flutter IDE                       │
├─────────────────────────────────────────────────────────────┤
│  📝 Editor Layer                                             │
│  ├── flutter_code_editor (語法高亮、摺疊)                     │
│  ├── file_tabs_widget (多檔案分頁)                           │
│  └── CodeController (編輯狀態管理)                            │
├─────────────────────────────────────────────────────────────┤
│  📁 File Manager Layer                                       │
│  ├── file_tree_widget (專案結構)                              │
│  ├── file_picker (開啟專案)                                   │
│  └── path_provider (檔案系統)                                 │
├─────────────────────────────────────────────────────────────┤
│  🖥️ Terminal Layer                                           │
│  ├── xterm (終端機模擬)                                       │
│  └── TermuxBridge (與 Termux 通訊)                           │
├─────────────────────────────────────────────────────────────┤
│  🔧 State Management                                         │
│  └── Riverpod 3.x (NotifierProvider)                         │
└─────────────────────────────────────────────────────────────┘

---

開發環境

# 使用 FVM 確保一致的 Flutter 版本
fvm use 3.38.5

# 安裝依賴
fvm flutter pub get

# 運行
fvm flutter run

# 建置 APK
fvm flutter build apk

---

依賴套件

套件	版本	用途
flutter_code_editor	0.3.5	程式碼編輯器核心
flutter_highlight	0.7.0	語法高亮
flutter_riverpod	3.1.0	狀態管理
go_router	17.0.1	路由管理
xterm	4.0.0	終端機模擬
file_picker	10.3.8	檔案選擇器
path_provider	2.1.5	路徑管理

---

相關專案

• termux-flutter-wsl - Termux ARM64 Flutter 開發環境
• termux-app - Android 終端模擬器
• flutter_code_editor - Flutter 程式碼編輯器套件

---

授權

MIT License