滴滴开源新项目Unify：聚焦Flutter与原生通信难题，助力跨端应用落地

引言

在移动开发领域，移动跨端技术因其提效收益，逐渐成为业界趋势之一。Flutter 作为近年来热门的跨端技术，以高性能、自渲染、泛跨端著称，得到广泛应用。在滴滴国际化业务中，我们大量应用 Flutter。目前已在滴滴国际化外卖、滴滴国际化出行司机端等业务中大规模落地，整体交付提效 50%+，收益显著。在大规模 Flutter 跨端场景下，存量的原生业务与增量 Flutter 业务间的双向通信成为痛点问题。

为此，滴滴国际化外卖自研 Unify 框架，旨在解决大规模跨端落地场景下，Flutter 与原生模块之间的通信问题。Unify 通过平台无关的模块抽象、灵活的实现注入、自动代码生成等特性，为开发者提供高效、灵活、易用的 Flutter 混合通信能力。

基于 Unify，滴滴国际化外卖成功将 16+ 个原生平台能力，26+ 个原生业务能力高效导入 Flutter，并沉淀出 UniFoundation、UniBusiness 两套业务架构模式，有效支撑外卖业务从零到一实现 Flutter 跨端落地。同时，Unify 也在滴滴国际化出行司机端中推广落地，有效支撑了兄弟业务的大规模跨端落地。

目前，Unify 已作为滴滴开源项目，正式开源，欢迎大家试用、体验、star 支持！

背景

在跨端落地过程中，通常会保留原生实现，以迭代方式逐步试水跨端，先跑通模式，再逐渐扩大跨端落地规模。

在原生代码与 Flutter 代码并存前提下，面临一系列实际问题：

1. 大量原生 SDK 如何高效导入 Flutter?

2. 大量业务功能如何高效导入 Flutter？

3. Flutter 功能模块如何导出给原生？

此类 Flutter 与原生代码间的双向通信问题，我们统称为混合通信问题。

针对这一问题，Flutter 官方提供了 Channel 通信方案，但在大规模落地场景下，该方案存在一系列不足：

1. 手动解析参数引发异常：使用 Channel 需要手动解析调用参数，极易出错。当接口发生变化时，需重新适配也极易引入 Bug。该问题在线上经常出现，并且难以根治。

1. 大规模导出难以维护：在大规模能力导出场景下，需要编写大量分支语句和硬编码，难以维护。

2. 代码封装繁琐：Channel API 较为底层，开发者还需二次封装，才能提供给业务方便调用，这一过程较为繁琐。

除 Channel 外，Pigeon 是一个更加强大的解决方案。Pigeon 由 Google 推出，该方案基于代码生成技术，有效提升了工程质量，降低了接入成本。但通过实际使用，我们发现在大规模模块导出场景下，Pigeon 的开发效率还有进一步提升的空间。

基于这一背景，Unify 通过批量接口声明、批量模块生成，简化了工程复杂度，进一步提升了开发效率。同时，Unify 也逐渐演化出自身特色，比如更加符合开发者习惯的多工程文件组织方式。

Unify 介绍

Unify 由滴滴出行国际化外卖团队自研，目前已经广泛应用于滴滴国际化外卖及国际化出行业务，有力支撑了业务的 Flutter 化进程。

Unify 的亮点特性包括：

• 平台无关的模块抽象: 允许开发者使用 Dart 语言声明与平台无关的模块接口与实体。

• 灵活的实现注入: 开发者可以灵活地选择注入原生实现（Android/iOS）或 Flutter 实现。

• 自动代码生成: 借助强大的代码生成引擎，Unify 可以自动生成 Flutter、Android、iOS 多平台下统一调用的 SDK。

下面是一个使用 Unify 声明原生模块的示例：

@UniNativeModule()
abstract class DeviceInfoService {
  Future<DeviceInfoModel> getDeviceInfo();
}

通过 Unify，上面的 Dart 接口可以自动映射到 Android、iOS、Flutter 平台，开发者只需在各平台下填入具体实现即可。在 Flutter 中使用时，调用方式就像普通的 Flutter 模块一样简单、直观：

DeviceInfoService.getDeviceInfo().then((deviceInfoModel) {
  print("${deviceInfoModel.encode()}");
});

Unify 的整体架构如下：

Unify 核心概念

在进行混合通信开发时，典型场景包括：

• 将原生模块导出至 Flutter 调用

• 将 Flutter 模块导出至原生调用

• 在接口中传递复杂实体类

在 Unify 中定义了一系列核心概念，能够高效满足上述场景。以上场景分别对应于 UniNativeModule、UniFlutterModule、UniModel。

在具体使用时，开发者首先声明模块接口，接口声明使用 Dart 语言&#x