flutter-platform-integration

Flutter 平台集成

如果现有维护中的插件能满足需求，优先使用它。只有当相应能力不可用、具有产品特定性，或需要受控的原生契约时，才编写平台代码。

如果有人要求将项目已在使用且足以满足需求的插件替换为自定义原生代码，先不要编写原生代码。说明现有插件已经涵盖的功能，询问它无法满足哪项具体要求（缺少 API、平台、行为、许可证或体积），并建议在明确这一差距前继续使用现有插件。确认确实存在差距后，用最小改动弥补：Dart 封装、上游修复，或仅针对缺失部分的精简通道。

选择边界

• 对成熟的跨平台能力，使用 package API。
• 当多方法通道需要编译时结构时，使用 Pigeon 或其他类型化生成契约。
• 对小型、稳定的请求/响应或事件接口，使用基本方法通道/事件通道。
• 对适用的原生 C 兼容库和对性能敏感的调用，使用 FFI。
• 仅在需要嵌入原生视图时使用平台视图，并考虑合成、手势、无障碍功能和性能。

将领域模型保留在通道契约之外。以兼容方式对消息进行版本管理或演进，在边界处验证所有值，并将平台故障映射为可采取措施的 Dart 错误。

按需加载参考资料

• 在选择现有 package、通道或 Pigeon、FFI、JS 互操作和平台视图时，阅读 集成策略。
• 在创建或演进可复用插件 package、联合实现、平台接口或多平台原生 API 时，阅读 插件开发。

flutter-package-development 负责可复用的公共 API、package 结构、兼容性、联合实现决策、使用方体验和发布准备。当 package 设计和原生实现都很重要时，同时使用这两项技能。

生命周期与平台

在适用情况下，处理引擎/Activity/视图控制器的挂接、后台/前台切换、权限流程、取消操作以及多个引擎实例。明确提供不受支持的平台上的行为，避免因缺少插件而在后期崩溃。

验证

使用 fake 测试 Dart 适配器，并在每个受支持的目标平台上测试原生实现。验证错误映射、生命周期重新挂接、权限、后台行为，以及嵌入视图的无障碍功能。

来源

• Flutter 平台集成
• 平台通道
• 使用 FFI 绑定原生代码
• 开发 package 和插件