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>来管理表单状态和跨重建的验证。使用带有validator()回调的TextFormField组件，该回调在验证失败时返回错误字符串，成功时返回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和Web的原生互操作。支持标准插件（通过Method Channel调用平台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预预热。通过流式读取（先返回本地数据，再获取远程数据，最后更新缓存）实现离线优先仓库，并采用双重写入策略（纯在线模式与离线优先+后台同步模式）。优化图片缓存...

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

如何为flutter/flutter仓库的稳定版或测试版通道提交一个正式的cherry-pick，针对已合并的PR。仅适用于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

为Flutter桌面开发提供Linux环境配置，包含操作系统检测与工具链验证。自动识别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溢出”、“垂直…

skills/skills/flutter-form

构建带验证的表单

skills/skills/flutter-handling-concurrency

将CPU密集型任务卸载到后台隔离区，同时保持Flutter UI响应。提供三种并发模式：用于I/O密集型工作的async/await、用于一次性重型计算的Isolate.run()，以及通过消息传递实现持久后台工作者的Isolate.spawn()。包含一个决策矩阵，可根据任务类型（I/O密集型与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序列化与反序列化。通过compute()将大型JSON解析任务卸载到后台隔离区，避免超过16ms的负载导致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小部件的语义标注模式，以向辅助工具暴露小部件树结构。包含针对Web的指导，用于启用语义层（默认因性能原因禁用）以及...

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

从Flutter代码访问Android、iOS和Web上设备特定的原生API。支持三种集成方式：用于直接C/C++绑定的FFI、用于调用Kotlin/Swift/Objective-C的平台通道（通过Pigeon实现类型安全），以及用于嵌入原生UI组件的平台视图。FFI使用dart:ffi并通过build.dart钩子自动编译构建；需要extern "C"符号和package:ffigen生成Dart绑定。平台通道提供异步消息传递...

skills/skills/flutter-layout

通过组合widget、管理约束和适配屏幕尺寸，构建响应式Flutter布局。提供决策树，根据内容维度、重叠、滚动和响应式需求，选择合适的基础布局widget（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文件中；模板文件定义所有键，特定语言文件提供翻译。通过向MaterialApp或CupertinoApp添加AppLocalizations.delegate和平台特定委托来集成本地化...

skills/skills/flutter-managing-state

使用StatefulWidget、MVVM和Provider管理Flutter中的临时状态和应用级状态。区分临时状态（单个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使用平台通道，针对原生UI组件使用平台视图，针对Web端使用JS互操作。采用基于构建钩子（Flutter 3.38+）的现代FFI架构，支持原生工具链编译与Dart绑定，并实现异步平台通道（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 和 Web 平台上将原生视图和 Web 内容嵌入 Flutter 应用。支持 Android 混合合成（原生保真度）和纹理层（Flutter 性能）、iOS/macOS 混合合成，以及 Web 全屏或嵌入式多视图模式。提供完整的 Dart 和原生代码模板（Android 使用 Kotlin，iOS/macOS 使用 Swift，Web 使用 JavaScript），并采用工厂注册模式。需要预先通过决策树确定目标平台和嵌入方式...