Flutter项目：如何按平台编译代码解决Android打包dart.html报错

针对你的项目在编译Android APK时出现dart.html相关报错的问题，核心解决思路是通过平台条件编译/导入，让Android编译时忽略Web专属代码，具体实现方式如下：

1. 条件导入（推荐用于隔离Web专属逻辑） #

将Web专属代码与移动端代码拆分为不同文件，通过Dart的条件导入机制，让编译器根据目标平台选择对应实现：

• 第一步：定义通用接口文件（如platform_service.dart）

  abstract class PlatformService {
    void init();
    // 定义需要跨平台实现的方法
  }
  

• 第二步：创建Web端实现文件（如platform_service_web.dart）

  import 'dart:html';
  import 'platform_service.dart';
  
  class WebPlatformService implements PlatformService {
    @override
    void init() {
      // 这里写Web专属逻辑，比如操作dart.html的API
      window.addEventListener('resize', (event) {
        // 处理窗口缩放
      });
    }
  }
  
  final PlatformService platformService = WebPlatformService();
  

• 第三步：创建移动端实现文件（如platform_service_mobile.dart）

  import 'platform_service.dart';
  
  class MobilePlatformService implements PlatformService {
    @override
    void init() {
      // Android/iOS端的替代逻辑，空实现或对应功能
    }
  }
  
  final PlatformService platformService = MobilePlatformService();
  

• 第四步：在业务代码中条件导入

  import 'platform_service.dart';
  // 编译时自动根据平台选择导入文件
  import 'platform_service_mobile.dart' 
      if (dart.library.html) 'platform_service_web.dart' as platform_impl;
  
  void main() {
    platform_impl.platformService.init();
    // 其他业务逻辑
  }
  

2. 平台条件判断（适用于零散的Web专属代码） #

如果只是少量Web专属代码，可以通过kIsWeb常量判断平台，避免移动端编译到Web代码：

• 先导入依赖：

  import 'package:flutter/foundation.dart';
  

• 包裹Web专属代码：

  void someFunction() {
    if (kIsWeb) {
      // 仅Web端执行的代码，比如dart.html调用
      import 'dart:html' as html;
      html.window.open('https://example.com', '_blank');
    } else {
      // Android端对应的逻辑
      // 比如打开系统浏览器
    }
  }
  

注意：如果代码中直接全局导入dart:html，即使在条件分支里，Android编译仍会报错。这种情况必须用条件导入拆分文件，而不是仅用条件判断。

3. 隔离Web专属依赖 #

如果项目中使用了Web专属的第三方包，需要在pubspec.yaml中限定依赖仅对Web平台生效：

dependencies:
  flutter:
    sdk: flutter

# 仅Web平台生效的依赖
web:
  dependencies:
    some_web_only_package: ^1.0.0

完成以上配置后，执行flutter build apk --release时，编译器会自动排除Web专属代码和依赖，避免dart.html相关报错。

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