前言
在Jenkins上显示二维码,是为了每次打完包之后都能方便的用手机下载,不必再使用数据线安装。
本文涉及以下内容
- 架设Web服务器(https)
- Jenkins的history显示图片
- Mac安装Homebrew和Python3
- 本地生成二维码
- shell生成manifest.plist
- 微信扫码跳转
- Jenkins的Job之间传递变量
准备
在Jenkins上显示二维码的思路是修改BuildDescription并放置二维码图片的链接
因此我们需要准备以下内容
项目备注Web服务器用来存放打出来的安装包,可以参照 这里 部署二维码将安装包的链接转换为二维码图片build-name-setterJenkins插件,修改BuildName(新版本为Build Name and Description Setter,集成了修改BuildDescription的功能)
动手
一、在Jenkins上显示二维码图片
1. 安装Jenkins插件
- 进入Jenkins工作台系统管理>插件管理>可选插件>过滤>build-name-setter,勾选对应插件直接安装
- 返回工作台首页,选择一个Build工程>配置
- 可以看到构建环境处多了一个Set Build Name的选项,即插件安装成功
2. 配置Set Build Name插件
查看Jekins的环境变量参数,我们可以看到
BUILD_NUMBERThe current build number, such as "153"BUILD_DISPLAY_NAMEThe display name of the current build, which is something like "#153" by default.
- Set Build Name就是修改这个BUILD_DISPLAY_NAME,默认为#${BUILD_NUMBER}
- Jenkins的默认安全设置,会把所有的输入都当成纯文本,为了使图片链接生效,需要更改一下系统管理>全局安全配置>标记格式器,将纯文本选项改为Safe HTML,保存设置
- 点击Set Build Name的高级,会出现Build Description的设置,可以在这里写入一个图片的链接
安装完毕后brew -v验证是否安装成功
$ brew -vHomebrew 2.1.2Homebrew/homebrew-core (git revision 48bc; last commit 2019-05-13)
如果出现
-bash: brew: command not found
可能是环境变量没有配置好,配置环境变量并更新使其生效
2. 安装Python 3
安装完Homebrew之后,通过命令安装Python 3,Homebrew中的Python默认是Python 3,因此:
$ brew install python
安装完毕后,输入python3和pip3验证是否安装成功
$ python3 Python 3.7.3 (default, Mar 27 2019, 09:23:15) [Clang 10.0.1 (clang-1001.0.46.3)] on darwinType "help", "copyright", "credits" or "license" for more information.>>> exit()
$ pip3Usage: pip3 [options]Commands: install Install packages. ···
3. 安装MyQR
$ pip3 install myqr
验证安装是否成功
$ myqr -h
4. MyQR生成二维码
- MyQR的常用参数:
myqr Words [-v {1,2,3,...,40}] [-l {L,M,Q,H}] [-n output-filename] [-d output-directory] [-p picture_file] [-c] [-con contrast] [-bri brightness]
- 生成二维码,会在当前目录下生成指定的二维码
myqr 'hello word'
可以通过-n和-d来设置生成文件名和路径
$ myqr 'hello word' -n hellow.png -d ../path/
常用参数说明:
-v 控制边长,范围是1至40,数字越大边长越大;-l 控制纠错水平,范围是L、M、Q、H,从左到右依次升高。-n 控制文件名,格式可以是 .jpg, .png ,.bmp ,.gif ;-d 控制位置。-p 用来将QR二维码图像与一张同目录下的图片相结合,产生一张黑白图片。-c 可以使产生的图片由黑白变为彩色的。-con 用以调节图片的对比度,1.0 表示原始图片,更小的值表示更低对比度,更大反之。默认为1.0。-bri 用来调节图片的亮度,其余用法和取值与 -con 相同。
缺点是不能识别中文,优点是一行代码即可生成,比较方便,字符范围:
数字 0 到 9大小写的英文字母常用英文标点符号和空格· , . : ; + - * / ~ ! @ # $ % ^ & ` ' = < > [ ] ( ) ? _ { } | and (space)
三、规范安装包链接地址
1. 修改Apache默认站点目录
为了方便管理和处理权限问题,我们需要修改Apache的默认站点路径
- 先创建一个新的Web路径
$ cd /Users/{$username}/$ mkdir WebSites$ cd WebSites$ pwd /Users/{$username}/WebSites
- 修改Apache的httpd.conf配置 $ sudo vim /private/etc/apache2/httpd.conf 找到DocumentRoot配置 DocumentRoot "/Library/WebServer/Documents" 修改为 DocumentRoot "/Users/{$username}/WebSites"
- 修改Apache的httpd-ssl.conf配置 $ sudo vim /private/etc/apache2/extra/httpd-ssl.conf 找到DocumentRoot配置 DocumentRoot "/Library/WebServer/Documents" 修改为 DocumentRoot "/Users/{$username}/WebSites"
- 在新的Web路径下创建一个主页 $ cd /Users/{$username}/WebSites $ vim index.html 插入内容
Hello New World!
- 重启Apache服务 $ sudo apachectl restart
- 验证修改
访问服务器IP或域名进行验证,http://和https://都需验证
页面出现Hello New World!证明修改成功
2. 创建安装包存放路径
$ mkdir app$ cd app$ mkdir and$ cd and$ mkdir qrimg···
创建文件路径如下
|-- app //总目录 |-- and //存放Android相关文件 | |-- apk //存放apk | |-- qrimg //存放对应的二维码图片 |-- ios //存放iOS相关文件 |-- icon //存放plist中对应的icon |-- ipa //存放ipa |-- plist //存放ipa对应plist文件 |-- ssl //存放SSL证书 |-- qrimg //存放对应的二维码图片
四、修改脚本路径并生成二维码
现在我们需要将打包脚本中生成的文件存储在对应的目录下
1. Android脚本修改
Android脚本比较好修改,只需在Jenkins生成apk时,将生成路径修改为上面存放的路径/Users/{$username}/WebSites/app/apk,具体打包脚本不便贴出,这里将相关变量和修改的代码贴一下
# parameters alwayscurlTime=`date +%Y%m%d%H%M%S`outputpath=/Users/{username}/Desktop/package/Android_package/apkpackagename=Testplatform=androidwebApk=/Users/{username}/WebSites/app/and/apkcp $outputpath/$packagename.apk $webApk/$packagename_$curlTime.apkapkUrl='http://主机地址/app/and/apk/'$packagename_$curlTime'.apk'myqr $apkUrl -n andqr_${JOB_NAME}${BUILD_NUMBER}.png -d /Users/{$username}/WebSites/app/and/qrimgqrUrl='http://主机地址/app/and/qrimg/andqr_${JOB_NAME}${BUILD_NUMBER}.png'
此时,我们得到了Android包的下载地址的二维码,然后把这个地址放在Set Build Name>高级>Build Description里即可
再Build时,就可以在构建历史中看到对应的二维码了2. iOS脚本修改
iOS脚本修改的原理和Android类似,不同的是ipa不像apk一样可以直接安装,需要通过OTA的方式安装(详见这篇文章),因此我们要生成ipa对应的plist文件和对应的二维码
- 相关变量
# parameters alwayscurlTime=`date +%Y%m%d%H%M%S`packagename=ZeusipaName=$packagename_$curlTimeexportPath=/Users/xt/Desktop/package/iOS_package/ipaipaPath=/Users/xt/WebSites/app/ios/ipa#生成的ipa拷到指定位置cp $exportPath/Unity-iPhone.ipa $ipaPath#manifest.plilst需要的参数ipaUrl='https://主机地址/app/ios/ipa/'$ipaName'.ipa'disImg='https://主机地址/app/ios/icon/57.png'fullImg='https://主机地址/app/ios/icon/512.png'bundleId=com.xxx.yyybundleVersion=0.0.1displayName=Zeus
- 根据上面参数生成manifest.plist
cd /Users/xt/WebSites/app/ios/plistcat << EOF > ${ipaName}.plist<?xml version="1.0" encoding="UTF-8"?>itemsassetskindsoftware-packageurl${ipaUrl}kinddisplay-imageurl${disImg}kindfull-size-imageurl${fullImg}metadatabundle-identifier${bundleId}bundle-version${bundleVersion}kindsoftwaretitle${displayName}EOF
- 将plist对应的超链接生成二维码
plistUrl="itms-services://?action=download-manifest&url=https://主机地址/app/ios/plist/${ipaName}.plist"myqr $plistUrl -n iosqr_${JOB_NAME}${BUILD_NUMBER.png -d /Users/xt/WebSites/app/ios/qrimg
把这个地址放在Set Build Name>高级>Build Description里即可
- 再把SSL证书做一个下载二维码,放在JOB说明中,方便第一次的安装下载
$ cd /Users/xt/WebSites/app/ios/ssl$ myqr http://主机地址/app/ios/ssl/ip211.crt
3. 微信扫码的处理
在实际应用过程中,大多数人的扫码工具还都是微信,但是微信内置浏览器的解析方式和其他浏览器不一样,我们还需要对这种情况进行处理。
- 判断是否是微信浏览器
微信官方推荐JS做法
var ua = navigator.userAgent.toLowerCase(); var isWeixin = ua.indexOf('micromessenger') != -1; if (isWeixin) { return true; }else{ return false; }
完整的HTML示例如下:
ooooo
可参考上面生成plist的方式,生成对应的apk,ssl证书和plist对应的html文件,然后将html的地址生成二维码。
补充
这样做完后单个JOB命令过长,可将不同任务拆分成不同的JOB,此时需要注意在不同JOB之间传递变量
# 将之前的内容删除if [ -f "${WORKSPACE}/tempParams.txt" ];thenrm "${WORKSPACE}/tempParams.txt"elseecho "File not exist"fi# 变量写入文件echo bundleID="${bundleId}" >> "${WORKSPACE}/tempParams.txt"echo ipaUrl="${bundleId}" >> "${WORKSPACE}/tempParams.txt"····
其他JOB开始时读取变量
source "${WORKSPACE}/tempParams.txt"