个人博客:
http://www.milovetingting.cn

库和可见性

import 和 library 关键字可以帮助你创建一个模块化和可共享的代码库。代码库不仅只是提供 API 而且还起到了封装的作用：以下划线（_）开头的成员仅在代码库中可见。 每个 Dart 程序都是一个库，即便没有使用关键字 library 指定。

Dart 的库可以使用 包工具 来发布和部署。

如果你对 Dart 为何使用下划线而不使用 public 或 private 作为可访问性关键字，可以查看 SDK issue 33383。

使用库

使用 import 来指定命名空间以便其它库可以访问。

比如你可以导入代码库 dart:html 来使用 Dart Web 中相关 API：

1
import 'dart:html';

import 的唯一参数是用于指定代码库的 URI，对于 Dart 内置的库，使用 dart:xxxxxx 的形式。而对于其它的库，你可以使用一个文件系统路径或者以 package:xxxxxx 的形式。 package:xxxxxx 指定的库通过包管理器（比如 pub 工具）来提供：

1
import 'package:test/test.dart';

URI 代表统一资源标识符。

URL（统一资源定位符）是一种常见的 URI。

指定库前缀

如果你导入的两个代码库有冲突的标识符，你可以为其中一个指定前缀。比如如果 library1 和 library2 都有 Element 类，那么可以这么处理：

1
2
3
4
5
6
7
8
import 'package:lib1/lib1.dart';
import 'package:lib2/lib2.dart' as lib2;

// Uses Element from lib1.
Element element1 = Element();

// Uses Element from lib2.
lib2.Element element2 = lib2.Element();
导入库的一部分

如果你只想使用代码库中的一部分，你可以有选择地导入代码库。例如：

1
2
3
4
5
// Import only foo.
import 'package:lib1/lib1.dart' show foo;

// Import all names EXCEPT foo.
import 'package:lib2/lib2.dart' hide foo;
延迟加载库

延迟加载（也常称为 懒加载）允许应用在需要时再去加载代码库，下面是可能使用到延迟加载的场景：

  • 为了减少应用的初始化时间。
  • 处理 A/B 测试，比如测试各种算法的不同实现。
  • 加载很少会使用到的功能，比如可选的屏幕和对话框。

目前只有 dart compile js 支持延迟加载 Flutter 和 Dart VM目前都不支持延迟加载。你可以查阅 issue #33118 和 issue #27776 获取更多的相关信息。

使用 deferred as 关键字来标识需要延时加载的代码库：

1
import 'package:greetings/hello.dart' deferred as hello;

当实际需要使用到库中 API 时先调用 loadLibrary 函数加载库：

1
2
3
4
Future<void> greet() async {
  await hello.loadLibrary();
  hello.printGreeting();
}

在前面的代码，使用 await 关键字暂停代码执行直到库加载完成。更多关于 async 和 await 的信息请参考异步支持。

loadLibrary 函数可以调用多次也没关系，代码库只会被加载一次。

当你使用延迟加载的时候需要牢记以下几点：

  • 延迟加载的代码库中的常量需要在代码库被加载的时候才会导入，未加载时是不会导入的。
  • 导入文件的时候无法使用延迟加载库中的类型。如果你需要使用类型，则考虑把接口类型转移到另一个库中然后让两个库都分别导入这个接口库。
  • Dart会隐式地将 loadLibrary() 导入到使用了 deferred as *命名空间* 的类中。 loadLibrary() 函数返回的是一个 Future。

实现库

查阅 创建依赖库包 可以获取有关如何实现库包的建议，包括：

  • 如何组织库的源文件。
  • 如何使用 export 命令。
  • 何时使用 part 命令。
  • 何时使用 library 命令。
  • 如何使用导入和导出命令实现多平台的库支持。