flutter 文件与库的引用导出（import、import

前言

dart语言的库及其相关语法是了解dart应用代码组织的基础。网上查找的相关资料往往只是涉及某几个点，很难有系统性的认识，这里笔者将结合一些文档和个人实践经验来对dart的库及其相关语法进行一个梳理。

库的引入

dart中，任意一个文件都会被认为是一个库，尽管其中可能并没有library标签，dart库目前的引入方式大致有三种：

• 引入dart语言的内置库：

import 'dart:math';

引入内置库时，在使用的uri中以dart:开头

• 引入pub包管理器提供库：

import 'package:flutter/material.dart';

在引用包管理器提供的库时，uri中以package开头

• 引入本地文件：

import './tools/network.dart';

引用本地文件时，uri字符串中直接填写文件的相对路径。

指定库的别名

两个库中如果存在相同的标识符，在使用时很有可能会产生冲突；或者在引入一个库的内容的时候，由于当前文件引入的库比较多，导致使用IDE工具提供的标识符名称联想时，很有可能出现一些本不是我们想要选取，但是首字母相近的内容，影响编码效率，为此我们可以使用给库指定别名的方法，来规避以上问题。

import 'package:socket_io_client/socket_io_client.dart' as IO;

class MySocketIO {
  IO.Socket mySocket;
  MySocketIO(this.mySocket);
}

只引入库的部分内容

如果只想引入库的部分内容，可以使用如下语法：

// Import only foo.
import 'package:lib1/lib1.dart' show foo;

如果想屏蔽库中的某些内容，不引入这部分：

// Import all names EXCEPT foo.
import 'package:lib2/lib2.dart' hide foo;

关于part、library和part of

在具体业务中有以下痛点：我们在应用中定义了多个类或者其他方法，在引用时我们想只import一个文件就将相关内容全部导出，如果将所有的类或者方法都放在一个文件中，会导致这个文件十分庞杂，不利于后续维护。为了解决这个问题，我们可以使用part、library和part of来组织我们的代码。
假设我们的存放公共类和方法的文件为为global.dart,其内容可按如下方法组织：

//  定义库的名字
library global;

//  文件中引用的公共包
import 'dart:convert';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:i_chat/tools/utils.dart';
import 'package:shared_preferences/shared_preferences.dart';
import './tools/network.dart';
import 'package:dio/dio.dart';
import 'dart:math';
import 'package:provider/provider.dart';
import 'package:socket_io_client/socket_io_client.dart' as IO;

//  组成这个库的其他文件
part './model/User.dart';
part './model/FriendInfo.dart';
part './model/Message.dart';

//  ...其他业务代码

在文件的开头使用library标识符定义库的名字，这也是其他子文件与其耦合起来的关键，part标识符指明组成这个库的其他文件。需要注意的是，part部分一定要在import部分的后面。
子文件的组织方式如下，以./model/FriendInfo.dart为例：

//  指明与其关联的父库
part of global;

//  定义其他内容
class FriendInfo {
    ...
}

在子文件的开头，使用part of标识符，后跟父库的名字，来指明从属关系，注意子文件中不需要引入父库中已经引入的依赖。
在写其他业务逻辑代码的时候只需要直接引入global.dart文件即可：

import './global.dart';

延迟加载或者异步加载

延迟加载一个库时，要使用deferred as来进行导入：

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

在使用时，需要通用调用loadLibrary()来加载对应的内容

Future greet() async {
  await hello.loadLibrary();
  hello.printGreeting();
}

尽管你可能在项目中多次调用loadLibrary()来加载一个库，但是这个库也只会被加载一次。

编写一个库

库是代码复用和逻辑模块化的绝佳手段。库是以包的形式被创造和分发的。dart语言有两种类型的包：包含本地库的应用包(application packages)和库包(library packages).

• 应用包通常会依赖其他的包，但是绝不会有自引用，应用包的反面就是库包
• 库包是其他包的依赖对象，他们自己也会依赖其他包，亦有可能会自引用，它们中往往含有会直接运行的脚本，库包的反面就是应用包

编写一个库包

下图展示了一个最简单的库包组成结构:

image.png

一个库所需的最简内容包括：

1. pubspec 文件
   pubspec.yaml文件在库包和应用包中是类似的，二者并没有区别。
