返回首页 Dart 语言概览

库和可见性

import,part,library指令可以帮助创建一个模块化的,可共享的代码库。库不仅提供了API,还提供隐私单元:以下划线(_)开头的标识符只对内部库可见。每个Dartapp就是一个库,即使它不使用库指令。

库可以分布式使用包。见 Pub Package and Asset Manager 中有关pub(SDK中的一个包管理器)。

使用库

使用 import 来指定如何从一个库命名空间用于其他库的范围。

例如,Dart Web应用一般采用这个库 dart:html,可以这样导入:

import 'dart:html';

唯一需要 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';

注:URI代表统一资源标识符。网址(统一资源定位器)是一种常见的URI的。

指定库前缀

如果导入两个库是有冲突的标识符,那么你可以指定一个或两个库的前缀。例如,如果 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测试-尝试的算法的替代实施方式中;
  • 加载很少使用的功能,例如可选的屏幕和对话框。

警告:延迟加载是先在1.6实现的新功能。如果你使用它,你发现任何执行问题,请让我们知道

为了延迟加载一个库,你必须使用 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 来来命名库,用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...

重新导出库(Re-exporting libraries)

可以通过重新导出部分库或者全部库来组合或重新打包库。例如,你可能有实现为一组较小的库集成为一个较大库。或者你可以创建一个库,提供了从另一个库方法的子集。

// 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
}
上一篇: 泛型 下一篇: 异步的支持