如何为Dart跨平台包配置不同平台的专属Dart依赖库？

核心思路 #

通过pubspec平台特定依赖 + Dart条件导入实现：Android/iOS加载package X，Web加载自研库，业务层完全依赖统一抽象接口，无需关心底层实现。

步骤1：配置pubspec.yaml的平台依赖 #

在pubspec.yaml中为package X和自研库指定支持的平台，确保Web端不会拉取不兼容的package X：

dependencies:
  # 仅Android/iOS引入package X
  package_x:
    version: ^x.y.z # 替换为实际版本
    platforms:
      android:
      ios:

  # 仅Web引入自研库（本地包用path指定路径，pub包直接写版本）
  my_web_lib:
    path: ./packages/my_web_lib # 替换为自研库的路径或pub地址
    platforms:
      web:

步骤2：创建统一抽象接口 #

定义一个抽象类，封装所有需要的业务方法，确保移动端和Web的实现都遵循同一标准：

// lib/services/my_service.dart
abstract class MyService {
  /// 示例方法：执行核心业务逻辑
  Future<void> executeCoreFunction();

  /// 示例属性：获取业务数据
  String get businessData;

  // 工厂方法，动态返回对应平台的实现
  factory MyService() => _createService();
}

步骤3：编写各平台的具体实现 #

分别基于package X和自研库实现抽象接口：

移动端实现（Android/iOS） #

// lib/services/src/my_service_mobile.dart
import 'package:package_x/package_x.dart';
import '../../my_service.dart';

class MyServiceMobile implements MyService {
  final PackageXClient _client = PackageXClient();

  @override
  Future<void> executeCoreFunction() async {
    // 调用package X的完整功能
    await _client.fullFeatureMethod();
  }

  @override
  String get businessData => _client.fullFeatureData;
}

Web端实现 #

// lib/services/src/my_service_web.dart
import 'package:my_web_lib/my_web_lib.dart';
import '../../my_service.dart';

class MyServiceWeb implements MyService {
  final MyWebLibClient _client = MyWebLibClient();

  @override
  Future<void> executeCoreFunction() async {
    // 调用自研库的兼容功能
    await _client.partialFeatureMethod();
  }

  @override
  String get businessData => _client.partialFeatureData;
}

步骤4：通过条件导入绑定平台实现 #

在抽象接口文件中，利用Dart的平台条件导入，自动为不同平台选择对应的实现：

// lib/services/my_service.dart
abstract class MyService {
  Future<void> executeCoreFunction();
  String get businessData;

  factory MyService() => _createService();
}

// 根据平台条件导入对应实现
import 'src/my_service_mobile.dart' as mobile if (dart.library.html) 'src/my_service_web.dart' as web;

MyService _createService() {
  // 移动端返回package X实现，Web返回自研库实现
  if (mobile.MyServiceMobile != null) {
    return mobile.MyServiceMobile();
  } else {
    return web.MyServiceWeb();
  }
}

步骤5：业务层调用 #

在项目的业务代码中，直接依赖抽象接口即可，无需关心底层是package X还是自研库：

import 'package:your_package/services/my_service.dart';

void main() async {
  final service = MyService();
  await service.executeCoreFunction();
  print(service.businessData);
}

注意事项 #

• 确保Dart版本≥2.12，platforms字段和条件导入需要该版本支持；
• 如果package X和自研库的返回类型/参数不一致，需在抽象层定义统一的模型类，在实现类中做类型转换；
• 测试时分别在Android/iOS/Web环境下验证，确保各自的实现逻辑正常运行。

内容的提问来源于stack exchange，提问作者JohnH