Flutter Platform Integration 是一个面向 Flutter 平台集成开发与审查的技能,主要用于实现或检查 Flutter 与各原生平台之间的桥接代码。
用途 该技能服务于需要在 Flutter 与原生代码之间建立边界的场景,包括实现或审查平台通道、Pigeon API、FFI 与构建钩子、原生插件实现、平台视图、add-to-app 边界以及 Web 互操作。其核心原则是:当已有且维护良好的插件能够满足需求时,优先使用现有插件;只有在能力不可用、属于产品特有需求,或需要受控的原生契约时,才编写平台代码。
主要能力
- 边界选择:帮助在多种集成方式之间做出选择。既有跨平台能力使用包 API;多方法通道若受益于编译期结构,使用 Pigeon 或其他带类型的生成契约;小而稳定的请求/响应或事件面使用基础方法/事件通道;适合的 C 兼容原生库和性能敏感调用使用 FFI;仅在必须嵌入原生视图时使用平台视图,并需考虑合成、手势、无障碍和性能。
- 契约设计:要求将领域模型保留在通道契约之外,以兼容方式对消息进行版本化或演进,在边界处校验所有值,并将平台失败映射为可操作的 Dart 错误。
- 参考资料条件加载:在选择现有包、通道或 Pigeon、FFI、JS 互操作和平台视图之间时,读取集成策略;在创建或演进可复用插件包、联邦实现、平台接口或多平台原生 API 时,读取插件开发资料。
- 职责划分:flutter-package-development 负责可复用的公共 API、包形态、兼容性、联邦决策、消费者质量和发布就绪度。当包设计与原生实现都很重要时,两个技能应同时使用。
- 生命周期与平台处理:处理引擎/Activity/视图控制器的附加、后台/前台变化、权限流程、取消以及多引擎实例等情况;为不支持的平台提供明确的行为,而不是等到缺失插件时才崩溃。
- 验证:用伪造对象测试 Dart 适配层,并在每个受支持目标上测试原生实现;验证错误映射、生命周期重新附加、权限、后台行为以及嵌入式视图的无障碍。
使用方式 该技能以技能文档形式提供,使用时按其指引阅读条件加载的参考内容,并遵循其中的边界选择、契约设计、生命周期处理和验证要求。具体安装命令与调用方式暂未提供。
适用场景 适用于 Flutter 应用或插件的平台集成开发与代码审查,尤其是涉及平台通道、Pigeon、FFI、平台视图、add-to-app 以及 Web 互操作的工程任务。
限制 资料未提供具体的收费、价格、支持平台范围或使用步骤细节。需要说明的是,该技能内容以英文原文给出,未提供中文界面或中文文档的说明。