Flutter技能

skills/skills/flutter-build-responsive-layout

Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on…

skills/skills/flutter-building-forms

經過驗證的Flutter表單，具備欄位級錯誤處理與提交流程。需使用StatefulWidget託管，並搭配持久的GlobalKey<FormState>來管理表單狀態與跨重建的驗證。使用TextFormField元件，並透過validator()回呼函式在驗證失敗時返回錯誤字串，成功時返回null。提交時呼叫_formKey.currentState!.validate()觸發所有驗證器，並自動在欄位下方顯示錯誤訊息。包含完整程式碼範例，示範使用者名稱...

skills/skills/flutter-building-layouts

掌握 Flutter 的約束系統，高效構建響應式且無溢出的佈局。核心原則：約束向下傳遞，尺寸向上傳遞，父層設定位置。切勿在彈性盒子或可滾動區域中傳遞無界約束。使用 Row / Column 處理線性佈局，Expanded / Flexible 分配空間，Stack 處理重疊元素，SizedBox 設定嚴格約束。運用 LayoutBuilder 實現響應式尺寸調整，或透過條件渲染實現跨手機、平板等裝置的自適應佈局。

skills/skills/flutter-building-plugins

建立並實作跨平台Flutter外掛，支援Android、iOS、Windows及網頁的原生互通。支援標準外掛（透過Method Channels存取平台API）與FFI外掛（C/C++原生函式庫）；可根據需要平台特定SDK存取或直接原生程式碼繫結來選擇。聯邦式外掛架構將API拆分為應用程式端、平台介面及獨立平台實作套件，適合團隊開發。包含逐步...

skills/skills/flutter-caching

針對 Flutter 應用程式提供全面的快取與效能最佳化，支援多種資料類型與平台。包含決策邏輯以選擇適當的快取機制：記憶體內快取、用於鍵值對的 shared_preferences、用於關聯式資料的 SQLite、用於大型資料區塊的檔案系統，以及用於網路圖片的圖片快取。內建基於串流的離線優先儲存庫模式，先回傳快取資料，再從網路擷取並更新。涵蓋 Android FlutterEngine 預先暖機及...

skills/skills/flutter-caching-data

針對 Flutter 應用程式的本地資料快取與離線優先同步模式。涵蓋五種快取策略：用於 UI 狀態的 shared_preferences、用於結構化資料的 SQLite/Hive、用於二進位媒體的檔案系統、用於導航的狀態還原，以及 Android 上的 FlutterEngine 預熱。透過串流實現離線優先的儲存庫（先輸出本地資料、再擷取遠端資料、最後更新快取），並採用雙重寫入策略（僅限線上模式 vs. 離線優先搭配背景同步）。最佳化圖片快取...

flutter/.agents/skills/flutter-cherry-pick

如何為 flutter/flutter 儲存庫的穩定版或測試版頻道提交正式的 cherry-pick，僅適用於已合併的 flutter/flutter 拉取請求。僅…

skills/skills/flutter-concurrency

背景 JSON 解析與狀態管理，實現無卡頓的 Flutter UI 渲染。提供基於模型複雜度的決策樹，協助在人工序列化（dart:convert）與程式碼生成（json_serializable）之間進行選擇。支援三種並行策略：針對小量資料使用主執行緒的 async/await、針對大量一次性計算使用短生命週期的 Isolate.run()、以及透過 ReceivePort / SendPort 實現持續雙向通訊的長生命週期隔離區。包含平台感知的備援機制：...

skills/skills/flutter-databases

符合MVVM架構的Flutter資料層，採用Repository模式、無狀態服務及智慧本地快取策略。根據資料類型、大小與關聯複雜度，引導選擇持久化技術（shared_preferences、sqflite、drift、hive_ce、isar_community或檔案I/O）。將Repository實作為唯一資料來源，隔離DatabaseService與ApiClient作為私有無狀態依賴。提供領域模型、SQLite操作及...的完整程式碼範例。

skills/skills/flutter-embedding-native-views

直接將原生 Android、iOS 或 macOS 視圖及網頁內容嵌入 Flutter 應用程式。支援兩種 Android 合成模式（混合與紋理圖層），各有不同的效能與保真度取捨；iOS 與 macOS 僅使用混合合成。包含在 Android 與 iOS 上實作平台視圖的逐步工作流程，並提供驗證與疑難排解指引。可透過全頁或多視圖（嵌入式）模式將 Flutter 嵌入現有網頁應用程式，並...

skills/skills/flutter-environment-setup-linux

