Flutter - Melos Pub workspaces 实践

欢迎关注微信公众号：FSA全栈行动 👋

一、前言

为解决 App 代码臃肿、编译耗时的问题，我们进行了分包重构，核心思路如下：

1. 业务分包：将不同业务线的代码拆分成独立的包，开发者只需聚焦于各自包内的 example 工程进行开发，从而提升编译和运行效率。
2. 功能沉淀：把跨业务复用的功能（包括基础业务和非业务功能）也抽离成独立的包，逐步让主 App 轻量化为一个“空壳”，负责集成所有模块。
3. 依赖管理：业务包之间使用 git 依赖，指向 master 分支；而非业务的功能包则发布到自建的 unpub 平台，通过版本号管理。

1cache:
2  version: ">=1.0.0 <2.0.0"
3  hosted:
4    url: http://unpub.lxf.dev/
5package_a:
6  git:
7    url: [email protected]:lxf/package_a.git
8    ref: master
9

分包后虽然利于单个工程的独立开发，但一旦涉及跨包联调，就会变得非常低效。

开发者需要手动修改 dependency_overrides 以 path 方式指定本地依赖，在多个 IDE 窗口间切换，并耗费大量时间处理依赖冲突，这在紧张的工期中尤其痛苦。

因此，在官方的 Pub workspaces 方案出现之前，Melos 的出现有效解决了这些痛点。

二、Melos

Melos 是一个管理多个项目的 CLI 工具，只需要在 melos.yaml 中的 packages 下声明各个包，如下所示

1# melos.yaml
2packages:
3  - packages/package_a
4  - packages/package_a/example
5  - packages/package_b
6  - packages/package_b/example
7

执行 melos bs 即可自动在各个包中创建 pubspec_overrides.yaml 并重写必要的包依赖，顺带执行 flutter pub get。

生成的 pubspec_overrides.yaml 内容如下

1# pubspec_overrides.yaml
2# melos_managed_dependency_overrides: package_a ...
3dependency_overrides:
4  # 同步 pubspec.yaml 中的 dependency_overrides
5  scrollview_observer: ^1.26.2
6
7  # 如果只依赖了 package_a，则只重写 package_a 依赖
8  package_a:
9    path: ../../packages/package_a
10

除此之外，它还提供了脚本功能，方便我们在各个包中去并发执行命令，如下所示

1# melos.yaml
2scripts:
3  fluttergen:
4    # 各个包都执行
5    exec: fluttergen
6  pod_install:
7    exec: pod install --project-directory=ios
8    packageFilters:
9      # 只在各个包的 example 中执行
10      scope: "*example"
11  iconfont:
12    exec: sh ./run.sh
13    packageFilters:
14      # 只在 package_a 中执行
15      scope: package_a
16  pub_upgrade:
17    run: flutter pub upgrade
18    exec:
19      # 设置并发数
20      concurrency: 1
21

可配置执行范围，比如只在某个包或各个包的 example 下执行命令；配置执行的并发数等。定义的脚本通过 melos run 去执行，如 melos run iconfont。

还可以做到自动生成 CHANGELOG 和发包到 pub 等，有兴趣的小伙伴可自行到官网了解更多的功能。

尽管 Melos 功能强大，但它仍有两个核心缺陷：

1. 依赖冲突：由于每个包都维护着独立的 pubspec.lock 文件，Melos 无法从根本上保证所有包的依赖版本一致。
2. 内存占用：Dart 分析器会为每个包创建独立的分析上下文，导致了额外的内存开销。

三、Pub workspaces

在 Dart 3.6.0 的时候，官方带来了 Pub workspaces，解决了上述问题，它的优缺点总结如下

优点

缺点

Pub Workspaces 的一个核心原则：整个工作区只有一个统一的依赖解析。

这意味着在工作区的根目录会有一个全局的 pubspec.lock 和一个全局的 .dart_tool/package_config.json 文件，所有工作区内的包都使用这两个文件来管理它们的依赖。

四、迁移优化成效

这是从 Melos 迁移至 Melos + Pub Workspaces 后的提升数据

• 设备：M1 16G
• 方式：集成 37 个包（包含 example）并等待代码分析完成

优化前

优化后

这里说一点，基于 Pub Workspaces 实现的 Monorepo，Melos 并不是必要的，只是它提供的脚本功能和 Hook 实在是太方便了，有助于提升效率，所以建议搭配使用！

下面我们进入实战

五、实战

环境要求

Dart 版本需 >=3.6.0，对应 Flutter 版本需 >=3.27.0

