本文件詳細說明 Flutter 專案在 iOS 與 Android 平台進行 Release（正式版）Build 的完整流程、注意事項與常用指令，適合準備上架 App Store / Google Play 前參考。
一、建置前通用檢查（iOS / Android）
1. Flutter 環境確認
flutter doctorAbout 2 min
本教學將帶你 用最標準、最安全、最省時的方式，在 Flutter 專案中同時產生 iOS 與 Android 的 App Icon。
✅ 適用：正式上架 App Store / Google Play
✅ 不需手動切圖、不碰 Xcode / Android Studio
一、推薦做法總覽（結論先看）
👉 使用官方主流套件：flutter_launcher_icons
About 2 min
本指南將分步帶您完成在 Flutter 應用程式中設置 Firebase Cloud Messaging (FCM) 的過程，涵蓋 Android 和 Dart (Flutter) 兩個部分。
前提條件
- 一個已設置並連結到 Firebase 專案的 Flutter 應用。
- 已安裝並配置 Flutter 開發環境。
- 已在 Firebase Console 下載
google-services.json文件。
第一步：Android 端配置
About 3 min
以下是根據 Flutter 官方文件中「」的說明，整理出的一個典型國際化（locale）實作流程，並以 Markdown 格式呈現，便於閱讀與使用：
Flutter 國際化（Internationalization）實作流程
1. 匯入依賴
在 pubspec.yaml 中加入以下依賴：
dependencies:
flutter:
sdk: flutter
flutter_localizations:
sdk: flutter
intl: ^0.18.0About 1 min
sample code
new interface class:
// sample class
class S {
void Function(String)? onABC;
void Function(int)? onDEF;
STTCallback({this.onABC, this.onDEF});
}Less than 1 minute
Dart does not currently have an arbitrary base logarithm function, only base e (log). This is most likely inherited from JavaScript, which also only provides these two.
In general, the logarithm at one base, b1, can be found using the logarithm at any other base, b2 as logb1(x) = logb2(x) / logb2(b1).
Less than 1 minute
# Flutter build failed on andorid platform
Build log
* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org.
==============================================================================
2: Task failed with an exception.
-----------
* What went wrong:
Execution failed for task ':path_provider_android:compileDebugJavaWithJavac'.
> Could not resolve all files for configuration ':path_provider_android:androidJdkImage'.
> Failed to transform core-for-system-modules.jar to match attributes {artifactType=_internal_android_jdk_image, org.gradle.libraryelements=jar, org.gradle.usage=java-runtime}.
> Execution failed for JdkImageTransform: D:\Android_SDK\Sdk\platforms\android-35\core-for-system-modules.jar.
> Error while executing process C:\Program Files\Android\Android Studio\jbr\bin\jlink.exe with arguments {--module-path C:\Users\XXXXXXXXX\.gradle\caches\transforms-3\cc12c5242eac95612f50f56c
5a36d784\transformed\output\temp\jmod --add-modules java.base --output C:\Users\XXXXXXXXX\.gradle\caches\transforms-3\cc12c5242eac95612f50f56c5a36d784\transformed\output\jdkImage --disable-plugin syst
em-modules}
* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org.
==============================================================================
BUILD FAILED in 6s
Running Gradle task 'assembleDebug'... 7.6s
┌─ Flutter Fix ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ [!] This is likely due to a known bug in Android Gradle Plugin (AGP) versions less than 8.2.1, when │
│ D:\XXXXXXXXXXXXXXXXX\android\settings.gradle, │
│ in the 'plugins' closure (by the number following "com.android.application"). │
│ Alternatively, if your project was created with an older version of the templates, it is likely │
│ in the buildscript.dependencies closure of the top-level build.gradle: │
│ D:\XXXXXXXXXXXXXXXXX\android\build.gradle, │
│ as the number following "com.android.tools.build:gradle:". │
│ │
│ For more information, see: │
│ https://issuetracker.google.com/issues/294137077 │
│ https://github.com/flutter/flutter/issues/156304 │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
Error: Gradle task assembleDebug failed with exit code 1About 1 min
Flutter 雖然提供了豐富的 Widget 和 API 來構建跨平台應用，但有時候仍然需要與原生層溝通。以下是需要與原生層溝通的一些主要原因：
- 訪問平台特定功能
- 平台 API: 有些功能 Flutter 沒有內建支持，但可以通過平台特定的 API 來實現。例如，訪問相機、傳感器、藍牙、NFC、通知系統、地理位置服務等。
- 系統設置: 某些應用可能需要訪問或修改設備的系統設置，如亮度、音量、網絡設置等，這些通常需要使用原生 API。
- 整合現有的原生代碼
- 現有應用: 如果你有一個現有的原生應用，並想逐步將其轉移到 Flutter，可能需要在過渡期間讓 Flutter 和原生代碼協同工作。
- 使用第三方 SDK: 有些第三方 SDK 僅提供原生支持（如一些支付 SDK、廣告 SDK），需要通過原生代碼進行集成。
- 性能優化
- 高效的 UI 渲染: 某些情況下，使用原生 UI 控件可能會比 Flutter Widget 更高效。比如在需要嵌入高性能原生控件時（如地圖或視頻播放器），可以考慮通過 Platform View 來實現。
- 高頻率/低延遲操作: 某些需要頻繁、快速交互的操作，可能通過原生代碼會更高效。
- 處理平台特有的行為
- 平台差異: Android 和 iOS 之間存在一些差異，例如後台處理、生命周期管理、權限處理等。這些行為可能需要通過原生代碼來處理，以確保在各平台上都有一致的用戶體驗。
- 原生 UI 風格: 在某些應用中，可能需要遵循平台的設計規範（如 Material Design 和 iOS 的 Human Interface Guidelines），這時可能需要使用原生代碼來達到最佳的設計一致性。
- 跨平台限制
- Flutter 尚未支持的功能: 雖然 Flutter 正在快速發展，但它並不支持所有的功能。如果你需要使用一個 Flutter 尚未支持的功能，則需要通過與原生層的溝通來實現。
- 平台依賴: 有些操作或特性可能強烈依賴於平台本身，這時使用原生代碼會更合適。
- 繼承和復用
- 現有的原生邏輯: 在遷移到 Flutter 時，可能有一些業務邏輯、算法或服務已經用原生代碼實現，為了復用這些代碼，可以通過與原生層的溝通來整合這些功能。
About 5 min
log 紀錄
對於更複雜的應用，建議使用 logger package，它提供了更多功能，例如不同級別的日志記錄、格式化、輸出到文件等。
Logger package：
-
安裝 logger：
dependencies: logger: ^1.2.2 -
實現代碼 :
import 'package:logger/logger.dart'; var logger = Logger(); logger.d("Debug message"); logger.i("Info message"); logger.w("Warning message"); logger.e("Error message"); -
控制日志输出 : 在 Flutter 中，使用 Logger 或其他類似的日誌工具時，預設日誌不會在發布（release）模式下消失，但你可以透過設定日誌記錄行為來控制日誌在不同建置模式下的輸出。
About 4 min
安裝 Flutter 和 Dart 插件
- 打開 VSCode，點擊左側的擴展圖標（或按
Ctrl+Shift+X）。 - 搜尋 "Flutter" 並安裝官方插件。
- 搜尋 "Dart" 並安裝官方插件。
- 使用到的語言插件...
安裝 各平台ide
- Android Studio
- Android SDK
- Android toolchain
- Android cmdline tool
- Visual Studio
- Desktop development with C++ workload.
- Xcode : todo
About 1 min