Linux環境設定，適用於Flutter桌面開發，包含作業系統偵測與工具鏈驗證。自動偵測Debian/Ubuntu或ChromeOS，並在非apt系統上暫停並顯示說明。安裝核心依賴項（curl、git、unzip、libglu1-mesa）及Linux桌面工具鏈（clang、cmake、ninja-build、GTK函式庫）。提示選擇性IDE設定（透過snap安裝VS Code或Android Studio）。執行flutter doctor -v與flutter devices以驗證環境，並自動安裝...

skills/skills/flutter-environment-setup-macos

自動化macOS Flutter開發環境設置，包含依賴驗證與診斷修復。檢查Flutter安裝、Xcode可用性及CocoaPods是否存在；若缺少任何必要條件，則停止並提供清晰指引。引導使用者完成Xcode命令列工具配置及授權接受，並執行必要的sudo指令。透過反覆執行flutter doctor驗證迴圈，識別並解決剩餘工具鏈問題，直到Xcode部分完全通過...

skills/skills/flutter-environment-setup-windows

自動化Windows Flutter開發環境設置，包含平台專屬工具鏈配置。透過互動式提示，為Windows桌面、Android或兩者目標配置Flutter SDK路徑、Visual Studio C++工具鏈安裝及平台專屬設定。當選擇Android時，處理Android Studio設置、裝置/模擬器配置及USB驅動程式安裝。使用OpenSSL生成自簽名MSIX憑證，用於本地Windows應用程式打包與部署...

skills/skills/flutter-fix-layout-issues

使用 Dart 和 Flutter MCP 工具修復 Flutter 佈局錯誤（溢出、無限制約束）。適用於處理「RenderFlex overflowed」、「Vertical…」等問題。

skills/skills/flutter-form

建立具備驗證功能的表單

skills/skills/flutter-handling-concurrency

將CPU密集型任務卸載到後台隔離區，同時保持Flutter UI的響應性。提供三種並發模式：用於I/O密集型工作的async/await、用於一次性重度計算的Isolate.run()，以及帶消息傳遞的Isolate.spawn()用於持久後台工作。包含一個決策矩陣，可根據任務類型（I/O密集型 vs. CPU密集型）和執行頻率在異步操作與隔離區之間進行選擇。涵蓋三個完整工作流程，附帶逐步任務清單：標準...

skills/skills/flutter-handling-http-and-json

HTTP請求與JSON序列化，用於Flutter REST API整合與資料解析。涵蓋三種HTTP方法（GET、POST、PUT、DELETE），包含正確的狀態碼驗證、HTTPS強制使用，以及透過Uri.https()安全建構URI。提供兩種序列化策略：針對簡單模型的手動fromJson/toJson，以及針對複雜巢狀結構使用json_serializable的程式碼生成。包含使用compute()進行背景解析，以在處理大型JSON負載時防止UI卡頓...

skills/skills/flutter-home-screen-widget

適用於 iOS 和 Android 上 Flutter 應用程式的原生主螢幕小工具，支援跨平台資料共享。透過 App Groups（iOS）和 SharedPreferences（Android）在 Dart 與原生平台之間建立資料共享，讓您能從 Flutter 應用程式更新小工具。支援簡單的文字型小工具，以及以靜態圖片形式呈現的複雜 Flutter UI，供原生顯示使用。需要在 Xcode（使用 Swift TimelineProvider 的 Widget Extension 目標）和 Android Studio（使用 XML 的 AppWidgetProvider）中進行原生設定...

skills/skills/flutter-http-and-json

為Flutter應用程式提供安全的HTTP網路通訊與JSON處理，並支援背景解析。使用http套件實作CRUD操作（GET、POST、PUT、DELETE），透過Uri.https()安全建構URL，並進行嚴格的狀態碼驗證。採用Dart 3模式匹配搭配工廠建構子與toJson()方法，實現強型別的JSON序列化與反序列化。針對超過16ms的負載，透過compute()將大型JSON解析卸載至背景隔離區，避免UI卡頓。

skills/skills/flutter-implement-json-serialization

Create model classes with `fromJson` and `toJson` methods using `dart:convert`. Use when manually mapping JSON keys to class properties for simple data…

skills/skills/flutter-implementing-navigation-and-routing

Flutter 螢幕轉場與深層連結的指令式與宣告式路由模式。涵蓋 Navigator（指令式、基於堆疊）與 Router（宣告式、URL 同步）兩種方法，並提供使用時機指引。支援 iOS、Android 及 Web 平台的深層連結；包含透過建構子、路由引數與回傳值傳遞資料。實作多步驟流程（如設定精靈）的巢狀導航，具備獨立子導航器與返回按鈕攔截功能。提供...

skills/skills/flutter-improving-accessibility

