第一步:创建 package
// 执行这个之后,生成的是dart工程,类似jar工程
flutter create --template=package flutter_package
// 可以再次执行这个命令,会生成iOS,Android的支持,以及example
// -i swift 表示iOS使用swift语法, -a java 表示Android使用java语法. 默认使用swift和kotlin语法
flutter create --org com.example --template=plugin --platforms=android,ios -i swift flutter_package
// example里面pubspec.yaml里面使用path: ../ 使用当前本地库,不需要传到pub.dev仓库
path: ../
添加Android中的Manifest中的权限
// 需要在插件pubspec.yaml文件添加以下代码,才能把Android中的Manifest里面的权限添加到example里面
flutter:
plugin:
platforms:
android:
package: com.example.flutter_package
pluginClass: FlutterPackagePlugin
ios:
pluginClass: FLTURLLauncherPlugin
// 第二种简便写法
flutter:
plugin:
androidPackage: com.example.flutter_package
pluginClass: FlutterPackagePlugin
工程结构:
这将在 hello 目录下创建一个 package 项目,其中包含以下内容:
LICENSE 文件
大概率会是空的一个许可证文件。
test/hello_test.dart 文件
Package 的 单元测试 文件。
hello.iml 文件
由 IntelliJ 生成的配置文件。
.gitignore 文件
告诉 Git 系统应该隐藏哪些文件或文件夹的一个隐藏文件。
.metadata 文件
IDE 用来记录某个 Flutter 项目属性的的隐藏文件。
pubspec.yaml 文件
pub 工具需要使用的,包含 package 依赖的 yaml 格式的文件。
README.md 文件
起步文档,用于描述 package。
lib/hello.dart 文件
package 的 Dart 实现代码。
.idea/modules.xml、.idea/modules.xml、.idea/workspace.xml 文件
IntelliJ 的各自配置文件(包含在 .idea 隐藏文件夹下)。
CHANGELOG.md 文件
又一个大概率为空的文档,用于记录 package 的版本变更。
第二步:提交 package
一旦完成了 package 的实现,你便可以将其提交到 pub.dev 上,以便其他开发者可以轻松地使用它。
发布你的 package 之前,确保检查了这几个文件:pubspec.yaml、README.md 和 CHANGELOG.md,确保它们完整且争取,另外,为了提高 package 的可用性,可以考虑加入如下的内容:
- 代码的示例用法
- 屏幕截图,GIF 动画或者视频
- 代码库的正确指向链接
接下来,运行 dry-run 命令以检验是否所有内容都通过了分析:
$ flutter pub publish --dry-run
最后一步是发布,请注意:发布是永久性 的,运行以下提交命令:
$ flutter packages pub publish
设置了中国镜像的开发者们请注意:目前所存在的镜像都不能(也不应该)进行 package 的上传。如果你设置了镜像,执行上述发布代码可能会造成发布失败。网络设定好后,无需取消中文镜像,执行下述代码可直接上传:
$ flutter packages pub publish --server=https://pub.dartlang.org
第三步:解决提交报错
Flutter pub finished with exit code 1
去掉官方指引里面对PUB_HOSTED_URL、FLUTTER_STORAGE_BASE_URL的修改,这些修改会导致上传pub失败。
export http_proxy=http://127.0.0.1:1087;export https_proxy=http://127.0.0.1:1087;
curl ip.sb
把.zshrc文件的Flutter地址注释掉:
# export PUB_HOSTED_URL=https://pub.flutter-io.cn
# export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
tips:
解决冲突
假设你想在你的hello包中使用some_package和other_package,并且这两个包都依赖url_launcher,但是依赖的是url_launcher的不同的版本。 那我们就有潜在的冲突。避免这种情况的最好方法是在指定依赖关系时,程序包作者使用版本范围而不是特定版本。
dependencies: url_launcher: ^0.4.2 # Good, any 0.4.x with x >= 2 will do. image_picker: '0.1.1' # Not so good, only 0.1.1 will do.
如果some_package声明了上面的依赖关系,other_package声明了url_launcher版本像’0.4.5’或’^0.4.0’,pub将能够自动解决问题。 类似的注释适用于插件包对Gradle模块和Cocoa pods的平台特定的依赖关系。
即使some_package和other_package声明了不兼容的url_launcher版本,它仍然可能会和url_launcher以兼容的方式正常工作。 你可以通过向hello包的pubspec.yaml文件中添加依赖性覆盖声明来处理冲突,从而强制使用特定版本:
相关引用:
https://flutter.cn/docs/development/packages-and-plugins/developing-packages
https://flutterchina.club/developing-packages/
https://www.jianshu.com/p/6d479dcc92b4
mac 终端实现外网
https://kerminate.me/2018/10/22/mac-%E7%BB%88%E7%AB%AF%E5%AE%9E%E7%8E%B0%E7%BF%BB%E5%A2%99/
http://locke.ink/post/Mac-Ternimal-Shadowsocks-fanqiang-kexueshangwang/
https://github.com/shadowsocks/ShadowsocksX-NG/releases/tag/v1.9.4