建站
咨詢
售后
建站咨詢
新聞中心
這篇文章主要介紹小程序中為什么要用taro-deploy，文中介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們一定要看完！
為什么要用 taro-deploy？
Taro 小程序開(kāi)發(fā)者常有這種痛點(diǎn)：開(kāi)發(fā)好代碼想要發(fā)布提測(cè)，需要進(jìn)行以下一系列步驟（以支付寶、微信小程序平臺(tái)為例）：
整個(gè)流程將近十分鐘，其中還有不少需要手動(dòng)操作的環(huán)節(jié)，可以說(shuō)這種原始的發(fā)布方式效率非常低。
taro-deploy 就是為了解決這個(gè)痛點(diǎn)出現(xiàn)的，它集成了支付寶和微信提供的命令行工具，自動(dòng)化地完成上述流程。
用了 taro-deploy，開(kāi)發(fā)者在發(fā)布提測(cè)時(shí)只需兩步：
運(yùn)行一次命令 taro-deploy
去喝杯茶歇一下
構(gòu)建發(fā)布完了，釘釘上就會(huì)收到構(gòu)建結(jié)果的推送了，全程無(wú)需人工干預(yù)。
以下為釘釘推送消息的截圖。
可以看到除了發(fā)布生成的小程序二維碼，推送消息里還附帶了構(gòu)建機(jī)器、構(gòu)建分支、項(xiàng)目最近的 git commit 日志等，打包信息更清楚。
NOTE: git commit 日志目前只會(huì)展示feat 和fix 關(guān)鍵詞開(kāi)頭的 commit
適合我用嗎？
如果你
使用 Taro 框架開(kāi)發(fā)小程序
需要支持微信和支付寶平臺(tái)
想要自動(dòng)化構(gòu)建發(fā)布，不想手動(dòng)操作
使用釘釘辦公，開(kāi)發(fā)和測(cè)試都在一個(gè)釘釘群里（這點(diǎn)不是必需的，沒(méi)有釘釘也可以使用 taro-deploy，只是會(huì)多了一些手動(dòng)操作）
那你就非常適合使用 taro-deploy 了。
怎么用？
Step 1 - 安裝
npm i -g taro-deploy復(fù)制代碼
Step 2 - 平臺(tái)相關(guān)的準(zhǔn)備步驟
支付寶：參考官方文檔，準(zhǔn)備好私鑰和 toolId。
微信：參考官方文檔，準(zhǔn)備好私鑰
Step 3 - 創(chuàng)建釘釘機(jī)器人
參考官方文檔創(chuàng)建釘釘機(jī)器人，安全設(shè)置記得選擇“自定義關(guān)鍵詞”并填上“小程序構(gòu)建”即可。
創(chuàng)建完成后，會(huì)得到一個(gè)形如https://oapi.dingtalk.com/robot/send?access_token=XXXXXX 的 webhook url，后續(xù)會(huì)用到。
Step 4 - 準(zhǔn)備配置文件
在你的 Taro 項(xiàng)目根目錄新建一個(gè) deploy-config.js 文件，按下述模版填入內(nèi)容。
這里需要配置的內(nèi)容比較關(guān)鍵也比較多，成敗在此一舉了
// deploy-config.js// 該文件應(yīng)放在 Taro 項(xiàng)目的根目錄下module.exports = { // 構(gòu)建結(jié)果的輸出目錄，該腳本產(chǎn)生的日志也會(huì)輸出到這里
outDir: './deploy-out', // 微信相關(guān)配置
weapp: { // 如果為 false，則不會(huì)運(yùn)行微信的構(gòu)建流程
enable: true, // 這里填你們配置的 Taro 編譯后微信程序包的輸出路徑
projectPath: './dist/weapp', // Step 2 里獲得的私鑰文件的存放路徑
keyPath: './weapp.key', // 微信小程序 appId
appId: 'wx82xxxxxx', // 微信體驗(yàn)版圖片地址
// 與支付寶不同，不管上傳多少個(gè)新版本，微信的體驗(yàn)版地址是一直不變的
// 因此需要在這里配置該二維碼圖片的鏈接
// 直接從微信公眾平臺(tái)上復(fù)制的體驗(yàn)版圖片地址貌似無(wú)法在釘釘里正常展示
// 建議轉(zhuǎn)存到自己的 CDN 上，再將 cdn url 填到下面這里來(lái)
qrcodeImageUrl: 'https://xxxcdn.con/image/weapp-exp-qrcode.jpg', // 小程序版本號(hào)
// 由于微信的命令行 sdk 不支持設(shè)置某個(gè)版本為體驗(yàn)版，要改設(shè)體驗(yàn)版需要在網(wǎng)頁(yè)上手動(dòng)操作
// 所以只能曲線救國(guó)，先在網(wǎng)頁(yè)上將本工具上傳的版本設(shè)為體驗(yàn)版（找到 ci機(jī)器人1 上傳的那個(gè)版本）
// 然后每次上傳都指定同一個(gè)版本號(hào)，以覆蓋舊的版本，最終實(shí)現(xiàn)發(fā)布新體驗(yàn)版的效果
version: '1.1.0', // true 則將跳過(guò)編譯階段，即 taro build 命令，
skipBuild: false,
}, // 支付寶相關(guān)配置
alipay: { // 如果為 false，則不會(huì)運(yùn)行支付寶的構(gòu)建流程
enable: true, // 這里填你們配置的 Taro 編譯后支付寶程序包的輸出路徑
projectPath: './dist/alipay', // Step 2 里獲得的私鑰文件的存放路徑
keyPath: './alipay.key', // Step 2 里獲得的 toolId
toolId: 'f48xxx', // 支付寶小程序 appId
appId: '202xxx', // true 則將跳過(guò) taro build 命令，即編譯階段
skipBuild: false,
}, // 默認(rèn)發(fā)體驗(yàn)版，填 false 則發(fā)布為預(yù)覽版
// 注意如果發(fā)布為預(yù)覽版，需要實(shí)現(xiàn) uploadImage 的函數(shù)，否則釘釘無(wú)法展示預(yù)覽版的二維碼
isExperience: true, // 是否在構(gòu)建前運(yùn)行 npm install
npmInstall: false, // 指定環(huán)境變量，會(huì)在編譯階段，即 taro build 的指令中注入指定的環(huán)境變量
env: { BUILD_ENV: 'test' // 僅作 demo，實(shí)際應(yīng)填入你項(xiàng)目編譯需要用的環(huán)境變量
}, // Step 3 中獲取的釘釘機(jī)器人 webhook url
dingTalkUrl: 'https://oapi.dingtalk.com/robot/send?access_token=xxx', // 如果你只需要構(gòu)建發(fā)布體驗(yàn)版小程序，則可忽略以下函數(shù)
// 如果你需要構(gòu)建發(fā)布預(yù)覽版小程序，則需要實(shí)現(xiàn)該函數(shù)，將本地二維碼圖片文件轉(zhuǎn)換為圖片鏈接，否則無(wú)法將預(yù)覽版二維碼推送到釘釘群里
// 其中 objectName 形如 {platform}-{timestamp}.jpg，作為建議保存的文件名
// filePath 為本地預(yù)覽版二維碼圖片的路徑
uploadImage: async function(objectName, filePath) { return ''
// 如果你使用阿里云 oss 作 cdn，可以參考以下代碼進(jìn)行上傳
// const OSS = require('ali-oss')
// const client = new OSS({
// region: 'oss-cn-xxx',
// accessKeyId: 'xxx',
// accessKeySecret: 'xxx',
// bucket: 'xxx',
// })
// await client.put(`preview/${objectName}`, filePath, {
// 'Cache-Control': 'max-age=31536000'
// })
// return `https://xxx-oss-cdn.com/preview/${objectName}`
}
}復(fù)制代碼Step 5 - 運(yùn)行 taro-deploy
# cd 到你們的項(xiàng)目并運(yùn)行taro-deploy復(fù)制代碼
然后就可以靜候釘釘機(jī)器人推送構(gòu)建結(jié)果了
FAQ
Q: 我們沒(méi)有用釘釘辦公，怎么用 taro-deploy？
A: taro-deploy 目前只支持推送釘釘消息，否則只能完成自動(dòng)化構(gòu)建、上傳、設(shè)置體驗(yàn)版，沒(méi)法完成最后的推送步驟。如果有推送其它IM工具的需求，可以嘗試自行實(shí)現(xiàn)，也歡迎提交 PR。
Q: 為什么發(fā)布預(yù)覽版要實(shí)現(xiàn) uploadImage 函數(shù)這么麻煩？
A: 因?yàn)橹Ц秾毢臀⑿诺念A(yù)覽版只會(huì)生成本地的二維碼圖片，要想在釘釘消息里展示本地的二維碼圖片，只能先將圖片上傳到 cdn，再將 cdn 鏈接填進(jìn)釘釘消息模版里。
Q: 為什么發(fā)布以后，微信體驗(yàn)版還是舊的？
A: 請(qǐng)到微信的網(wǎng)頁(yè)控制臺(tái)上檢查確保已將「ci機(jī)器人1」上傳的版本設(shè)置為體驗(yàn)版。
Q: 只支持微信和支付寶嗎？
A: Taro 支持很多平臺(tái)，但是 taro-deploy 目前只支持了微信和支付寶兩個(gè)平臺(tái)的自動(dòng)構(gòu)建和發(fā)布。
Q: 沒(méi)有找到 ci機(jī)器人1 上傳的版本？
A: 先跑一遍 taro-deploy，等上傳完成以后，就可以在微信小程序控制臺(tái)網(wǎng)頁(yè)的「版本控制」菜單里找到。
Q: 這個(gè)工具如果出 bug 了，會(huì)造成小程序的線上故障嗎？
A: taro-deploy 目前只支持發(fā)布預(yù)覽版和體驗(yàn)版，不支持發(fā)布生產(chǎn)版，不會(huì)影響到生產(chǎn)環(huán)境。
Q: 我想定制釘釘推送消息的內(nèi)容
A: 目前沒(méi)有開(kāi)放很靈活的釘釘消息模版配置，如有需要可以 fork 本項(xiàng)目并定制修改 send-ding.js 文件，也歡迎提交 PR。
以上是“小程序中為什么要用taro-deploy”這篇文章的所有內(nèi)容，感謝各位的閱讀！希望分享的內(nèi)容對(duì)大家有幫助，更多相關(guān)知識(shí)，歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道！
網(wǎng)頁(yè)名稱：小程序中為什么要用taro-deploy-創(chuàng)新互聯(lián)
文章來(lái)源：http://www.dlmjj.cn/article/ishsh.html
