發(fā)布Flutter packages到pub.dev

1. 創(chuàng)建packages

flutter create --template=package flutter_easy_use_tools

2. 實(shí)現(xiàn)功能

lib下創(chuàng)建src文件夾，src文件下的文件是不對(duì)外開放的，開放則通過flutter_easy_use_tools.dart來對(duì)外開放。

library flutter_easy_use_tools;

export 'src/extension/string_extension.dart';
export 'src/utils/num_util.dart';
export 'src/utils/string_util.dart';
export 'src/widgets/custom_inner_shadow.dart';
image.png
3. 檢查pubspec.yaml 
name: flutter_easy_use_tools
description: A new Flutter project.
version: 0.0.1
homepage: https://github.com/yuanzhiying/flutter_easy_use_tools
4. 驗(yàn)證packages

$ flutter packages pub publish --dry-run

$ flutter packages pub publish --dry-run
Publishing flutter_easy_use_tools 0.0.1 to https://pub.flutter-io.cn:
|-- .gitignore
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- lib
|   |-- extension
|   |   '-- string_extension.dart
|   |-- flutter_easy_use_tools.dart
|   '-- widgets
|       '-- custom_inner_shadow.dart
|-- pubspec.yaml
'-- test
    '-- flutter_easy_use_tools_test.dart

Package has 0 warnings.

5. 發(fā)布packages

執(zhí)行flutter packages pub publish，點(diǎn)擊其中鏈接瀏覽器打開授權(quán)，需要登錄谷歌賬號(hào)。

先用命令測(cè)試能否訪問谷歌：$ curl www.google.com

$ flutter packages pub publish
Publishing flutter_easy_use_tools 0.0.1 to https://pub.flutter-io.cn:
|-- .gitignore
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- lib
|   |-- extension
|   |   '-- string_extension.dart
|   |-- flutter_easy_use_tools.dart
|   '-- widgets
|       '-- custom_inner_shadow.dart
|-- pubspec.yaml
'-- test
    '-- flutter_easy_use_tools_test.dart

Publishing is forever; packages cannot be unpublished.
Policy details are available at https://pub.dev/policy

Do you want to publish flutter_easy_use_tools 0.0.1 (y/N)? y
Pub needs your authorization to upload packages on your behalf.
In a web browser, go to https://accounts.google.com/o/oauth2/auth?access_type=offline&approval_prompt=force&response_type=code&client_id=818368855108-8grd2eg9tj9f38os6f1urbcvsq399u8n.apps.googleusercontent.com&redirect_uri=http%3A%2F%2Flocalhost%3A58974&code_challenge=Nc8EH9vceyITk7SeK9H9iEXvcPTlLxzBLhFWE9zwnm0&code_challenge_method=S256&scope=openid+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fuserinfo.email
Then click "Allow access".

Waiting for your authorization...

發(fā)布成功的情況：

$ flutter packages pub publish
Publishing flutter_easy_use_tools 0.0.1 to https://pub.dartlang.org:
|-- .gitignore
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- lib
|   |-- extension
|   |   '-- string_extension.dart
|   |-- flutter_easy_use_tools.dart
|   '-- widgets
|       '-- custom_inner_shadow.dart
|-- pubspec.yaml
'-- test
    '-- flutter_easy_use_tools_test.dart
Downloading vector_math 2.1.0...

Publishing is forever; packages cannot be unpublished.
Policy details are available at https://pub.dev/policy

Do you want to publish flutter_easy_use_tools 0.0.1 (y/N)? y
Uploading...
Successfully uploaded package.

如果使用了代理，則需要在客戶端上執(zhí)行終端代理命令：
我的代理命令如下：
export HTTP_PROXY=http://127.0.0.1:1081; export HTTPS_PROXY=http://127.0.0.1:1081; export ALL_PROXY=socks5://127.0.0.1:1080

執(zhí)行完之后，再執(zhí)行發(fā)布命令。

6. 查看自己發(fā)布的packages

使用谷歌賬號(hào)，登錄網(wǎng)站：https://pub.dev/

查看自己發(fā)布的插件：


image.png

搜索自己發(fā)布的插件：


image.png

7. 更新插件

編寫完新的插件代碼后：
① 修改pubspec.yaml文件中的version: 0.0.1為version: 0.0.2。

image.png

② CHANGELOG.md增加更新日志，最新版本在最上面。

image.png
image.png

③ 修改README.md文件。
④ 提交git代碼，添加tag。
$ flutter packages pub publish 重新發(fā)布。

8. 為插件添加example

在packages目錄下，創(chuàng)建example項(xiàng)目。
添加插件到example，

dependencies:
  flutter:
    sdk: flutter

  flutter_easy_use_tools:
    path: ../

example中使用：

import 'package:flutter_easy_use_tools/flutter_easy_use_tools.dart';

在packages頁面查看：

image.png

9. 插件問題完善

在我的插件后臺(tái)可以看到插件不完善和不規(guī)范的地方，可以完善以提高評(píng)分。


image.png

image.png

代碼格式化執(zhí)行命令：flutter format .

$ flutter format .
Formatting directory .:
Unchanged example/lib/main.dart
Unchanged example/test/widget_test.dart
Unchanged lib/flutter_easy_use_tools.dart
Formatted lib/src/extension/string_extension.dart
Formatted lib/src/utils/num_util.dart
Formatted lib/src/utils/string_util.dart
Formatted lib/src/widgets/custom_inner_shadow.dart
Unchanged test/flutter_easy_use_tools_test.dart

10. 避免通過package:flutter_easy_use_tools/src/...方式來使用插件。

應(yīng)該通過插件提供的對(duì)外文件來使用：
import 'package:flutter_easy_use_tools/flutter_easy_use_tools.dart';

image.png
image.png

11. 為packages創(chuàng)建文檔

使用 dart doc 可以為 Library 生成 API 文檔。
dartdoc 解析源文件去查找使用 /// 語法標(biāo)注的文檔注釋。
進(jìn)入packages根目錄，執(zhí)行dart doc .命令。

$ dart doc .
Documenting flutter_easy_use_tools...

dartdoc failed: Top level package requires Flutter but FLUTTER_ROOT environment variable not set.

執(zhí)行失敗。
查看FLUTTER_ROOT，

$ echo $FLUTTER_ROOT

添加FLUTTER_ROOT

image.png

添加FLUTTER_ROOT，執(zhí)行，查看。

$ source ~/..bash_profile

$ echo $FLUTTER_ROOT
/Users/yuanzhiying/fvm/versions/stable

$ dartdoc
Documenting flutter_easy_use_tools...
Initialized dartdoc with 393 libraries in 48.6 seconds
Generating docs for library flutter_easy_use_tools from package:flutter_easy_use_tools/flutter_easy_use_tools.dart...
  warning: flutter_easy_use_tools has no library level documentation comments, from flutter_easy_use_tools: (file:///Users/yuanzhiying/github/flutter_easy_use_tools/lib/flutter_easy_use_tools.dart:1:9)
Validating docs...
Found 1 warning and 0 errors.
Documented 1 public library in 2.6 seconds
Success! Docs generated into /Users/yuanzhiying/github/flutter_easy_use_tools/doc/api
image.png
最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容