第一步:創建 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/
http://www.lxweimin.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