2. lib 目录
   正如你直觉感觉的那样，库的代码都在lib目录下，这部分内容对其他包也是可见的。如果需要的话，你可以在lib文件夹下创造其他层级的文件，按照惯例，逻辑实现的代码通常放在lib/src目录下。在该目录下的文件通常被认为是私有的。其他的包不应引入src目录下的内容从而暴露lib/scr中的API,正确的使用方法是从lib目录下的其他文件中引出内容。

组织一个库包

当你创建称为迷你库的小型独立库时，库包最容易维护、扩展和测试。在绝大多数情况下，每一个类应该都以一个迷你库的形式存在，除非两个类之间深度耦合。
为了引出一个库中的公共api,建议在lib目录下创建一个'main'文件，方便使用者仅仅通过应用单文件来获取库中的所有功能。lib目录下也有可能包含其他可引入的库。例如，如果你的库可以跨平台工作，但是你创建了两个不同的子文件分别依赖dart:io和datr:html。部分包引用了不同的库，在引用这部分内容时需要给他们添加前缀。 接下来我们观察一个真实的库包：shelf,这个包提供了使用Dart语法创建库的服务器的方法，下图是其的结构：

image.png

在lib目录下的主文件shelf.dart暴露了lib/src下的其他文件中的内容给使用者：

export 'src/cascade.dart';
export 'src/handler.dart';
export 'src/handlers/logger.dart';
export 'src/hijack_exception.dart';
export 'src/middleware.dart';
export 'src/pipeline.dart';
export 'src/request.dart';
export 'src/response.dart';
export 'src/server.dart';
export 'src/server_handler.dart';

shelf包还包括一个迷你库，shelf_io,他对dart:io中的http请求体进行了简单的封装。

引入库文件

当你引用一个库文件的时候，你可以使用package:指令来指定该文件的URI。

import 'package:utilities/utilities.dart';

对于引用的文件和被引，文件当两个文件都在lib内部时，或者当两个文件都在lib外部时，可以使用相对路径导入库。当其中一个文件在lib目录内或者外部时，你必须使用package:。当你举棋不定的时候，可以直接会用package:,这种语法在两种情况下都可用。 下面的图展示了如何分别从lib目录和网络引入lib/foo/a.dart：

image.png

提供其他文件（测试代码、命令行工具）

一个设计良好的库要便于测试。我们推荐你使用test包来编写测试用例，你可以把测试代码放在包的顶级目录中的test文件夹下。
如果你给用户创建了命令行工具，请将它们放在bin文件夹下，以便用户可以直接通过pub global activate命令来使用命令行工具。将命令行工具写在executables section以便用户可以直接调用命令行代码而无需调用pub global run方法.
任何库自己私有的工具函数或代码（你不想暴露给使用者）,你可以将它们放在tool文件夹下。 关于其他你想要的推送到Pub站点的文件，例如README和CHANGELOG等等，你可以在Publishing a Pageage中查阅具体内容。

给库编写注释

你可以使用dartdoc工具来给你的库添加API注释。Dartdoc将会解析你的源码，找到其中通过注释语法标记的内容，标记示例如下：

/// The event handler responsible for updating the badge in the UI.
void updateBadge() {
  ...
}

开源一个库

如果你想要开源一个库，建议你将其分享在Pub site.可以使用pub publish命令来上传或者更新一个库。pub site不仅仅存储你的库，它同时也会自动生成并且保存的你库的api引用文档。
为了确保你的包的API文档生成正确，你可以遵循以下步骤：

• 在你推送你的包之前，运行dartdoc工具确保你的文档生成正确并且展示符合预期
• 在你推送你的包之后，检查Vesion tab去报你的文档生成正确
• 如果文档生成失败，检查dartdoc的输出

总结

• import 'dart:xxx'; 引入Dart标准库
• import 'xxx/xxx.dart';引入绝对路径的Dart文件
• import 'package:xxx/xxx.dart'; 引入Pub仓库pub.dev(或者pub.flutter-io.cn)中的第三方库
• import 'package:project/xxx/xxx.dart';引入自定义的dart文件
• import 'xxx' show compute1，compute2 只导入compute1，compute2
• import 'xxx' hide compute3 除了compute都引入
• import 'xxx' as compute4 将库重命名，当有名字冲突时
• library compute5; 定义库名称
• part of compute6; 表示文件属于某个库

文件导入顺序（从上到下依次）

dart sdk 内的库
flutter内的库
第三方库
自己的库（文件）
相对路径引用
e.g.
import 'dart:io';
import 'package:material/material.dart';
import 'package:dio/dio.dart';
import 'package:project/common/uitls.dart';
import 'xxx/xxx/xxx/xxx.dart';