先看看效果:
要實現這樣的效果,需要下面3步:
1.下載 node 依賴包 miniprogram-ci,編寫預覽和上傳功能
2. 登入微信公眾平臺, 下載專案的privateKey+新增程式碼上傳IP白名單
3. 安裝配置Jenkins
Step1 下載 node 依賴包 miniprogram-ci,編寫預覽和上傳功能,
在微信小程式專案下建立package.json,wxCI.js檔案,package.json內容如下,執行yarn 或 npm install指令 ,安裝專案執行時需要的依賴
{ "scripts": { "wxci": "cross-env node ./wxCI.js" }, "dependencies": { "cross-env": "^7.0.2", "miniprogram-ci": "^1.0.93" } }
wxCI.js內容如下: 有兩個方法,一個是生成預覽二維碼的方法,一個是上傳發布程式碼的方法。從命令列接受引數,執行對應的操作。生成二維碼的操作是任何情況下都會執行的。程式碼上傳發布是選擇執行的。
const ci = require('miniprogram-ci'); /** * 獲取環境引數 * type 操作型別 preview | publish * version:版本號 上傳操作必填 * desc:版本描述 上傳操作必填 * appid:應用id,測試人員有時需要切換應用Id * buildId: 構建id */ const { type, version = '', desc = '', appid = '', buildId='' } = getEnvParams(process.argv); console.log(process.argv); if(!appid){ console.error('appid不能為空!!!'); process.exit(1); } // 微信小程式的私有key檔案儲存路徑,每次新增appid時,需要找運維加私有key const privateKeyPath = `/var/lib/jenkins/cert/private.${appid}.key`; // 請求引數 const reqParams = { appid, type: 'miniProgram', projectPath: './', privateKeyPath, ignores: ['node_modules/**/*', 'yarn.lock', '.*'], }; // 上傳檔案處理設定引數 const uploadParams = { es6: true, // "es6 轉 es5" es7: true, // "增強編譯" minify: true, // "樣式自動補全" codeProtect: true, // "程式碼保護" autoPrefixWXSS: true, // "樣式自動補全" }; const project = new ci.Project({ ...reqParams }); // 任何時候都生成二維碼 (async () => { const previewResult = await ci.preview({ project, desc: '預覽', // 此備註將顯示在“小程式助手”開發版列表中 setting: uploadParams, qrcodeFormat: 'image', qrcodeOutputDest: `./qrcode-${buildId}.jpg`, onProgressUpdate: console.log, // pagePath: 'pages/index/index', // 預覽頁面 // searchQuery: 'a=1&b=2', // 預覽引數 [注意!]這裡的`&`字元在命令列中應寫成轉義字元`\&` }); console.log(previewResult); })(); if (type == 'publish') { (async () => { const uploadResult = await ci.upload({ project, version, desc, setting: uploadParams, onProgressUpdate: console.log, }); console.log(uploadResult); })(); } /** * 獲取node命令列引數 * @param {array} options 命令列陣列 */ function getEnvParams(options) { let envParams = {}; // 從第三個引數開始,是自定義引數 for (let i = 2, len = options.length; i < len; i++) { let arg = options[i].split('='); envParams[arg[0]] = arg[1]; } return envParams; }
要實現自動預覽和程式碼上傳功能,最核心的一步是miniprogram-ci這個工具包,它是微信小程式官方提供的,官方文件參見 https://developers.weixin.qq.com/miniprogram/dev/devtools/ci.html,用它可以不開啟微信開發者工具,就能實現和微信開發者工具的預覽,程式碼上傳一樣的功能。這裡有個大坑, 用命令列和HTTP呼叫的方式,都有一個很大的缺陷,就是要在Jenkins機器上安裝微信開發者工具,而Jenkins機器一般是Linux作業系統,微信小程式官方並沒有提供Linux作業系統的微信開發者工具安裝包,尤其是HTTP呼叫方式,每次使用的時候,還需要啟動微信開發者工具,才能獲取HTTP服務埠號,而啟動微信開發者工具,會彈出微信開發者工具視覺化UI介面,根本無法做到靜默處理。而網上充滿了這兩者做法的文章,實在是誤導新手。如果你能看到這篇文章,可以少走一些彎路。
step2 登入微信公眾平臺, 下載專案的privateKey+新增程式碼上傳IP白名單
miniprogram-ci需要的privateKey引數,比較費周折,需要管理員賬號,登入微信公眾平臺,下載下來,下載過的話,AppSecret右側的按鈕會顯示為重置, 下載下來的小程式程式碼祕鑰檔案,建議不要提交到git倉裡,放在Jenkins工作目錄下,防止金鑰洩露。
其次,要將Jenkins服務所在機器的IP地址,新增到小程式程式碼上傳IP白名單列表中。
如果忘記把上傳程式碼的Jenkins機器IP地址配置到小程式程式碼上傳IP白名單中的話,會報下面的錯誤
Step3 安裝配置Jenkins
Jenkins的下載安裝參見 Jenkins安裝及入門配置 , 本文只介紹要實現用Jenkins自動構建微信小程式,生成預覽二維碼或上傳發布程式碼該如何配置
1.建立一個自由風格的任務
2. 通用皮膚--填寫任務描述
3.引數設定皮膚--配置構建引數
操作路徑是 引數設定-->引數化構建過程-->新增引數,我們主要用到下面幾種引數:
建立選項引數action是用來讓使用者選擇預覽還是釋出
建立Git Parameter引數 branch--是用來選擇構建git分支的,可以設定一個預設分支
建立選項引數appId是用來選擇構建哪一個微信小程式。
建立文字引數version和desc,是為了在釋出時讓使用者輸入版本號和版本描述。
4. 原始碼管理皮膚 -- 指定構建程式碼分支,這裡要寫成變數$branch,如果寫成常量,上面配置的git Parameter引數就不生效
5.構建皮膚 --需要配置構建執行操作
配置入口是: 構建----》增加構建後操作步驟----》執行 shell
配置執行的操作是,清理上一次構建生成的二維碼, 在Jenkins機器上下載npm依賴包,呼叫微信官方提供的小程式的預覽上傳工具miniprogram-ci ,傳入相關引數,執行預覽或預覽與程式碼上傳發布操作,檢視一下Jenkins 任務工作空間下,是否有二維碼生成。
rm -rf qrcode*.jpg yarn yarn wxci type=$action appid=$appid version=$version desc=$desc buildId=${BUILD_ID} pwd && ls
6. 構建後操作皮膚--配置展示二維碼的HTML文件片段
需要下載一個Jenkins外掛description setter,在增加構建後操作步驟選項列表中,才有Set build description這個選項,其次,將下面的文字複製進去,https://域名:埠/job/任務名稱/ws/qrcode-${BUILD_ID}.jpg是生成的二維碼的檔案路徑,用你實際的地址替換掉這個檔案地址,可以把這個url複製到瀏覽器位址列,看是否可以訪問到。如果可以訪問到,說明檔案路徑沒問題。
<img src="https://域名:埠/job/任務名稱/ws/qrcode-${BUILD_ID}.jpg" alt="預覽二維碼" width="200" height="200" /><br /> <a href="https://域名:埠/job/任務名稱/ws/qrcode-${BUILD_ID}.jpg" target="_blank">${branch}-${appid}-${BUILD_ID}-二維碼</a>
還需設定將文字按照HTML標籤渲染,設定方法:系統管理 -> 全域性安全配置 -> 標記格式器 -> 選擇Safe HTML
再附贈一段快速清除錯誤構建的指令碼,執行的入口是 Jenkins --》 Manage Jenkins--》 Tools and Actions --》 Script Console
#如下程式碼將刪除1到9999的歷史構建 #任務名稱 def jobName = "wx-ci-test" #最大行號 def maxNumber = 9999 Jenkins.instance.getItemByFullName(jobName).builds.findAll { it.number <= maxNumber }.each { it.delete() }
最後,依次點選 Build with Parameters--》開始構建,本文開頭的效果圖就出來啦,至此,大功告成。
本文的程式碼已經託管到gitee, 點選 下載
參考文章:
[2] Jenkins安裝及入門配置