支付寶小程序擴(kuò)展能力 alipaydev命令行(CLI)

2020-09-19 10:46 更新

簡(jiǎn)介

alipay-dev 開發(fā)工具提供命令行方式進(jìn)行開發(fā),和持續(xù)集成,提高研發(fā)效率,提供小程序各種便捷工具。

支持 CLI 和 SDK 方式引入。

全局安裝

npm install alipay-dev -g

工具初始化配置

  1. 運(yùn)行 alipaydev key create -w 生成密鑰。

  1. 運(yùn)行 alipaydev key upload 自動(dòng)打開瀏覽器配置頁(yè)或直接前往 工具密鑰設(shè)置 頁(yè)面,配置工具公鑰(第一步中生成的 公鑰)以及設(shè)置 IP 白名單(可選),設(shè)置完成后系統(tǒng)會(huì)為您分配一個(gè)工具 ID(toolId)。

  1. 工具密鑰設(shè)置頁(yè)面配置完成后,運(yùn)行配置命令,設(shè)置第一步中生成的私鑰和第二步系統(tǒng)分配的工具 ID(toolId)。

   alipaydev config set -i {工具id} 

輸入?yún)?shù)說(shuō)明

參數(shù) 必填 說(shuō)明
-i, --tool-id 工具 ID
-k, --private-key 工具私鑰

注意:

  • 第一步和第二步是成對(duì)操作的,如果重新生成了本地密鑰,需要同步執(zhí)行第二步將公鑰上傳。
  • 可通過(guò) alipaydev config list 命令查看本地配置詳情。

appId 和 spaceId 切換

以下所有命令,需要傳入 --app-id 或小程序云開發(fā)的 --space-id,都可以提前選定或在每個(gè)命令中具體指定。

## 可以切換當(dāng)前操作的小程序
alipaydev mini list
## 可以切換當(dāng)前操作的云服務(wù)空間(如需使用小程序云開發(fā),請(qǐng)?zhí)崆伴_通)
alipaydev cloud space list
## 查看工具的配置信息
alipaydev config list

命令索引

可以通過(guò) alipaydev -h 查看所有命令幫助,并且每個(gè)命令可通過(guò)增加 -h 參數(shù)查看明細(xì)說(shuō)明(如 alipaydev mini -h)。

分類 說(shuō)明 命令
配置 工具初始化配置 alipaydev config set
展示工具配置信息 alipaydev config list
小程序 小程序列表 alipaydev mini list
小程序預(yù)覽 alipaydev mini preview
小程序上傳 alipaydev mini upload
demo下載 alipaydev mini demo
云開發(fā) 云服務(wù)空間列表 alipaydev cloud space list
空間下的云函數(shù)列表 alipaydev cloud function list
啟動(dòng)本地云函數(shù)運(yùn)行環(huán)境 alipaydev cloud function dev
調(diào)用本地函數(shù) alipaydev cloud function local
上傳云函數(shù) alipaydev cloud function deploy
下載云函數(shù) alipaydev cloud function download
密鑰 密鑰生成 alipaydev key create
密鑰匹配檢測(cè) alipaydev key match
密鑰轉(zhuǎn)換 alipaydev key convert

小程序相關(guān)

小程序上傳&設(shè)置體驗(yàn)版

alipaydev mini upload

示例代碼

## 將/Users/workspace/Demos/todos 目錄下的小程序源碼上傳
alipaydev mini upload -p /Users/workspace/Demos/todos


## 將/Users/workspace/Demos/todos 目錄下的小程序源碼上傳并設(shè)置體驗(yàn)版(設(shè)置體驗(yàn)版功能僅開放給主賬號(hào))
alipaydev mini upload -p /Users/workspace/Demos/todos -e

參數(shù)說(shuō)明

參數(shù) 必填 說(shuō)明 默認(rèn)值
-p, --project 項(xiàng)目目錄 無(wú)
-i, --app-id 小程序appId 無(wú)
-v, --version 上傳包版本 線上包版本自增 0.0.1
-c, --client-type 上傳的終端。 支付寶:alipay,高德:amap alipay
-e, --experience 上傳成功后,自動(dòng)設(shè)置為體驗(yàn)版本, 該功能只針對(duì)小程序主賬號(hào)生效 false

FAQ:

報(bào)錯(cuò):整包大小過(guò)大,實(shí)際大小超過(guò) 2048kb 限制

解決方案:精簡(jiǎn)圖片等本地資源文件,或者使用 分包加載 功能。

報(bào)錯(cuò):小程序源碼過(guò)大

解決方案:清除node_modules 緩存,重新 install

小程序預(yù)覽

alipaydev mini preview

示例代碼

## 將 /Users/workspace/Demos/todos 目錄下的小程序源碼上傳預(yù)覽,對(duì)應(yīng)appId為20190666750666
alipaydev mini preview -p /Users/workspace/Demos/todos -i 20190666750666


## 默認(rèn)啟動(dòng)頁(yè)為pages/index/index,參數(shù)q=v&id=33,小程序launch參數(shù)為name=demo&fromId=11
alipaydev mini preview -p /Users/workspace/Demos/todos -i 20190666750666 --page 'pages/index/index?q=v&id=33' --launch 'name=demo&fromId=11'

參數(shù)

參數(shù) 必填 說(shuō)明 默認(rèn)值
-p, --project 項(xiàng)目目錄 無(wú)
-i, --app-id 小程序 appId 無(wú)
--page 落地頁(yè)面,如:"pages/index/index?q=v&id=33" 無(wú)
--launch app.js的onLaunch中取得,如: "name=demo&fromId=11" 無(wú)
-f, --qrcode-format 返回二維碼文件的格式,如:terminal、base64、image image
-o, --qrcode-output 二維碼文件保存路徑 程序執(zhí)行目錄

