转载

Jenkins 集成多分支Taro微信小程序

微信开发者工具中虽然集成了预览、上传功能，但是在微信小程序的管理后台，每个开发者上传的版本都是独立的。

如果是多人协作开发，其中一个开发者在修复了 BUG，或者新增了功能，想要上传体验版给测试时，还要登陆后台重新设置体验版，然后再把体验版的二维码发给测试。

每次都要这么操作一番，效率又低，还打断开发者的思路。

万一你请假了，同事帮你改点东西，有可能还没办法上传，还得在你的休息日夺命连环 call 你。更是体验极差。

所以我们采用 Jenkins 持续部署的方式来自动部署上传小程序，免去人工的烦恼。

大家可以看一看大佬已经部署成功的文章微信小程序集成 Jenkins

由于需求跟上面大佬的不太一样，我们公司使用的是 Taro 框架来开发小程序，并且同一个项目下有多个分支都需要进行发布部署。因此也需要进行一些修改。

Taro 是京东旗下凹凸实验室推出的一款使用React语法进行多端统一开发的解决方案。

Jenkins 集成多分支Taro微信小程序

支持微信小程序、H5、百度小程序、支付宝小程序、快应用、ReactNative、字节跳动小程序、QQ 轻应用。可以说是目前小程序开发框架中支持最齐全的了。

下面我们就来讲解如何在Jenkins里集成多分支Taro小程序项目

在集成部署中需要微信开发者工具，目前微信开发者工具只有 macOS 和 Windows 两种版本,上文的大佬用的是 macOS 系统，本文采用 Windows 系统进行部署，使用的是PowerShell，希望能对 Windows 系统的小伙伴们提供一些帮助。

下面讲解下具体步骤

安装 Jenkins

这个步骤和上文大佬的文章是一样的

Jenkins 依赖 java1.8，需要首先在我们的服务器上安装 java1.8 版本。之后直接下载最新的稳定 Jenkins WAR 包，

然后 以管理员身份运行 PowerShell ，并执行以下命令启动 Jenkins

java -jar Jenkins.war --httpPort=8888

其中， --httpPort=8888 为设置服务端口号，默认端口号为 8080 。

注意执行时 PowerShell 所在的文件夹地址要对

新建多分支流水线任务

这里与上面大佬的文章就有区别了。

为了让每个分支都可以有自己的部署策略，所以我们选择使用多分支流水线任务的方式来部署任务

Jenkins 集成多分支Taro微信小程序

配置任务

1、配置源码及分支

Jenkins 集成多分支Taro微信小程序

我们在Branch Sources中选择git源。填入仓库地址，选择适合你的验证方式。

在Behaviours中，我们可以通过新增 Filter by name 的配置项来筛选分支，例如我们现在只希望自动部署以dev开头的分支，那么就填写 dev* 。

2、配置触发器

Jenkins 集成多分支Taro微信小程序

如图所示，我们使用Jenkinsfile来配置流水线。

触发器间隔选择1分钟。相当于每隔一分钟Jenkins会查看一下你的git仓库中有没有更新。如果有更新就会触发自动部署流程。你可以选择合适你的触发间隔。

现在我们的Jenkins任务配置就已经完成了，点击保存按钮即可。

编写Jenkinsfile

Jenkinsfile是Jenkins流水线任务的声明方法之一，具体可以大家可以查看 Jenkinsfile介绍

首先我们在git项目的根目录下创建一个Jenkinsfile文件

如果想创建在其他位置，那么需要调整上面配置触发器部分的 脚本路径 选项

// Jenkinsfile内容
pipeline {
    agent any
    options{
        retry(3)
        timeout(time:10, unit: 'MINUTES')
    }
    stages {
       stage('start') {
          steps {
            echo '构建开始...'
          }
        }
       stage('build') {
          //  在这里也可以设置一些条件，例如分支名称过滤等
          when { branch 'dev*' }
          steps {
            // Windows下使用bat启动脚本，linux或manOS下使用sh启动脚本
            bat 'powershell ./deploy.ps1'
          }
        }
    }
   post {
       success {
            echo '构建成功'
          }
       failure {
            echo '构建失败'
          }
    }
}

编写部署脚本

上面的Jenkinsfile中我们可以看到，在build阶段我们启动了一个名字叫做deploy.ps1的PowerShell脚本。我们的部署、编译、上传等步骤都放在脚本中进行。

