狠狠躁夜夜躁人人爽天天3,久久国产精品福利二区三区,精品国产一区二区三区久久久78

小程序 CI 構(gòu)建

QQ 小程序開(kāi)發(fā)者可以在小程序項(xiàng)目中輕松接入 CI，在 git 操作時(shí)觸發(fā)構(gòu)建操作（上傳小程序版本，設(shè)置體驗(yàn)版）。

說(shuō)明：

文檔中提供兩種 CI 接入方式：GitHub Actions 和 Drone CI
小程序官方 Docker 構(gòu)建鏡像：qqminiapp/build:latest

準(zhǔn)備工作

獲取 appToken

appToken：用于小程序構(gòu)建過(guò)程中的身份驗(yàn)證。

打開(kāi) qq小程序管理端
登錄
進(jìn)入設(shè)置頁(yè)面
進(jìn)入開(kāi)發(fā)設(shè)置頁(yè)
點(diǎn)擊生成 appToken
管理員掃碼
得到 appToken

方式一：使用GitHub Actions

使用 Docker 鏡像 + GitHub Actions 實(shí)現(xiàn) QQ 小程序持續(xù)集成方案，適用于 GitHub 的 QQ 小程序項(xiàng)目倉(cāng)庫(kù)。

關(guān)于GitHub Actions

GitHub Actions 是 GitHub 官方提供的持續(xù)集成（ CI ）服務(wù)，于 2018年10月推出，詳見(jiàn) 官方文檔。

qq小程序CI構(gòu)建實(shí)現(xiàn)

一、新建項(xiàng)目

GitHub 中新建小程序項(xiàng)目或打開(kāi)已有小程序項(xiàng)目，可以在下圖中看到 Actions 選項(xiàng)。

action菜單

二、編輯GitHub Actions的yaml文件

在小程序項(xiàng)目根目錄下增加文件 .github/workflows/test.yml 文件

小程序 CI 構(gòu)建 yml 小例子如下：

name: CI


#寫法一：在push事件時(shí)觸發(fā)構(gòu)建
on: [push] 


#寫法二：在master分支的push操作時(shí)觸發(fā)構(gòu)建
#on:
##  push:
##    branches:
##    - master


jobs:
  build-qq-ci: #job名稱


    runs-on: ubuntu-latest #運(yùn)行環(huán)境


    steps:

    
    #第一步：獲取小程序源碼
    - name: Checkout 
      uses: actions/checkout@master

      
    #第二步：上傳小程序版本到管理端，并將此版本設(shè)置為體驗(yàn)版（設(shè)置體驗(yàn)版可選）
    - name: Build 
      uses: docker://qqminiapp/build:latest 
      env: 
        PLUGIN_VERSION: 1.0.0
        PLUGIN_DESC: CI自動(dòng)構(gòu)建上傳
        PLUGIN_APPTOKEN: ${{ secrets.APPTOKEN }}
        PLUGIN_BUILDUSER: ${{ github.actor }} 
        PLUGIN_EXPERIENCE: true 
        #PLUGIN_FIRSTPAGE: pages/index/index
        #PLUGIN_USEPACKAGEJSON: true
        #PLUGIN_NPMBUILD: true
        #PLUGIN_SOURCECODEPATH: ./test

說(shuō)明：

