极客时间已完结课程限时免费阅读

18 | 依赖管理（二）：第三方组件库在Flutter中要如何管理？

18 | 依赖管理（二）：第三方组件库在Flutter中要如何管理？-极客时间

18 | 依赖管理（二）：第三方组件库在Flutter中要如何管理？

2019-08-08 陈航 来自北京
《Flutter核心技术与实战》
课程介绍

讲述：陈航

时长10:37大小9.72M

你好，我是陈航。
在上一篇文章中，我与你介绍了 Flutter 工程的资源管理机制。在 Flutter 中，资源采用先声明后使用的机制，在 pubspec.yaml 显式地声明资源路径后，才可以使用。
对于图片，Flutter 基于像素密度，设立不同分辨率的目录分开管理，但只需要在 pubspec.yaml 声明一次；而字体则基于样式支持，除了正常字体，还可以支持粗体、斜体等样式。最后，由于 Flutter 需要原生运行环境，因此对于在其启动之前所需的启动图和图标这两类特殊资源，我们还需要分别去原生工程中进行相应的设置。
其实，除了管理这些资源外，pubspec.yaml 更为重要的作用是管理 Flutter 工程代码的依赖，比如第三方库、Dart 运行环境、Flutter SDK 版本都可以通过它来进行统一管理。所以，pubspec.yaml 与 iOS 中的 Podfile、Android 中的 build.gradle、前端的 package.json 在功能上是类似的。
那么，今天这篇文章，我就主要与你分享，在 Flutter 中如何通过配置文件来管理工程代码依赖。

Pub

Dart 提供了包管理工具 Pub，用来管理代码和资源。从本质上说，包（package）实际上就是一个包含了 pubspec.yaml 文件的目录，其内部可以包含代码、资源、脚本、测试和文档等文件。包中包含了需要被外部依赖的功能抽象，也可以依赖其他包。
与 Android 中的 JCenter/Maven、iOS 中的 CocoaPods、前端中的 npm 库类似，Dart 提供了官方的包仓库 Pub。通过 Pub，我们可以很方便地查找到有用的第三方包。
当然，这并不意味着我们可以简单地拿别人的库来拼凑成一个应用程序。Dart 提供包管理工具 Pub 的真正目的是，让你能够找到真正好用的、经过线上大量验证的库，复用他人的成果来缩短开发周期，提升软件质量。
在 Dart 中，库和应用都属于包。pubspec.yaml 是包的配置文件，包含了包的元数据（比如，包的名称和版本）、运行环境（也就是 Dart SDK 与 Fluter SDK 版本）、外部依赖、内部配置（比如，资源管理）。
在下面的例子中，我们声明了一个 flutter_app_example 的应用配置文件，其版本为 1.0，Dart 运行环境支持 2.1 至 3.0 之间，依赖 flutter 和 cupertino_icon：
name: flutter_app_example #应用名称
description: A new Flutter application. #应用描述
version: 1.0.0
#Dart运行环境区间
environment:
sdk: ">=2.1.0 <3.0.0"
#Flutter依赖库
dependencies:
flutter:
sdk: flutter
cupertino_icons: ">0.1.1"
运行环境和依赖库 cupertino_icons 冒号后面的部分是版本约束信息，由一组空格分隔的版本描述组成，可以支持指定版本、版本号区间，以及任意版本这三种版本约束方式。比如上面的例子中，cupertino_icons 引用了大于 0.1.1 的版本。
需要注意的是，由于元数据与名称使用空格分隔，因此版本号中不能出现空格；同时又由于大于符号“>”也是 YAML 语法中的折叠换行符号，因此在指定版本范围的时候，必须使用引号， 比如">=2.1.0 < 3.0.0"。
对于包，我们通常是指定版本区间，而很少直接指定特定版本，因为包升级变化很频繁，如果有其他的包直接或间接依赖这个包的其他版本时，就会经常发生冲突。
而对于运行环境，如果是团队多人协作的工程，建议将 Dart 与 Flutter 的 SDK 环境写死，统一团队的开发环境，避免因为跨 SDK 版本出现的 API 差异进而导致工程问题。
比如，在上面的示例中，我们可以将 Dart SDK 写死为 2.3.0，Flutter SDK 写死为 1.2.1。
environment:
sdk: 2.3.0
flutter: 1.2.1
基于版本的方式引用第三方包，需要在其 Pub 上进行公开发布，我们可以访问https://pub.dev/来获取可用的第三方包。而对于不对外公开发布，或者目前处于开发调试阶段的包，我们需要设置数据源，使用本地路径或 Git 地址的方式进行包声明。
在下面的例子中，我们分别以路径依赖以及 Git 依赖的方式，声明了 package1 和 package2 这两个包：
dependencies:
package1:
path: ../package1/ #路径依赖
date_format:
git:
url: https://github.com/xxx/package2.git #git依赖
在开发应用时，我们可以不写明具体的版本号，而是以区间的方式声明包的依赖；但对于一个程序而言，其运行时具体引用哪个版本的依赖包必须要确定下来。因此，除了管理第三方依赖，包管理工具 Pub 的另一个职责是，找出一组同时满足每个包版本约束的包版本。包版本一旦确定，接下来就是下载对应版本的包了。
对于 dependencies 中的不同数据源，Dart 会使用不同的方式进行管理，最终会将远端的包全部下载到本地。比如，对于 Git 声明依赖的方式，Pub 会 clone Git 仓库；对于版本号的方式，Pub 则会从 pub.dartlang.org 下载包。如果包还有其他的依赖包，比如 package1 包还依赖 package3 包，Pub 也会一并下载。
然后，在完成了所有依赖包的下载后，Pub 会在应用的根目录下创建.packages 文件，将依赖的包名与系统缓存中的包文件路径进行映射，方便后续维护。
最后，Pub 会自动创建 pubspec.lock 文件。pubspec.lock 文件的作用类似 iOS 的 Podfile.lock 或前端的 package-lock.json 文件，用于记录当前状态下实际安装的各个直接依赖、间接依赖的包的具体来源和版本号。
比较活跃的第三方包的升级通常比较频繁，因此对于多人协作的 Flutter 应用来说，我们需要把 pubspec.lock 文件也一并提交到代码版本管理中，这样团队中的所有人在使用这个应用时安装的所有依赖都是完全一样的，以避免出现库函数找不到或者其他的依赖错误。
除了提供功能和代码维度的依赖之外，包还可以提供资源的依赖。在依赖包中的 pubspec.yaml 文件已经声明了同样资源的情况下，为节省应用程序安装包大小，我们需要复用依赖包中的资源。
在下面的例子中，我们的应用程序依赖了一个名为 package4 的包，而它的目录结构是这样的：
pubspec.yaml
└──assets
├──2.0x
│ └── placeholder.png
└──3.0x
└── placeholder.png
其中，placeholder.png 是可复用资源。因此，在应用程序中，我们可以通过 Image 和 AssetImage 提供的 package 参数，根据设备实际分辨率去加载图像。
Image.asset('assets/placeholder.png', package: 'package4');
AssetImage('assets/placeholder.png', package: 'package4');
例子

