import
,part
,library
指令可以帮助创建一个模块化的,可共享的代码库。库不仅提供了API,还提供隐私单元:以下划线_
开头的标识符只对内部库可见。每个Dartapp就是一个库,即使它不使用库指令。
- 库可以分布式使用包。
- 使用库
使用
import
来指定如何从一个库命名空间用于其他库的范围。-
唯一需要
import
的参数是一个指向库的 URI。对于内置库,URI中具有特殊dart:scheme
。对于其他库,你可以使用文件系统路径或package:scheme
。包package:scheme specifies libraries
,如pub工具提供的软件包管理器库。例如:import 'dart:io'; import 'package:mylib/mylib.dart'; import 'package:utils/utils.dart';
- 指定库前缀
-
如果导入两个库是有冲突的标识符,那么你可以指定一个或两个库的前缀。例如,如果 library1 和 library2 都有一个元素类,那么你可能有这样的代码:
import 'package:lib1/lib1.dart'; import 'package:lib2/lib2.dart' as lib2; // ... var element1 = new Element(); // 使用lib1里的元素 var element2 = new lib2.Element(); // 使用lib2里的元素
- 导入部分库
- 如果想使用的库一部分,你可以选择性导入库。例如:
// 只导入foo库 import 'package:lib1/lib1.dart' show foo; //导入所有除了foo import 'package:lib2/lib2.dart' hide foo;
- 延迟加载库
-
延迟(deferred)加载(也称为延迟(lazy)加载)允许应用程序按需加载库。下面是当你可能会使用延迟加载某些情况:
- 为了减少应用程序的初始启动时间;
- 执行A / B测试-尝试的算法的替代实施方式中;
- 加载很少使用的功能,例如可选的屏幕和对话框。
-
为了延迟加载一个库,你必须使用 deferred as 先导入它。
import 'package:deferred/hello.dart' deferred as hello;
-
当需要库时,使用该库的调用标识符调用
LoadLibrary()
。greet() async { await hello.loadLibrary(); hello.printGreeting(); }
在前面的代码,在库加载好之前,
await
关键字都是暂停执行的。有关async
和await
见asynchrony support
的更多信息。您可以在一个库调用
LoadLibrary()
多次都没有问题。该库也只被加载一次。-
当您使用延迟加载,请记住以下内容:
- 延迟库的常量在其作为导入文件时不是常量。记住,这些常量不存在,直到迟库被加载完成。
- 你不能在导入文件中使用延迟库常量的类型。相反,考虑将接口类型移到同时由延迟库和导入文件导入的库。
- Dart隐含调用
LoadLibrary()
插入到定义deferred as namespace
。在调用LoadLibrary()
函数返回一个Future
。
- library
- 用
library
来来命名库,用part
来指定库中的其他文件。 注意:不必在应用程序中(具有顶级main()
函数的文件)使用library
,但这样做可以让你在多个文件中执行应用程序。
- 声明库
- 利用library identifier(库标识符)指定当前库的名称:
// 声明库,名ballgame library ballgame; // 导入html库 import 'dart:html'; // ...代码从这里开始...
- 库的拆分
添加实现文件,把
part fileUri
放在有库的文件,其中fileURI
是实现文件的路径。然后在实现文件中,添加部分标识符part of identifier
,其中标识符是库的名称。下面的示例使用的一部分,在三个文件来实现部分库。-
第一个文件,ballgame.dart,声明球赛库,导入其他需要的库,并指定ball.dart和util.dart是此库的部分:
library ballgame; import 'dart:html'; // ...其他导入在这里... part 'ball.dart'; part 'util.dart'; // ...代码从这里开始...
-
第二个文件ball.dart,实现了球赛库的一部分:
part of ballgame; // ...代码从这里开始...
-
第三个文件,util.dart,实现了球赛库的其余部分:
part of ballgame; // ...Code goes here...
- export
- 可以通过重新导出部分库或者全部库来组合或重新打包库。例如,你可能有实现为一组较小的库集成为一个较大库。或者你可以创建一个库,提供了从另一个库方法的子集。
// In french.dart: library french; hello() => print('Bonjour!'); goodbye() => print('Au Revoir!'); // In togo.dart: library togo; import 'french.dart'; export 'french.dart' show hello; // In another .dart file: import 'togo.dart'; void main() { hello(); //print bonjour goodbye(); //FAIL }