标签:lib package api Library dart part student 手写
目录简介
Library是dart用来组织代码的一种非常有用的方式,通过定义不同的Library,可以将非常有用的dart代码进行封装,从而提供给其他的项目使用。虽然我们可以自由使用import或者export来对library进行导入和导入。但是什么样的用法才是最合适的用法呢? 一起来看看吧。
使用part和part of
虽然很多程序员讨厌使用part,但是dart确实提供了part这种功能用来将一个大的lib拆分成多个小的文件。
没错,和part的中文含义一样,part就是将lib文件进行拆分用的。
part of表示当前文件是另外一个主文件的一部分。part表示主文件是由引用的文件组成的。
我们举个例子,假如现在有三个文件student_age.dart,student_name.dart和student.dart.
其中前面两个文件是后面一个文件的组成部分。
student_age.dart:
part of student;
int getAge(){
return 18;
}
student_name.dart:
part of student;
String getName(){
return "jack";
}
student.dart:
library student;
part 'some/other/student_age.dart';
part 'some/other/student_name.dart';
上面的代码有什么问题呢?
上面代码的问题在于对于student_age.dart来说,里面的part of只是指定了所属的library,但是我们读起来会一头雾水,因为不知道具体的library到底在什么地方。
所以应该这样写:
part of '../../student.dart';
src中的文件
默认情况下lib目录下的src文件只是package内部使用的,不允许被外部的项目所调用。
所以我们一定不要直接引入lib包中的src文件。
package中的lib文件
对于package来说,lib中的文件是可以被导出的文件,但是我们在引入package的时候最好不要使用绝对路径或者相对路径直接导入lib中的文件。
而是需要使用import 'package:'.
举个例子,假如我们有下面结构的library文件:
my_package
└─ lib
└─ api.dart
test
└─ api_test.dart
api.dart就是我们要导出的文件。如果我们在api_test.dart中需要引用api.dart,则可以有下面两种方式:
import 'package:my_package/api.dart';
和:
import '../lib/api.dart';
其中上面一种方式是官方推荐的方式,为什么不使用下面一种方式呢?这是因为相对路径的方式只能在包内部使用。并且dart官方不建议将lib放在引用路径中,如果要引用lib内部的文件, 一定要使用package:。
当然,如果是package内部的引用,则优先使用相对路径,比如:
my_package
└─ lib
├─ src
│ └─ stuff.dart
│ └─ utils.dart
└─ api.dart
test
│─ api_test.dart
└─ test_utils.dart
那么对应lib/api.dart来说,可以这样引用:
import 'src/stuff.dart';
import 'src/utils.dart';
对于utils.dart来说,可以这样引用:
import '../api.dart';
import 'stuff.dart';
对于test/api_test.dart来说,可以这样引用:
import 'package:my_package/api.dart';
import 'test_utils.dart';
总之,不要在import的路径中出现lib。
总结
以上就是dart中Library编写最佳实践。
本文已收录于 http://www.flydean.com/28-dart-libraries-effective/
最通俗的解读,最深刻的干货,最简洁的教程,众多你不知道的小技巧等你来发现!
欢迎关注我的公众号:「程序那些事」,懂技术,更懂你!
标签:lib,package,api,Library,dart,part,student,手写 来源: https://www.cnblogs.com/flydean/p/15783392.html
本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享; 2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关; 3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关; 4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除; 5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。