例子

接下来，我们通过一个日期格式化的例子，来演示如何使用第三方库。
在 Flutter 中，提供了表达日期的数据结构DateTime，这个类拥有极大的表示范围，可以表达 1970-01-01 UTC 时间后 100,000,000 天内的任意时刻。不过，如果我们想要格式化显示日期和时间，DateTime 并没有提供非常方便的方法，我们不得不自己取出年、月、日、时、分、秒，来定制显示方式。
值得庆幸的是，我们可以通过 date_format 这个第三方包来实现我们的诉求：date_format 提供了若干常用的日期格式化方法，可以很方便地实现格式化日期的功能。
首先，我们在 Pub 上找到 date_format 这个包，确定其使用说明：
图 1 date_format 使用说明
date_format 包最新的版本是 1.0.6，于是接下来我们把 date_format 添加到 pubspec.yaml 中：
dependencies:
date_format: 1.0.6
随后，IDE（Android Studio）监测到了配置文件的改动，提醒我们进行安装包依赖更新。于是，我们点击 Get dependencies，下载 date_format :
图 2 下载安装包依赖
下载完成后，我们就可以在工程中使用 date_format 来进行日期的格式化了：
print(formatDate(DateTime.now(), [mm, '月', dd, '日', hh, ':', n]));
//输出2019年06月30日01:56
print(formatDate(DateTime.now(), [m, '月第', w, '周']));
//输出6月第5周

总结

好了，今天的分享就到这里。我们简单回顾一下今天的内容。
在 Flutter 中，资源与工程代码依赖属于包管理范畴，采用包的配置文件 pubspec.yaml 进行统一管理。
我们可以通过 pubspec.yaml 设置包的元数据（比如，包的名称和版本）、运行环境（比如，Dart SDK 与 Fluter SDK 版本）、外部依赖和内部配置。
对于依赖的指定，可以以区间的方式确定版本兼容范围，也可以指定本地路径、Git、Pub 这三种不同的数据源，包管理工具会找出同时满足每个依赖包版本约束的包版本，然后依次下载，并通过.packages 文件建立下载缓存与包名的映射，最后统一将当前状态下，实际安装的各个包的具体来源和版本号记录至 pubspec.lock 文件。
现代编程语言大都自带第依赖管理机制，其核心功能是为工程中所有直接或间接依赖的代码库找到合适的版本，但这并不容易。就比如前端的依赖管理器 npm 的早期版本，就曾因为不太合理的算法设计，导致计算依赖耗时过长，依赖文件夹也高速膨胀，一度被开发者们戏称为“黑洞”。而 Dart 使用的 Pub 依赖管理机制所采用的PubGrub 算法则解决了这些问题，因此被称为下一代版本依赖解决算法，在 2018 年底被苹果公司吸纳，成为 Swift 所采用的依赖管理器算法。
当然，如果你的工程里的依赖比较多，并且依赖关系比较复杂，即使再优秀的依赖解决算法也需要花费较长的时间才能计算出合适的依赖库版本。如果我们想减少依赖管理器为你寻找代码库依赖版本所耗费的时间，一个简单的做法就是从源头抓起，在 pubspec.yaml 文件中固定那些依赖关系复杂的第三方库们，及它们递归依赖的第三方库的版本号。