Demo下載

alipaydev mini demo

示例代碼

alipaydev mini demo


alipaydev mini demo --path /Users/workspace/Demos

輸入?yún)?shù)說(shuō)明

參數(shù) 必填 說(shuō)明
-p, --path 下載到指定目錄

云開發(fā)相關(guān)

查看云服務(wù)空間列表

alipaydev cloud space list

示例代碼

## 查看云服務(wù)空間列表,在終端顯示云服務(wù)空間的名稱以及云服務(wù)空間的 ID
alipaydev cloud space list
## 云服務(wù)空間命令幫助
alipaydev cloud  space -h

查看云函數(shù)列表

alipaydev cloud function list

示例代碼

## 查詢服務(wù)空間下的云函數(shù)列表
alipaydev cloud function list -s a97326fa-014b-4f9b-bc90-e4be2d776627
## 云函數(shù)列表命令幫助
alipaydev cloud function list -h

輸入?yún)?shù)說(shuō)明

參數(shù) 必填 說(shuō)明 默認(rèn)值
-i, --app-id 小程序 appId 無(wú)
-s, --space 云服務(wù)空間 ID 無(wú)

上傳云函數(shù)

alipaydev cloud function deploy

示例代碼

## 上傳云函數(shù)
alipaydev cloud function deploy -s a97326fa-014b-4f9b-bc90-e4be2d776627 -n getSum -p /xxx/yyy
## 上傳云函數(shù)列表命令幫助
alipaydev cloud function deploy -h

輸入?yún)?shù)說(shuō)明

參數(shù) 必填 說(shuō)明 默認(rèn)值
-s, --space 云服務(wù)空間 ID 無(wú)
-n, --name 云函數(shù)名 無(wú)
-p, --project 云函數(shù)本地文件地址 無(wú)

下載云函數(shù)

## 下載云函數(shù) main到 /server/functions目錄下面


alipaydev cloud function download  -n main --path /server/functions

示例代碼

## 上傳云函數(shù)


alipaydev cloud function download --space a97326fa-014b-4f9b-bc90-e4be2d776627 -n getSum --path /a/b


## 上傳云函數(shù)列表命令幫助


alipaydev cloud function download -h

參數(shù)說(shuō)明

參數(shù) 必填 說(shuō)明 默認(rèn)值
-s, --space 云服務(wù)空間ID 無(wú)
-n, --name 云函數(shù)名 無(wú)
-p, --path 下載后保存路徑 無(wú)

啟動(dòng)本地調(diào)試服務(wù)

alipaydev cloud function dev -p /server/functions --inspect

參數(shù)說(shuō)明

參數(shù) 必填 說(shuō)明 默認(rèn)值
-i, --app-id 小程序 appId 無(wú)
-p, --project 云函數(shù)根目錄 無(wú)
--port 服務(wù)啟動(dòng)端口 3636
--inspect 啟動(dòng) chrome 調(diào)試器 false

調(diào)用本地云函數(shù)

alipaydev cloud function local -p /server/functions -n main --input '{"x":1,"y":2}'

參數(shù)說(shuō)明

參數(shù) 必填 說(shuō)明 默認(rèn)值
-i, --app-id 小程序 appId 無(wú)
-s, --space-id 云服務(wù)空間 ID 無(wú)
-p, --project 云函數(shù)根目錄 無(wú)
-n, --name 云函數(shù)名 無(wú)
--input 云函數(shù)參數(shù),JSON 字符串 無(wú)

密鑰相關(guān)

密鑰生成

alipaydev key create

示例代碼

## 在當(dāng)前目錄生成密鑰文件,并在終端中打印。密鑰類型RSA2,密鑰格式PCKS8
alipaydev key create


## 在指定目錄生成密鑰文件,并在終端中打印
alipaydev key create -t rsa2 --pub-path=/Users/keys/public.txt   --pri-path /Users/keys/private.txt


## 密鑰生成幫助
alipaydev key -h

參數(shù)說(shuō)明

參數(shù) 必填 說(shuō)明 默認(rèn)值
-t,--type 密鑰類型(rsa2/rsa) rsa2
-s,--scheme 密鑰格式(pkcs8/pkcs1) pkcs8
--pub-path 公鑰保存地址 當(dāng)前工作目錄
--pri-path 私鑰保存地址 當(dāng)前工作目錄

工具密鑰配置

無(wú)參數(shù),打開瀏覽器后,上傳本地生成的公鑰

alipaydev key upload

密鑰匹配檢測(cè)

alipaydev key match

示例代碼

## 校驗(yàn)public.txt 和private.txt 中存放的公私鑰是否成對(duì)匹配
alipaydev key match --pub-path=/Users/keys/public.txt   --pri-path /Users/keys/private.txt


## 密鑰匹配幫助
alipaydev key match -h

參數(shù)說(shuō)明

參數(shù) 必填 說(shuō)明
--pub-path 公鑰地址
--pri-path 私鑰地址

密鑰轉(zhuǎn)換

alipaydev key convert

示例代碼

## 將 private.txt中的私鑰轉(zhuǎn)換成pcks1格式
alipaydev key convert --pri-path /Users/keys/private.txt -s pkcs1




## 密鑰轉(zhuǎn)換幫助
alipaydev key convert

輸入?yún)?shù)說(shuō)明

參數(shù) 必填 說(shuō)明 默認(rèn)值
-s,--scheme 秘鑰格式(pkcs8/pkcs1) pkcs8
--pri-path 私鑰地址 無(wú)

官方釘釘服務(wù)群

可掃描以下二維碼進(jìn)群咨詢命令工具相關(guān)事項(xiàng)。

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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)