全局安装 Melos

1dart pub global activate melos "7.0.0-dev.8"
2

如果你之前有安装过 Melos，可以先卸载再安装

1dart pub global deactivate melos
2

那为什么要指定 7.0.0-dev.8 这个版本？这是因为我们现在使用的 Flutter 版本是 3.29.3，对应的 Dart 版本是 3.7.2，结合 Melos 的当前部分版本要求，如下所示

所以只能挑个 7.0.0-dev.8 先用用，如果你已经用上了 Flutter 3.35.0，则可使用当前最新正式版 7.1.1。

初始化仓库

创建 workspace 仓库（当然，你也可以基于现有仓库进行改造），名字你随意，这里我以 lxf_workspace 为例。

创建 pubspec.yaml，内容如下

1name: lxf_workspace
2publish_to: none
3
4environment:
5  sdk: ^3.6.0
6dev_dependencies:
7  # 与全局安装的保持一致
8  melos: 7.0.0-dev.8
9
10workspace:
11  - apps/app_a
12  - packages/package_a
13  - packages/package_a/example
14  - packages/package_b
15  - packages/package_b/example
16

从 Dart 3.11 开始支持 globs 语法，可以让 pubspec 更加干净，如下所示

1workspace:
2  - apps/**
3  - packages/**
4

调整所有工程包位置，如壳工程存放至 apps 目录，其它包存放至 packages。

工作区结构

1.
2├── README.md
3├── apps
4│   └── app_a
5├── melos.yaml
6├── packages
7│   ├── package_a
8│   ├── package_b
9│   ├── package_c
10│   └── ...
11├── pubspec.lock
12└── pubspec.yaml
13

调整 pubspec.yaml

lxf_workspace 中涉及到的包（即 workspace 下声明的那些），其 pubspec.yaml 都需要做如下两个调整

• environment.sdk 需 >=3.6.0
• 新增 resolution: workspace

如下所示

1# pubspec.yaml
2environment:
3 sdk: ">=3.6.0 <4.0.0"
4resolution: workspace
5

注意，这些包可以有 dependency_overrides，但不可以同时对同一个包进行重写，否则会冲突！所以建议将这些重写统一放到 lxf_workspace 的 pubspec.yaml中。

启动

执行 melos bs

注意：这里再强调一遍，melos bs 不是应用 Pub Workspaces 的必要流程，使用 Melos 的主要原因是为了使用其脚本功能和 Hook 来提效，如果你不需要这些，也可以直接使用 flutter pub get。

1❯ melos bs
2melos bootstrap
3  └> /Users/lxf/lxf_workspace
4
5Running "flutter pub get" in workspace...
6  > SUCCESS
7
8Generating IntelliJ IDE files...
9  > SUCCESS
10
11 -> 5 packages bootstrapped
12

根据上述的 Pub Workspaces 的核心原则，它会将所有包的 pubspec.lock 都删除，所有包都会新增 .dart_tool/pub/workspace_ref.json 并指向根，即 lxf_workspace 目录。

如果你需要更新依赖，则直接在 lxf_workspace 目录下执行 flutter pub upgrade 即可，这些跟原来的一样。

如果你想重写一些第三方库，可以在 pubspec.yaml 中的 dependency_overrides 进行重写

1# pubspec.yaml
2...
3dependency_overrides:
4  scrollview_observer: ^1.26.2
5  # chat_bottom_container:
6  #   path: packages/chat_bottom_container
7
8workspace:
9  ...
10

在完成这些调整后，后续的开发流程还是跟原先一样，只是现在统一在一个 IDE 窗口中操作罢了，这里就不再赘述。

六、最后

以上便是基于将所有内容（workspace、apps 和 packages）都上传至一个大型仓库，并统一管理的 Monorepo 方案的实践。

而对于想继续多仓库管理工程包的我来说，还需要对该方案进行改造，因为我觉得分久必合，合久必分是迟早的事，再加上我也比较懒～

好了，下一篇来讲讲我的本地 Monorepo 的 "拼好包" 方案和一些优化。

资料

• dart.cn/tools/pub/w…
• melos.invertase.dev/~melos-late…

如果文章对您有所帮助, 请不吝点击关注一下我的微信公众号：FSA全栈行动, 这将是对我最大的激励. 公众号不仅有 iOS 技术，还有 Android，Flutter，Python 等文章, 可能有你想要了解的技能知识点哦~

《Flutter - Melos Pub workspaces 实践》 是转载文章，点击查看原文。