思考题

最后，我给你留下两道思考题吧。
pubspec.yaml、.packages 与 pubspec.lock 这三个文件，在包管理中的具体作用是什么？
.packages 与 pubspec.lock 是否需要做代码版本管理呢？为什么？
欢迎你在评论区给我留言分享你的观点，我会在下一篇文章中等待你！感谢你的收听，也欢迎你把这篇文章分享给更多的朋友一起阅读。
分享给需要的人，Ta购买本课程，你将得18元
生成海报并分享

赞 7

提建议

© 版权归极客邦科技所有，未经许可不得传播售卖。 页面已增加防盗追踪，如有侵权极客邦将依法追究其法律责任。
上一篇
17 | 依赖管理（一）：图片、配置和字体在Flutter中怎么用？
下一篇
19 | 用户交互事件该如何响应？
 写留言

精选留言(18)

  • 许童童
    2019-08-08
    pubspec.yaml、.packages 与 pubspec.lock 这三个文件，在包管理中的具体作用是什么？ pubspec.yaml是声明依赖哪些包的配置文件 .packages是表示包在本地目录缓存的地址 pubspec.lock是把依赖锁死的文件 只有pubspec.yaml需要自己编写 其它两个文件会自动生成。 .packages 与 pubspec.lock 是否需要做代码版本管理呢？为什么？ pubspec.lock需要做版本管理，因为lock文件把版本锁定，统一工程环境 .packages不需要版本管理，因为跟本地环境有关，无法做到统一
    展开

    作者回复: 赞

    41
  • 哗啦啦
    2019-08-12
    想问下老师 。我在ROW 中有3个widget ,想实现 3个widget 的高度填充整个ROW （即3个子widget 中高度最大的那个的高度 ） ，请问有什么好办法能实现 ，我更换了交叉轴对齐方式为 CrossAxisAlignment.stretch 也不行 。感谢 卡了很久这个问题

    作者回复: 你是想让Row的高度跟随最高的Widget，其余的Widget高度也调整到跟这个Widget一样是吗？ 试试在外层包一层IntrinsicHeight： Widget build(BuildContext context) { return Scaffold( appBar: AppBar( // Here we take the value from the MyHomePage object that was created by // the App.build method, and use it to set our appbar title. title: Text(S.of(context).main_title), ), body:ListView( children: <Widget>[ IntrinsicHeight( child: Row( children: <Widget>[ Expanded(flex: 1, child: Container(color: Colors.blue,height: 300,)), Container(color: Colors.red,width: 50), Container(color: Colors.yellow,width: 50,height: double.infinity,), ])), Row( children: <Widget>[ Expanded(flex: 1, child: Container(color: Colors.blue,height: 300,)), Container(color: Colors.red,width: 50,height: 100,), Container(color: Colors.yellow,width: 50,height: 100,), ]) ], ) ); }

    共 2 条评论
    11
  • 和小胖
    2019-09-05
    老师请问下，^0.1.2 这个版本号中的 ^ 是什么意思呢？

    作者回复: ^version表示向后兼容的一个版本范围。比如，^1.2.3相当于'>=1.2.3<2.0.0'，^0.1.2相当于'>=0.1.2<0.2.0'。

    共 3 条评论
    6
  • 和小胖
    2019-09-05
    1、pubspec.yaml 算是对 flutter 项目配置的管理，类似于 Android 中的 gradle，这些配置包括：项目名称(但是如果桌面的应用名称还得去具体平台的项目里面修改)、项目描述 、各种资源(资源包括图片、文件、字体等)，图片文件等资源需要在 yaml 文件中的 assets 标签下配置，字体需要在 fonts 标签下配置； 当然也有项目依赖 dart sdk 的版本配置，项目所依赖的第三方库的配置，而这些第三方库可以是远程 pub 仓库(类似于 jcenter/maven)，也可以是 git 仓库，还可以是 本地的依赖库。 .packages 文件里面配置了远程依赖库下载到本地的路径，是一种映射关系。 pubspec.lock 文件里面则是配置了远程依赖库的具体信息，包括依赖库名称、版本号以及依赖地址。里面也有 dart sdk 的版本号。 2、.packages 是不需要版本管理，也不需要提交至远程仓库，应当对它添加忽略，因为它是与本地的映射，每个人的本地目录是不同的；pubspec.lock 则是需要版本管理的，因为他里面记录了具体的依赖信息。
    展开

    作者回复: 太赞了👍

    5
  • 汪帅
    2019-08-08
    我一直比较关心的还是关于第三方官方库支持情况，例如地图，即时通讯，音视频等等！安卓我倒是可以解决就是iOS我不会还是需要纯flutter的

    作者回复: 音视频这类插件已经有比较丰富的第三方插件支持了，Pub上有很多，你可以选一个Star和评分相对高些的，像声网这样专业的音视频公司也有专门的SDK做Flutter音视频通信； 地图插件大都基于Google Map，可以耐心等待国内的地图厂商提供Flutter插件版本； 即时通讯目前没有特别好的Flutter插件，建议可以通过混合开发的方式把IM能力融合到Flutter应用中。 即时通讯

    共 3 条评论
    3
  • 巫山老妖
    2019-10-06
    思考题1 ： - pubspec.yaml（设置包的元数据（比如，包的名称和版本）、运行环境（比如Dart SDK与Flutter SDK版本）、外部依赖和内部配置） - .packages（将依赖包名与系统缓存中的包文件路径进行映射，方便后续维护） - pubspec.lock（用于记录当前状态下实际安装的各个直接依赖、间接依赖的包的具体来源和版本号） 思考题2： .package文件不用托管，因为这个文件是自动生成的，存储的是包映射的是本地路径，不同开发环境路径不一样。 pubspec.lock需要托管，每次变更版本都会更新这个文件，我们也能知道实际安装版本。
    展开

    作者回复: 非常棒👍

    1
  • davidzhou
    2019-08-08
    只是不太明白image.asset使用的是一个完整的uri，如果项目内图片资源比较多，我希望图片资源进行目录分类，那个路径就相对较长，如果是iOS的话，统一在一个地方创建xx.imageset就可以直接使用这个图片标识符了

    作者回复: 如果你的资源目录层次比较清晰，资源比较多，可以在外部再包一层，简化调用参数

    共 3 条评论
    2
  • 无名
    2020-12-04
    最近看到这样的： dev_dependencies: build_runner: build_runner冒号后面不带任何版本信息，这样是否表示取库的最新版本？
    展开
  • outman
    2020-05-21
    请教个混合开发遇到的问题，资源，比如图片，文字，或尺寸，这些在app中都是通用的。那么flutter和android，ios能共用一个资源库吗？
  • 鸡蛋石头
    2020-03-21
    能使用iconfont吗？怎么使用？
  • 颜为晨
    2020-02-02
    Git 依赖的例子中，package2 写成了 date_format
  • 杨闯
    2020-01-08
    对于包管理，如果我所需要的包是git仓库的，但是如果同事在git仓库的同一分支下进行修改，可能会出现不更新包的问题，这个有什么解决方案吗？
    共 2 条评论
  • 杨闯
    2020-01-08
    如果写死flutter的版本，但是和本地安装的sdk版本不一致的话，是不是就不能正常打包了，如果不能正常打包的话，是不是就要强制开发者修改本地SDK的版本号啊
  • 毛哥来了
    2019-10-25
    是否跟package.json一样也支持 ~1.2.3 这样的格式

    作者回复: 不支持，只能用^

  • Carlo
    2019-10-14
    依赖管理中的版本冲突很麻烦。pub每个包只下载一个版本。这就造成了如果第三方库很旧，依赖了A包很老的版本。如果我在自己的工程中用了A包最新版本。那就会造成冲突。请问这种情况怎么解决？

    作者回复: 把所有依赖（及其递归依赖）及版本号展开都写到pubspec文件中就可以了

  • kkliu
    2019-09-29
    pubspec.yaml设定引用第三方SDK的版本范围，如果要指定对应版本可以直接在pubspec.lock 文件里指定sdk的版本号？

    作者回复: 无论什么时候需要指定版本都是直接改pubspec.yaml，然后重新安装。pubspec.lock文件是Pub包管理器根据依赖关系图自动生成的，不能自己手动改。

  • andy
    2019-09-05
    随着课程的节数增加，每节课的评论人数越来越少了，是不是好多放弃的

    编辑回复: 慢慢会追上来的~

    共 3 条评论
  • Yolo七夜
    2019-08-13
    学到了，环境相关的sdk最好统一，其他依赖的第三方库最好放开