前言

在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_NUMBER
The current build number, such as "153"
BUILD_DISPLAY_NAME
The 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 -v
  Homebrew 2.1.2
  Homebrew/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 darwin
  Type "help", "copyright", "credits" or "license" for more information.
  >>> exit()
  

  $ pip3
  
  Usage: 
   pip3 <command> [options]
  
  Commands:
   install Install packages.
   ···
  /<command>

  
  

  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" <directory> 修改为 DocumentRoot "/Users/{$username}/WebSites" <directory>/<directory>
  • 修改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 always
  curlTime=`date +%Y%m%d%H%M%S`
  outputpath=/Users/{username}/Desktop/package/Android_package/apk
  packagename=Test
  platform=android
  webApk=/Users/{username}/WebSites/app/and/apk
  
  cp $outputpath/$packagename.apk $webApk/$packagename\\_$curlTime.apk
  apkUrl='http://主机地址/app/and/apk/'$packagename\\_$curlTime'.apk'
  myqr $apkUrl -n andqr_${JOB_NAME}${BUILD_NUMBER}.png -d /Users/{$username}/WebSites/app/and/qrimg
  qrUrl='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 always
  curlTime=`date +%Y%m%d%H%M%S`
  packagename=Zeus
  ipaName=$packagename\\_$curlTime
  exportPath=/Users/xt/Desktop/package/iOS_package/ipa
  ipaPath=/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.yyy
  bundleVersion=0.0.1
  displayName=Zeus
  

  • 根据上面参数生成manifest.plist
    

  cd /Users/xt/WebSites/app/ios/plist
  cat << EOF > ${ipaName}.plist
  
  
  <plist>
  <dict>
   items
   <array>
   <dict>
   assets
   <array>
   <dict> 
  
   kind
   <string>software-package/<string>
   url
   <string>${ipaUrl}/<string>
   /<dict>
   <dict>
   kind
   <string>display-image/<string>
   url
   <string>${disImg}/<string>
   /<dict>
   <dict>
   kind
   <string>full-size-image/<string>
   url
   <string>${fullImg}/<string>
   /<dict>
   /<array>
   metadata
   <dict>
   bundle-identifier
   <string>${bundleId}/<string>
   bundle-version
   <string>${bundleVersion}/<string>
   kind
   <string>software/<string>
   title
   <string>${displayName}/<string> 
  
   /<dict>
   /<dict>
   /<array>
  /<dict>
  /<plist>
  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
  

  
  

  
  

  在实际应用过程中，大多数人的扫码工具还都是微信，但是微信内置浏览器的解析方式和其他浏览器不一样，我们还需要对这种情况进行处理。

  • 判断是否是微信浏览器
    微信官方推荐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" ];then
  rm "${WORKSPACE}/tempParams.txt"
  else
  echo "File not exist"
  fi
  
  # 变量写入文件
  echo bundleID="${bundleId}" >> "${WORKSPACE}/tempParams.txt"
  echo ipaUrl="${bundleId}" >> "${WORKSPACE}/tempParams.txt"
  ····
  

  其他JOB开始时读取变量

  source "${WORKSPACE}/tempParams.txt"

  "

閱讀更多 風一樣的小靜 的文章

關鍵字: Bash 显示