Flutter应用与本地包跨主版本依赖冲突解决方案咨询

场景背景 #

我创建了一个本地包，其pubspec.yaml依赖配置如下：

dependencies:
  flutter:
    sdk: flutter
  webview_flutter: x1.y1.z1  # 示例版本号

该本地包可视为第三方开发包。同时我有一个简单应用，其pubspec.yaml依赖配置如下：

dependencies:
  flutter:
    sdk: flutter
  webview_flutter: x2.y2.z2
  package_name:
    path: PATH_TO_LOCAL_PACKAGE

待解决的两种依赖冲突场景 #

• 本地包依赖的webview_flutter版本高于应用
• 本地包依赖的webview_flutter版本低于应用

报错信息示例 #

Because every version of package_name from path depends on webview_flutter 2.4.0 and resolving_depedencies depends on webview_flutter 2.3.0, package_name from path is forbidden.
So, because resolving_depedencies depends on package_name from path, version solving failed.
pub get failed

（翻译：本地路径的package_name所有版本都依赖webview_flutter 2.4.0，而当前应用resolving_depedencies依赖webview_flutter 2.3.0，因此package_name被禁用。最终因应用依赖该本地包，版本解析失败，pub get执行失败。）

已知局限与需求 #

当主版本号x1和x2相同时，用^语法就能轻松解决冲突，但主版本不同时（比如x1.y1.z1=3.0.0，x2.y2.z2=2.3.0），^语法无效。我知晓dependency_overrides选项，但不想使用该方法，请问还有其他解决方案吗？

解决方案 #

1. 调整依赖版本至兼容范围 #

如果本地包和应用不需要各自依赖版本的专属特性，直接将其中一方的webview_flutter版本改成与另一方一致，或者设置跨主版本的兼容范围（前提是两个主版本间无破坏性API变更，或你的代码能适配）。比如：

• 若本地包能兼容2.x和3.x的webview_flutter，可修改本地包的依赖：

webview_flutter: ">=2.3.0 <4.0.0"

• 若应用无2.x版本的专属依赖，直接将应用的webview_flutter版本改成与本地包一致的3.0.0。

2. 给本地包做版本分支适配 #

如果必须保留不同主版本的依赖，可以给本地包创建两个分支：

• 一个分支依赖webview_flutter 2.x，供使用2.x的应用调用
• 另一个分支依赖3.x，供使用3.x的应用调用
  应用侧根据自身依赖版本，在pubspec.yaml中指定对应分支：

package_name:
  path: PATH_TO_LOCAL_PACKAGE
  ref: webview-v2-compatible  # 指定对应分支名

3. 抽象webview依赖适配层 #

在本地包中封装webview的抽象接口，分别实现针对2.x和3.x版本的适配类，再根据应用引入的webview_flutter版本动态加载对应实现。这种方式适合长期维护多版本兼容的场景，但需要额外的代码开发成本。

4. 升级/降级核心依赖 #

如果其中一方的webview_flutter版本可升级或降级至与另一方主版本一致，直接操作即可。比如应用当前用2.3.0、本地包用3.0.0，若应用无2.3.0的专属功能，直接将应用版本升级到3.x；反之，若本地包可降级到2.x，就调整本地包的依赖版本。

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