在我们实际应用中开发们可以直接使用开发者工具进行预览，测试们使用体验版进行测试，所以不需要预览二维码，如果需要预览二维码请参考上文大佬的文章。

首先确认服务器中已经安装了nodejs、微信开发者工具

微信开发者工具必须是已经登陆的状态。最好可以申请一个自动构建专用的微信账号。

在微信开发者工具的安全设置中开启服务端口

Taro的cli需要在项目本地安装

微信小程序在上传时可以填写版本号，版本号也可以有效的帮助我们区分当前体验版的版本，因此我们在根目录下新建一个 version 文件，将版本号写进去，脚本会自动读取版本号并上传

1.0.0

项目根目录下新增 deploy.ps1 文件

# deploy脚本代码
Write-Output "下载npm包"
npm i --registry=http://registry.npm.taobao.org
Write-Output "开始编译"
# 这里使用的是开发模式编译，如果需要生产模式，将末尾的 --env development 去掉就可以了
./node_modules/.bin/taro build --type weapp --env development
Write-Output "读取版本和编译地址"
$version = Get-Content ./version
Write-Output $version
Write-Output "上传代码"
$path = (Get-Location).Path + "/dist"
$p1 = $version + "@" + $path
Write-Output $path
Write-Output $p1
# 需要修改为你自己的微信web开发者工具安装目录
& 'C:/Program Files (x86)/Tencent/微信web开发者工具/cli' -o $path
Start-Sleep -Seconds 10
& 'C:/Program Files (x86)/Tencent/微信web开发者工具/cli' -u $p1 --upload-desc '自动构建'
Write-Output "关闭当前项目"
& 'C:/Program Files (x86)/Tencent/微信web开发者工具/cli' --close $path
& 'C:/Program Files (x86)/Tencent/微信web开发者工具/cli' --quit

在这里我遇到了一个微信开发者工具的BUG，由于是多分支模式，每个分支必然会长的比较像。也可能存在某些页面或文件在分支A中存在，分支B中不存在。这时候假如分支A上传成功，我们又触发了分支B的自动部署，命令行模式下的微信开发者工具会报错说找不到分支A的某些文件。GUI手动模式下则没有问题。解决办法是将微信开发者工具完全关闭再重新打开。

设置Jenkins开机自启动

Windows10的自动更新已经饱受诟病多时了。Windows10强制要求每35天系统至少更新并重启一遍，每次重启我们还需要手动开启Jenkins也是一件很麻烦的事。因此我们给它配置一个开机自启动。

首先创建一个Jenkins的启动脚本 JenkinsAutoStar.ps1

java -jar "D:/Java/Jenkins.war" --httpPort=8888

1、打开计划任务，创建一个新的基本任务

Jenkins 集成多分支Taro微信小程序

2、在触发器中选择 `计算机启动时`

Jenkins 集成多分支Taro微信小程序

3、在操作中选择 `启动程序`

Jenkins 集成多分支Taro微信小程序

4、填写启动程序配置

程序或脚本中填写
C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe
添加参数中填写
C:/Users/your PC/Desktop/JenkinsStar.ps1

Jenkins 集成多分支Taro微信小程序

5、勾选 `单击万成时打开此任务属性对话框` 并点击完成

Jenkins 集成多分支Taro微信小程序

6、配置权限

用户账户使用 Administrator

勾选 使用最高权限运行

点击确定

Jenkins 集成多分支Taro微信小程序

现在我们已经成功部署了Jenkins的开机启动

以上就是Jenkins集成多分支Taro小程序的全部内容，作者水平有限，如有不清楚的地方或者错误欢迎大家批评指正～

原文 https://segmentfault.com/a/1190000020505648

正文到此结束

所属分类： Java 编程技术

本文标签： linux windows js 支付宝二维码 http retry 源码 https 配置 App src Agent 测试 git 安装需求 dist bug 编译 ip 安全代码 build 服务端服务器 shell 京东管理 Powershell 希望 web jenkins cat NSA 百度 IO java node tar 开发者开发下载部署目录端口 UI 参数文章 tag
版权声明： 本文为互联网转载文章，出处已在文章中说明(部分除外)。如果侵权，请联系本站长删除，谢谢。
本文海报： 生成海报一生成海报二

其他链接

关于本站

本站定位：个人技术类博客

本站作用：写博客、记日志、闲聊扯淡鼓捣技术。

问题交流

Jenkins 集成多分支Taro微信小程序