env：需要傳入鏡像文件的參數(shù)。其中 PLUGIN_VERSION、PLUGIN_DESC、PLUGIN_APPTOKEN必填，PLUGIN_BUILDUSER 和 PLUGIN_EXPERIENCE 選填。
PLUGIN_VERSION：小程序版本號(hào)。
PLUGIN_DESC：小程序版本描述。
PLUGIN_APPTOKEN：從小程序管理端獲取到的 appToken。此處可直接填 appToken，或者可以使用 secrets 變量 secrets.APPTOKEN。secrets 變量設(shè)置方式見(jiàn)下圖。
PLUGIN_BUILDUSER：小程序開(kāi)發(fā)版的發(fā)布者（小程序管理端->開(kāi)發(fā)管理->開(kāi)發(fā)版本的發(fā)布者）。此處使用了 GitHub 提供的環(huán)境變量github.actor（構(gòu)建者 GitHub 賬號(hào)名）。
PLUGIN_EXPERIENCE：表示是否把當(dāng)前版本設(shè)置為體驗(yàn)版。true：設(shè)置為體驗(yàn)版，false 或不加此參數(shù)：只上傳開(kāi)發(fā)版本，不會(huì)被設(shè)置為體驗(yàn)版。
PLUGIN_FIRSTPAGE：填寫后，掃小程序二維碼會(huì)默認(rèn)打開(kāi)此頁(yè)面。
PLUGIN_USEPACKAGEJSON：是否使用項(xiàng)目根目錄下的 package.json 中的版本號(hào) version 和版本描述 uploadDesc。為 true 時(shí)，CI 配置中的 version 和 desc 不需要填寫，直接讀取。package.json 中的版本號(hào)和版本描述；為 false 或不填，則需要填寫 CI 配置中的 version、desc。
PLUGIN_NPMBUILD：是否進(jìn)行 npm 構(gòu)建。true: 需要構(gòu)建 npm (npm install + 構(gòu)建 npm)；false 或不填：不需要進(jìn)行 npm 構(gòu)建
PLUGIN_SOURCECODEPATH：小程序源碼相對(duì)目錄，例如：如果小程序源碼不在根目錄，在 dist 目錄下，如何指定源碼目錄。方法一：如果項(xiàng)目根目錄下存在 project.config.json 文件，可添加配置 miniprogramRoot: dist 小程序源碼目錄參數(shù)（相對(duì)路徑）。方法二：ci 配置文件中增加 PLUGIN_SOURCECODEPATH: ./dist 參數(shù)指定源碼目錄，這種方式需要注意 dist 目錄下得有 project.config.json 文件

設(shè)置secrets.APPTOKEN

三、執(zhí)行構(gòu)建操作

編寫好 yml 文件后，執(zhí)行 git push 操作時(shí)，GitHub Actions 就會(huì)觸發(fā)構(gòu)建操作了。

如下圖中，打開(kāi) actions 菜單，點(diǎn)擊 workflow runs 里面的工作流程，可以看到 GitHub Actions 的詳細(xì)執(zhí)行過(guò)程。在 build 的執(zhí)行記錄里，可以看到手Q打開(kāi)體驗(yàn)版url消息。復(fù)制 url 地址在 QQ 中點(diǎn)擊就可以打開(kāi)體驗(yàn)版小程序了。

構(gòu)建完成后，就可以在小程序管理端查看提交的體驗(yàn)版小程序了。

方式二：使用 Drone CI

Drone CI 是一個(gè)開(kāi)源 CI 工具，其原生支持 Docker，結(jié)合小程序 CI 構(gòu)建 Docker 鏡像能很方便的實(shí)現(xiàn)小程序的持續(xù)集成。詳見(jiàn) Drone官方文檔。

關(guān)于 Drone 的構(gòu)建環(huán)境選擇：

Drone 官方提供的云構(gòu)建環(huán)境（https://cloud.drone.io/）：項(xiàng)目要求是公開(kāi)的，不支持私有項(xiàng)目
開(kāi)發(fā)者自己搭建私有構(gòu)建環(huán)境（ Drone CI 服務(wù)器）：需要自己搭建 Drone 服務(wù)

使用方式

在 GitHub 中新建代碼倉(cāng)庫(kù)
打開(kāi) https://cloud.drone.io 或開(kāi)發(fā)者自己部署的 Drone 網(wǎng)站（部署方式詳見(jiàn) https://docs.drone.io/installation/runners/ ），使用 GitHub 賬號(hào)登錄
在登錄后的界面中可以看到構(gòu)建記錄

在小程序項(xiàng)目根目錄編寫 .drone.yml 的 CI 配置文件

