部署指南

建置指令

Flutter 支援從同一程式碼庫建置多個平台的應用程式。以下是各平台的建置指令：

# Android APK（通用）
flutter build apk

# Android App Bundle（Play Store 推薦）
flutter build appbundle

# iOS（需要 macOS + Xcode）
flutter build ios

# Web
flutter build web

# macOS（需要 macOS + Xcode）
flutter build macos

# Windows
flutter build windows

Android 部署

APK 建置

# 產生 release APK
flutter build apk --release

# 輸出位置：
# build/app/outputs/flutter-apk/app-release.apk

App Bundle 建置（Play Store）

# 產生 AAB（Google Play 推薦格式）
flutter build appbundle --release

# 輸出位置：
# build/app/outputs/bundle/release/app-release.aab

Play Store 上架步驟

1. 在 Google Play Console 建立應用程式
2. 設定簽名金鑰（keystore）
3. 上傳 AAB 檔案
4. 填寫商店資訊、螢幕截圖、內容分級
5. 提交審核

iOS 部署

建置步驟

# 建置 iOS release
flutter build ios --release

# 開啟 Xcode 進行 archive
open ios/Runner.xcworkspace

App Store 上架步驟

1. 在 Xcode 中選擇 Product → Archive
2. 在 Organizer 中選擇 Distribute App
3. 選擇 App Store Connect
4. 在 App Store Connect 填寫應用資訊
5. 提交審核

Web 部署

# 建置 Web 版本
flutter build web

# 輸出位置：
# build/web/

# 部署至任何靜態檔案伺服器
# 例如 Nginx、Apache、Firebase Hosting、GitHub Pages

Web 版本產生的是靜態檔案（HTML、CSS、JS），可以部署到任何支援靜態檔案的伺服器。

Nginx 設定範例

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/idempiere-mobile/build/web;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

macOS / Windows 部署

# macOS
flutter build macos --release
# 輸出: build/macos/Build/Products/Release/

# Windows
flutter build windows --release
# 輸出: build/windows/x64/runner/Release/

白牌設定（White-Label）

iDempiere Mobile 支援透過伺服器端的 AD_SysConfig 設定項進行白牌客製化，無需修改 App 程式碼：

這些設定由 BrandingConfig 在登入後從伺服器載入，自動套用到 App 的外觀和功能開關。

Material 3 色彩種子

MOBILE_SEED_COLOR 使用 hex 色碼（不含 #），Flutter 的 ColorScheme.fromSeed() 會自動產生完整的色彩方案。例如：

• 2196F3 — 藍色（預設）
• 4CAF50 — 綠色
• FF5722 — 橘紅色
• 9C27B0 — 紫色

Firebase 設定（選用）

推播通知功能需要 Firebase Cloud Messaging (FCM) 設定。應用程式在缺少 Firebase 設定時仍可正常運作 — FCM 功能會優雅地停用。

設定步驟

1. 在 Firebase Console 建立專案
2. 為各平台新增應用程式（iOS、Android、Web）
3. 下載設定檔：
   • Android：google-services.json → android/app/
   • iOS：GoogleService-Info.plist → ios/Runner/
4. 應用程式會在啟動時自動初始化 Firebase 並註冊 FCM token

FCM Token 管理

// ApiClient 提供 FCM token 註冊/取消註冊：
await api.registerFcmToken(token);
await api.unregisterFcmToken(token);

疑難排解

flutter build apk          # Android APK
flutter build appbundle     # Android AAB (Play Store)
flutter build ios           # iOS (requires macOS + Xcode)
flutter build web           # Web (static files)
flutter build macos         # macOS
flutter build windows       # Windows