Flutter/Dart构建过程中如何下载外部大型二进制依赖？

方案一：构建阶段自动下载大文件（推荐） #

可以在Dart/Flutter的依赖拉取或构建流程中，通过自定义脚本自动从私有存储（公司内部服务器、云存储）下载OpenCV二进制文件，只需在库中配置一次，消费者无需额外操作：

1. 编写下载脚本
   在库的根目录创建download_opencv.dart脚本，实现以下逻辑：

   • 识别当前运行的平台（Android/iOS/Windows/macOS等）和架构
   • 从自定义存储地址拉取对应版本的OpenCV二进制文件
   • 校验文件哈希值（比如MD5/SHA256），确保文件未损坏
   • 将文件保存到库的指定目录（比如lib/internal/opencv/，注意添加到.gitignore避免提交到GitHub）

2. 绑定到pub流程
   利用Dart 2.17+支持的pubspec.yaml脚本功能，在依赖拉取完成后自动执行下载：

scripts:
  post_get: dart run download_opencv.dart

这样消费者执行flutter pub get或dart pub get时，会自动触发下载逻辑，无需手动操作。

如果需要更灵活的构建触发（比如和代码生成工具同步），可以基于build_runner编写自定义Builder，在构建阶段执行下载逻辑，确保二进制文件在代码编译前准备就绪。

方案二：拆分平台专属依赖 #

将不同平台的OpenCV二进制文件拆分为独立的Dart包（比如opencv_android、opencv_ios），主库通过条件依赖引入对应平台的包：

dependencies:
  opencv_android:
    git:
      url: https://github.com/your-org/opencv_android.git
      ref: v1.0.0
    condition: flutter_platform == android
  opencv_ios:
    git:
      url: https://github.com/your-org/opencv_ios.git
      ref: v1.0.0
    condition: flutter_platform == ios

每个平台包中仅存放对应平台的二进制文件，单个文件体积如果能控制在100MB以内，就可以直接提交到GitHub；如果还是超，可在平台包中同样使用方案一的下载逻辑。

方案三：临时Git LFS兼容方案 #

虽然pub暂不支持Git LFS，但可以要求库的消费者在拉取依赖前手动安装Git LFS并拉取大文件：

• 在库仓库中用Git LFS管理OpenCV二进制文件，添加.gitattributes配置
• 在库的README中说明：消费者需要先运行git lfs install和git lfs pull才能获取完整依赖
  不过这个方案需要消费者额外操作，不符合“无需重复编写代码”的目标，仅作为临时过渡方案。

注意事项 #

• 下载脚本要处理缓存逻辑，避免每次pub get重复下载，可通过对比本地文件哈希和远程哈希值实现
• 确保自定义存储地址的稳定性和访问权限，避免消费者无法下载文件
• 在库的.gitignore中排除下载后的二进制文件目录，防止误提交到GitHub

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