小程序 CI 構(gòu)建小例子如下：


# yml小例子
kind: pipeline
name: default




steps:
 - name: CI Auto Build
   image: qqminiapp/build:latest
   settings:
     version: 1.0.0
     desc: CI自動(dòng)構(gòu)建上傳 
     appToken: xxx
     buildUser: ${DRONE_REPO_OWNER} 
     experience: true
     #firstPage: pages/logs/logs
     #usePackageJson: true 
     #npmBuild: true
     #sourceCodePath: ./test

when: # CI構(gòu)建觸發(fā)時(shí)機(jī) event: push branch: master






  **說(shuō)明：**

    


*   `image`： 需要在stages中使用qq小程序構(gòu)建鏡像( `qqminiapp/build:latest` )

    
*   `settings`：需要傳入鏡像文件的參數(shù)。其中 appToken 必填；buildUser、experience、firstPage 選填；usePackageJson 選填，當(dāng)其為 true 時(shí)，可不填寫 version 和 desc，當(dāng)其為 false 或不填，則 version 和desc 必填。

    
*   `version`：小程序版本號(hào)

    
*   `desc`：小程序版本描述

    
*   `appToken`：QQ 小程序管理端獲取的 appToken

    
*   `buildUser`：小程序開(kāi)發(fā)版的發(fā)布者（小程序管理端->開(kāi)發(fā)管理->開(kāi)發(fā)版本的發(fā)布者）。推薦填寫 Drone提供的環(huán)境變量。DRONE\_BRANCH：分支名，DRONE\_REPO_OWNER：git賬號(hào)名。buildUser 選填，不填默認(rèn)為“CI”，不同的 buildUser，會(huì)在開(kāi)發(fā)者管理端生成不同版本。可使用 Drone 提供的 [環(huán)境變量](https://docker-runner.docs.drone.io/configuration/environment/variables/)。

    
*   `experience`：表示是否把當(dāng)前版本設(shè)置為體驗(yàn)版。true：設(shè)置為體驗(yàn)版，false 或不加此參數(shù)：只上傳開(kāi)發(fā)版本，不會(huì)被設(shè)置為體驗(yàn)版。

    
*   `firstPage`：掃描小程序二維碼，默認(rèn)打開(kāi)的頁(yè)面。

    
*   `usePackageJson`：是否使用小程序項(xiàng)目根目錄下的 `package.json` 中的版本號(hào) version 和版本描述 uploadDesc 。為 true 時(shí)，ci 配置文件中的version 和 desc 不生效，直接讀取 `package.json` 中的版本號(hào)和版本描述；為 false 或不填，則需要填寫 CI 配置中的 version、desc

    
*   `npmBuild`：是否進(jìn)行 npm 構(gòu)建。true: 需要構(gòu)建 npm (npm install + 構(gòu)建 npm)；false 或不填：不需要進(jìn)行 npm 構(gòu)建

    
*   `sourceCodePath`：小程序源碼相對(duì)目錄，例如：如果小程序源碼不在根目錄，在 dist 目錄下，如何指定源碼目錄？方法一：如果項(xiàng)目根目錄下存在 `project.config.json` 文件，可 添加配置 `miniprogramRoot: dist` 小程序源碼目錄參數(shù)（相對(duì)路徑）。方法二：ci 配置文件中增加 `sourceCodePath: ./dist` 參數(shù)指定源碼目錄，這種方式需要注意 dist 目錄下得有 `project.config.json` 文件。

    


5\.  進(jìn)行 `git push` 操作，在 https://cloud.drone.io/ 中可查看構(gòu)建過(guò)程以及小程序訪問(wèn)地址。打開(kāi) [qq小程序管理端](https://q.qq.com/)，登錄后打開(kāi)開(kāi)發(fā)管理，在開(kāi)發(fā)版本中可以看到 push 后觸發(fā)的 CI 構(gòu)建上傳的小程序版本。

QQ小程序 CL構(gòu)建