為輔助技術（包括螢幕閱讀器和鍵盤導航）配置 Flutter 應用程式。涵蓋 UI 設計基礎：字型縮放、色彩對比（一般文字 4.5:1，大字型 3:1），以及 48x48 像素的最小點擊目標。提供使用 Semantics、MergeSemantics 和 ExcludeSemantics 小工具的語意標註模式，以向輔助工具暴露小工具樹結構。包含針對網頁的啟用語意層（預設為效能考量而停用）的指引，以及...

skills/skills/flutter-interoperating-with-native-apis

從 Flutter 程式碼存取 Android、iOS 及網頁上的裝置專屬原生 API。支援三種整合方式：FFI 用於直接繫結 C/C++、平台通道（搭配 Pigeon 確保型別安全）用於呼叫 Kotlin/Swift/Objective-C，以及平台視圖用於嵌入原生 UI 元件。FFI 使用 dart:ffi，並透過 build.dart 鉤子自動編譯建置；需使用 extern "C" 符號及 package:ffigen 產生 Dart 繫結。平台通道提供非同步訊息傳遞...

skills/skills/flutter-layout

透過組合小部件、管理約束條件以及適應螢幕尺寸，來建構響應式 Flutter 佈局。提供決策樹，根據內容維度、重疊、滾動及響應需求，選擇合適的基礎佈局小部件（Row、Column、Stack、ListView、GridView、CustomScrollView）。強制執行 Flutter 核心約束系統：約束向下傳遞、尺寸向上傳遞、父級設定位置；包含用於強制指定尺寸的 ConstrainedBox 模式。實作...

skills/skills/flutter-localization

配置 Flutter 應用程式以支援多語言和地區設定，並進行適當的 i18n 設置。管理依賴注入（flutter_localizations、intl）、程式碼生成配置（l10n.yaml）以及 .arb 翻譯檔案建立，支援佔位符、複數形式和區域變體。配置根元件委派（MaterialApp、CupertinoApp 或 WidgetsApp），並處理需要明確 Localizations 包裝的獨立元件，如 TextField 和 CupertinoTabBar。支援...

skills/skills/flutter-localizing-apps

使用 ARB 檔案與程式碼生成技術，為 Flutter 應用程式提供多語言支援。在 pubspec.yaml 中配置 flutter_localizations 與 intl，接著定義 l10n.yaml 檔案以啟用 gen-l10n 程式碼生成器。將本地化字串儲存在應用程式資源套件（.arb）JSON 檔案中；範本檔案定義所有鍵值，而特定語系檔案則提供翻譯。透過新增 AppLocalizations.delegate 與平台專屬委派，將本地化功能整合至 MaterialApp 或 CupertinoApp 中...

skills/skills/flutter-managing-state

在Flutter中使用StatefulWidget、MVVM和Provider管理瞬時狀態與應用層級狀態。區分瞬時狀態（單一widget，使用setState()管理）與應用狀態（跨widget共享，使用MVVM和provider套件管理）。透過單一事實來源實現單向資料流：Model處理資料，ViewModel透過ChangeNotifier管理UI狀態，View消費並顯示狀態。提供MVVM實作的循序工作流程：定義Repository、建立...

skills/skills/flutter-native-interop

跨平台原生互操作性，適用於 Android、iOS 及 Web 上的 Flutter 應用程式。提供決策邏輯以選擇最佳整合策略：針對 C/C++ 程式碼使用 FFI、針對作業系統特定 API 使用 Platform Channels、針對原生 UI 元件使用 Platform Views，以及針對網頁使用 JS Interop。採用現代 FFI 架構，透過建置掛鉤（Flutter 3.38+）搭配原生工具鏈編譯與 Dart 繫結，支援非同步 Platform Channels（MethodChannel），並完整支援 Kotlin 與 Swift...

skills/skills/flutter-performance

透過系統性剖析與針對性優化，識別並消除 Flutter 應用中的效能瓶頸。提供決策樹以診斷 UI 執行緒、Raster（GPU）執行緒或兩者同時發生的卡頓問題，並針對每種情況提供具體修復方案。包含使用 traceAction 與 TimelineSummary 建立效能基準並測量幀預算的整合測試模板。涵蓋 UI 優化（局部化狀態、const 建構子、StringBuffer 使用）與 Raster 優化（取代 Opacity...

skills/skills/flutter-platform-views

在 Android、iOS、macOS 及網頁平台上，將原生視圖與網頁內容嵌入 Flutter 應用程式。支援 Android 混合合成（原生保真度）與紋理圖層（Flutter 效能）、iOS/macOS 混合合成，以及網頁全頁面或嵌入式多視圖模式。提供完整的 Dart 與原生程式碼範本（Android 使用 Kotlin、iOS/macOS 使用 Swift、網頁使用 JavaScript），並搭配工廠註冊模式。需事先透過決策樹判斷目標平台與嵌入方式...