發(fā)布何種包之宿?
首先 包分2種一種是純dart包,不包含android. ios橋接代碼, 另外一種 是 插件包,根據(jù)需求創(chuàng)建不同的包
(模塊是另外一種,主要是用于安卓引用flutter模塊的葵陵,是需要指定ios android包名的,因為它直接運行的時候會產(chǎn)生臨時的.android文件夾來配置一個包名瞻佛,而且clear會刪掉緩存脱篙。)
創(chuàng)建插件
在android studio 配置了flutter插件后可以看到 plugin和package, 對應(yīng)android ios這種需要橋接的模板,和 純package包涤久。
選擇下一步就行了。
首先在根目錄配置插件忍弛,其實也是正常的寫代碼响迂,把類創(chuàng)建好,main.dart可刪除细疚,
創(chuàng)建子項目(案例)
然后再基于此目錄flutter create example
創(chuàng)建樣例文件夾
然后在里面的main.dart寫上代碼
在此exmaple的pubspec.yaml
引用根目錄(插件)
dependencies:
smart_gridded_pageview:
path: ../
當然如果你覺得這樣蛋疼你可以復(fù)制同樣的代碼到里面寫蔗彤,但是你不覺得這樣很奇怪嗎?
或者你覺得這個包一定會發(fā)布疯兼,你直接先在線引用寫死也行然遏,當然這些方法統(tǒng)統(tǒng)不方便,加入你升級版本呢吧彪?
插件種引用其他插件待侵?
同樣在根目錄的yaml下插入即可
dependencies:
包名版本
name: smart_gridded_pageview
description: Automatically wrap the content, produce the height according to the content, and support page turning custom indicator
version: 0.0.3
homepage: https://https://github.com/qssq/smart_grid_pageview
hompage最好指定源碼目錄,方便用戶定位反饋姨裸。
圖片顯示
在插件目錄也就是根目錄結(jié)構(gòu)的Readme.md里面
的圖片要正常顯示不能使用相對路徑秧倾,所以我發(fā)布了2次都無法顯示圖片,所以我直接用github的圖片作為顯示
https://raw.githubusercontent.com/qssq/smart_grid_pageview/master/example/assets/pic.png
預(yù)發(fā)布
flutter pub publish --dry-run -v --server=https://pub.dartlang.org
不會真正發(fā)布怨酝,但是會檢測是否有一些錯誤問題
發(fā)布包到pub.dev
1.如果你能在命令行ping 通google.com則不需要設(shè)置代理。
2.記得修改代碼
LICENSE里面的TODO無論如何都必須干掉那先,
3.如果ping不同google.com則設(shè)置http代理
window mac linux 都類似农猬,下面是window的方法,linux方法也是設(shè)置變量名http_proxy 和https_proxy window應(yīng)該不區(qū)分大小寫的,
set HTTP_PROXY=127.0.0.1:1080
set HTTPS_PROXY=127.0.0.1:1080
window shell
$Env:http_proxy="http://127.0.0.1:1080";$Env:https_proxy="http://127.0.0.1:1080"
執(zhí)行發(fā)布
【本地發(fā)布法】
flutter pub publish --server=https://pub.dartlang.org -v
因為國內(nèi)普遍都設(shè)置了鏡像的環(huán)境便利售淡,這里必須指定服務(wù)器server為pub.dartlang.org
此方法沒坑還好斤葱,有坑就死翹翹了,我分別使用了cla,v2之類的都不行揖闸,設(shè)置了代理端口不生效揍堕,而cla開啟tun模式,在cmd下可以不輸入直接ping通google的楔壤,但是依然有錯誤鹤啡,可能是我的vpn沒給錢的原因。蹲嚣。递瑰。
如果已經(jīng)可以ping通大概率會看到一個網(wǎng)址,需要復(fù)制進行打開隙畜,登錄谷歌授權(quán)就行了抖部,這時候會在本地產(chǎn)生一個credentials.json文件,自動發(fā)布的時候就比較有用了议惰,我本地大法沒成功慎颗,但是這一步是走通了的。
另外pub.dev還有信任開發(fā)者一說言询,這個我也弄好了俯萎,弄好之后就可以把發(fā)布的包移動到信任開發(fā)者域名下了,
認證域名必須dns解析大法运杭,用github子站法是行不通了夫啊,雖然能認證但是過不了pub.dev大法認證,我特意整了一個域名lozn.top 我給為了防止過期辆憔,我給續(xù)費10年比較便宜就300撇眯,
【自動發(fā)布法】
使用自動發(fā)布法可以實現(xiàn)提交代碼就自動發(fā)布,設(shè)置tag就自動發(fā)布虱咧。
action語法大概
on: create
表示創(chuàng)建標簽就出發(fā)action任務(wù) 進行發(fā)布熊榛。
on:
push:
branches: [ master ]
pull_request:
branches: [ master ]
表示推送代碼就會執(zhí)行action任務(wù) 進行發(fā)布。
${{ secrets.DART_PUB_CREDENTIAL_JSON }}
表示引用serret變量腕巡,
DART_PUB_CREDENTIAL_JSON 的提取方法:
全局搜索 pub-credentials.json
或者 credentials.json
我電腦在如下目錄
C:\Users\Administrator\AppData\Roaming\dart
格式如下
{"accessToken":"xxxN4uofsg","refreshToken":"xxxxxxx","tokenEndpoint":"https://accounts.google.com/o/oauth2/token","scopes":["openid","https://www.googleapis.com/auth/userinfo.email"],"expiration":1646488878682}
在當前github項目下進入設(shè)置找到secret找到變量的英文單詞玄坦,定義變量名為DART_PUB_CREDENTIAL_JSON
把json的內(nèi)容復(fù)制進去就行,
下面是完整action代碼
name: Publish to Pub.dev
on:
push:
branches: [ master ]
pull_request:
branches: [ master ]
jobs:
build:
runs-on: ubuntu-latest
#if: github.ref != 'refs/heads/master'
steps:
- name: Checkout
uses: actions/checkout@v1
- name: Publish Dart/Flutter package
uses: k-paxian/dart-package-publisher@master
with:
flutter: true
skipTests: true
dryRunOnly: true
credentialJson: ${{ secrets.DART_PUB_CREDENTIAL_JSON }}
deploy:
runs-on: ubuntu-latest
#if: github.ref == 'refs/heads/master'
steps:
- name: Checkout
uses: actions/checkout@v1
- name: Publish Dart/Flutter package
uses: k-paxian/dart-package-publisher@master
with:
flutter: true
skipTests: true
credentialJson: ${{ secrets.DART_PUB_CREDENTIAL_JSON }}
另外網(wǎng)上也有其它大法绘沉,不需要傳遞credentialJson 而是傳遞accessToken和 refreshToken营搅,但是我這邊反正是沒成功云挟,我用此方法就成功了,另外我還給dart-package-publisher的作者提了一個issue,不過我感覺是沒戲转质。园欣。
反正我研究發(fā)布可是研究了3天,本地發(fā)布法怎么搞都失敗了休蟹,網(wǎng)絡(luò)發(fā)布法沸枯,我嘗試過 直接在action里面指定命令,出現(xiàn)y的地方輸入echo y|命令名
但是都失敗告終了赂弓,終于苦苦在github搜索找到了可以用的代碼绑榴。
下面是我發(fā)布的包
···
https://pub.dev/packages/smart_gridded_pageview
···
由于我創(chuàng)建了信任開發(fā)者,因此我的旗下包目錄結(jié)構(gòu)是這樣的
https://pub.dev/publishers/lozn.top/packages
其中l(wèi)ozn.top是我認證的域名盈魁,所以得到的結(jié)果是這樣的路徑翔怎,
但是在pub.dev里面是這樣顯示的,由于我把包移動到我的信任開發(fā)者域名下了杨耙,所以在pub.dev登錄的這個界面的包就看不到了哈赤套! 認證開發(fā)者可以添加多個開發(fā)者郵箱,郵箱為谷歌郵箱珊膜。
發(fā)布成功后容握,一般會收到郵件,
補充
另外一種寫法
name: Publish Package CheckUp
env:
FLUTTER_VERSION: "3.0.2"
#on:
on:
push:
branches: [ master ]
pull_request:
branches: [ master ]
#release:
# types: [published]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: checkout
uses: actions/checkout@v3
- name: Install Flutter
uses: subosito/flutter-action@v2
with:
flutter-version: $FLUTTER_VERSION
- name: Install dependencies
run: flutter pub get
# - name: Analyze
# run: flutter analyze
- name: Setup Pub Credentials
shell: bash
env:
PUB_DEV_PUBLISH_ACCESS_TOKEN: ${{ secrets.ACCESSTOKEN }}
PUB_DEV_PUBLISH_REFRESH_TOKEN: ${{ secrets.REFRESHTOKEN }}
PUB_DEV_PUBLISH_ID_TOKEN: ${{ secrets.IDTOKEN }}
PUB_DEV_PUBLISH_TOKEN_ENDPOINT: ${{ secrets.TOKENENDPOINT }}
PUB_DEV_PUBLISH_EXPIRATION: ${{ secrets.EXPIRATION }}
run: |
sh ./pub_login.sh
- name: Check Publish Warnings
run: flutter pub publish --dry-run
- name: Publish Package
run: flutter pub publish -f
``
然后再你的項目根目錄創(chuàng)建pub_login.sh
# This script creates/updates pub-credentials.json file which is used
# to authorize publisher when publishing packages to pub.dev
# Checking whether the secrets are available as environment
# variables or not.
if [ -z "${PUB_DEV_PUBLISH_ACCESS_TOKEN}" ]; then
echo "Missing PUB_DEV_PUBLISH_ACCESS_TOKEN environment variable"
exit 1
fi
if [ -z "${PUB_DEV_PUBLISH_REFRESH_TOKEN}" ]; then
echo "Missing PUB_DEV_PUBLISH_REFRESH_TOKEN environment variable"
exit 1
fi
if [ -z "${PUB_DEV_PUBLISH_ID_TOKEN}" ]; then
echo "Missing PUB_DEV_PUBLISH_ID_TOKEN environment variable"
exit 1
fi
#if [ -z "${PUB_DEV_PUBLISH_TOKEN_ENDPOINT}" ]; then
#echo "Missing PUB_DEV_PUBLISH_TOKEN_ENDPOINT environment variable"
# exit 1
#fi
#if [ -z "${PUB_DEV_PUBLISH_EXPIRATION}" ]; then
# exit 1
#fi
# Create pub-credentials.json file.
mkdir ~/.config
mkdir ~/.config/dart
cat <<EOF > ~/.config/dart/pub-credentials.json
{
"accessToken": "${PUB_DEV_PUBLISH_ACCESS_TOKEN}",
"refreshToken": "${PUB_DEV_PUBLISH_REFRESH_TOKEN}",
"idToken": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjU4MGFkYjBjMzJhMTc1ZDk1MGExYzE5MDFjMTgyZmMxNzM0MWRkYzQiLCJ0eXAiOiJKV1QifQ.eyJpc3MiOiJhY2NvdW50cy5nb29nbGUuY29tIiwiYXpwIjoiODE4MzY4ODU1MTA4LThncmQyZWc5dGo5ZjM4b3M2ZjF1cmJjdnNxMzk5dThuLmFwcHMuZ29vZ2xldXNlcmNvbnRlbnQuY29tIiwiYXVkIjoiODE4MzY4ODU1MTA4LThncmQyZWc5dGo5ZjM4b3M2ZjF1cmJjdnNxMzk5dThuLmFwcHMuZ29vZ2xldXNlcmNvbnRlbnQuY29tIiwic3ViIjoiMTAzMDE3MDY5MTAxODQxNzUwMzA4IiwiZW1haWwiOiJxc3NxNTIxQGdtYWlsLmNvbSIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJhdF9oYXNoIjoibzNqX2tkZFc5MENLOFN5M3hTZ085QSIsImlhdCI6MTY1NTI4OTYzMywiZXhwIjoxNjU1MjkzMjMzfQ.OvXjZui_KPG_OM6KFDalcJ4KZE87I3t53CRWmtU_bi642ZBXmoAlZFm-QdZhpg7mzMo-W7qw39nRNrfkYyLH1TRNHwqKNyL29UnfrXagN-nQjRmnO5eS_JrsQWhWr0CGsuPyaewBC4WSE8CYPz3YtBEtCllvVq5jwx_Pj2kPpEfLuHrDoFpK2b8PH1jLRWMPbv3-mJb8XCOvvbY0-UbHrawWW53ntl46zE49Hgb-fby_Re071iIDWkLy-EPv2X2GpXUVKgjjwc5Osa63uMQRqmuFrkCyWN2ZFcihOwMfR7w4KC6c-pRy20Ed9LcEDjWR7NwZu-FseOWNE371PgzwmA",
"tokenEndpoint": "https://accounts.google.com/o/oauth2/token",
"scopes": ["https://www.googleapis.com/auth/userinfo.email", "openid"],
"expiration": 1655293221820
}
具體參考 https://github.com/qssq/flutterswitcher_new/actions/runs/2506395380/workflow
https://github.com/qssq/flutterswitcher_new/runs/6911478289?check_suite_focus=true
![image.png](https://upload-images.jianshu.io/upload_images/2815884-8d1bc2faab526da1.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
![image.png](https://upload-images.jianshu.io/upload_images/2815884-39bdd4a126fc5dbd.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
參考資料
https://dart.dev/tools/pub/publishing
https://flutter.io/developing-packages/
這2個鏈接在pub.dev登錄后的右上角菜單就有车柠,可以自己打開剔氏,都有哪些好玩的東西吧!