百度智能小程序 命令行工具

2020-09-05 15:15 更新

命令行工具

安裝與更新

npm 工具包下載地址

安裝

npm i swan-toolkit -g
  • 環(huán)境依賴:Node.js
  • 亦可局部安裝,通過npx或node_modules/.bin/swan執(zhí)行。
  • 本工具跨平臺,可以部署在 windows/Mac/Linux,可用于產(chǎn)品集成流水線部署。
  • (全局)安裝后即可使用全局 shell 命令swan。

更新

當(dāng)該 npm 包有更新時,將會在使用過程中以命令行輸出形式提示,建議請按照提示使用安裝命令更新 npm 包;另為了不干擾集成流水線功能,更新提示不會在使用--json參數(shù)時展示,對于此種情況建議定期檢查并手動更新。

功能

  • 下文提到的登錄密鑰,因為涉及到個人賬戶的身份認證,在用于公共機器構(gòu)建流水線時,建議使用獨立開發(fā)賬號的登錄密鑰,并做好用戶隔離和安全保護,定期修改賬戶密碼。
  • 登錄密鑰獲取方式:在百度智能小程序開發(fā)者工具(版本高于 2.4.1)中登錄后,可通過"菜單-關(guān)于-復(fù)制登錄密鑰"獲取。

預(yù)覽

swan preview --project-path /path/to/your/project --token THE_TOKEN_WITH_PREVIEW_AUTHORIZATION

輸入?yún)?shù)

參數(shù)名 必填 說明
-p, --project-path 必填 小程序項目源碼路徑,可為相對路徑或絕對路徑。
--token 必填 有該小程序發(fā)布權(quán)限的登錄密鑰。
--base64 選填 輸出 base64 格式的預(yù)覽二維碼圖片。
--json 選填 只以 json 格式輸出最終結(jié)果,推薦在集成構(gòu)建中使用。
-V, --verbose 選填 輸出日志
--game 選填 小游戲預(yù)覽,從 2.4.10 版本開始支持

輸出

  • 預(yù)覽二維碼、bundle_id
  • exit code 非 0 時,表示過程存在異常,請根據(jù)輸出報錯日志調(diào)查原因。

web 化預(yù)覽

swan web-preview --project-path /path/to/your/project --token THE_TOKEN_WITH_PREVIEW_AUTHORIZATION

輸入?yún)?shù)

參數(shù)名 必填 說明
-p, --project-path 必填 小程序項目源碼路徑,可為相對路徑或絕對路徑。
--token 必填 有該小程序發(fā)布權(quán)限的登錄密鑰。
--base64 選填 輸出 base64 格式的預(yù)覽二維碼圖片。
--json 選填 只以 json 格式輸出最終結(jié)果,推薦在集成構(gòu)建中使用。
-V, --verbose 選填 輸出日志

輸出

  • 預(yù)覽二維碼
  • exit code 非 0 時,表示過程存在異常,請根據(jù)輸出報錯日志調(diào)查原因。

發(fā)布

swan upload --project-path /path/to/your/project --token THE_TOKEN_WITH_PREVIEW_AUTHORIZATION --release-version 1.0.0.0 --desc description

輸入?yún)?shù)

參數(shù)名 必填 說明
-p, --project-path 必填 小程序項目源碼路徑,可為相對路徑或絕對路徑。
--token 必填 有該小程序發(fā)布權(quán)限的登錄密鑰。
--release-version 必填 發(fā)布版本號
-d, --desc 選填 版本描述
-V, --verbose 選填 輸出日志
--min-swan-version 選填 最低基礎(chǔ)庫版本,參見最低基礎(chǔ)庫版本設(shè)置
--game 選填 小游戲發(fā)布,從 2.4.10 版本開始支持

輸出

  • 發(fā)布成功提示
  • exit code 非 0 時,表示過程存在異常,請根據(jù)輸出報錯日志調(diào)查原因。

反饋與建議

如果在使用中遇到問題,或有改進建議,可以在智能小程序開發(fā)者社區(qū)中發(fā)帖向我們反饋,反饋時請注意以下幾點:

  • 反饋前請使用swan version獲取基本版本信息,并在反饋內(nèi)容中標(biāo)明。
  • "問題類型"請選擇“開發(fā)者工具”,并在反饋內(nèi)容中標(biāo)明"cli 命令行工具"。

您的反饋將有助于我們完善產(chǎn)品。


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號