在 Jenkins 上显示打包二维码（jenkins打包报错）
off999 2024-10-04 18:59 28 浏览 0 评论
前言
在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的设置，可以在这里写入一个图片的链接 <img src="http://ww1.sinaimg.cn/large/007x9vWyly1g2zgykchtmj30a7064dk4.jpg" height="200" width="200/>
- Build完成之后即可在Build历史中看到对应的图片链接
二、生成二维码图片
生成二维码的方法有很多，可以自行网上查找，我们这里使用一个比较简单的MyQR(Github)，MyQR依赖于Python，如果已经安装好Pyhton 3，点击这里跳转到第三步
1. 安装Homebrew
Mac上自带python是2.7.x版本，血和泪的教训告诉我们没事千万不要动他，有可能造成一些工具无法正常使用（如：Xcode）。这里我们通过Homebrew(官网)安装一下Python 3
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
安装完毕后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. ···
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 "/Library/WebServer/Documents"> 修改为 DocumentRoot "/Users/{$username}/WebSites" <Directory "/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 插入内容 <html> <body> <h1>Hello New World!</h1> </body> </html>
- 重启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
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>items</key>
<array>
<dict>
<key>assets</key>
<array>
<dict>
<key>kind</key>
<string>software-package</string>
<key>url</key>
<string>${ipaUrl}</string>
</dict>
<dict>
<key>kind</key>
<string>display-image</string>
<key>url</key>
<string>${disImg}</string>
</dict>
<dict>
<key>kind</key>
<string>full-size-image</string>
<key>url</key>
<string>${fullImg}</string>
</dict>
</array>
<key>metadata</key>
<dict>
<key>bundle-identifier</key>
<string>${bundleId}</string>
<key>bundle-version</key>
<string>${bundleVersion}</string>
<key>kind</key>
<string>software</string>
<key>title</key>
<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
3. 微信扫码的处理
在实际应用过程中，大多数人的扫码工具还都是微信，但是微信内置浏览器的解析方式和其他浏览器不一样，我们还需要对这种情况进行处理。
- 判断是否是微信浏览器
微信官方推荐JS做法
var ua = navigator.userAgent.toLowerCase();
var isWeixin = ua.indexOf('micromessenger') != -1;
if (isWeixin) {
return true;
}else{
return false;
}
完整的HTML示例如下：
<html>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<body>
<h1 id='jump'>ooooo</h1>
<script>
#测试时候为了刷新缓存
window.onpageshow = function(event) {
if (event.persisted) {
window.location.reload()
}
};
#判断是否在微信浏览器
var ua = navigator.userAgent.toLowerCase();
var isWeixin = ua.indexOf('micromessenger') != -1;
if (isWeixin) {
document.getElementById("jump").innerHTML="请在sarfri中打开";
}else{
document.getElementById("jump").innerHTML="请在sarfri中打开";
window.location.href="itms-services:///?action=download-manifest&url=https://主机地址/xyz.plist";
}
</script>
</body>
</html>
可参考上面生成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"相关推荐
- python:从 12 分钟到 20 秒的奇迹之旅
-
大家好，我是一个常年与代码和数据打交道的程序员。最近，我经历了一次令人头疼的性能挑战。我的一个Python脚本需要处理一个超过一百万行的数据集，任务是对数据进行筛选、清洗并导出结果。然而，这个本该...
- 玩星露谷还能学Python?比刷题更上瘾的学习方法
-
最近朋友在玩星露谷，想起之前网上安利的星露谷编程游戏，然后就被带入坑了。本以为是普通种田游戏，结果全程用Python写代码通关，边摸鱼边学，打工人狂喜！举个游戏里怎么用Python？比如“自动收...
- 大数据计算学习，难度究竟几何?_大数据算法怎么学
-
大数据计算学习，难度究竟几何？在当今这个数字化的时代，大数据计算就像是一颗闪耀的明星，吸引着无数人的目光。很多小伙伴都对学习大数据计算充满了好奇，但又担心它的难度太高，自己学不会。那么，大数据计算学习...
- 不是活爹们 你们学Python都不刷项目的吗
-
在当今这个科技飞速发展的时代，编程语言就像是一把把神奇的钥匙，能为我们打开不同的职业大门。而Python，无疑是其中最耀眼的那一把。但现在问题来了，Python实操项目怎么学习呢？今天咱们就来好好唠唠...
- Python的 10 个“天坑”:搞懂这些，才算真正迈入高手之列
-
引言：Python的“表里不一”作为一名从业多年的Python开发者，我深知Python的魅力所在：它语法简洁，入门门槛低，似乎几个月的学习就能让你自信满满地写出代码。然而，正是这种“表面上...
- Python:开启编程世界的万能钥匙_python编程窗口怎么打开
-
一、引言嘿，老铁们！在当今的编程世界里，Python就像一把万能钥匙，能打开无数扇门。它以其简洁的语法、丰富的库和广泛的应用领域，受到了越来越多人的喜爱。无论是初出茅庐的编程小白，还是经验丰富的开发者...
- 这 6 个 Python 项目，带你从新手蜕变为实战高手
-
你是不是也有过这样的经历？刷完了YouTube上所有的Python教程，写了不下五六个“待办事项”应用，却依然感到自己离一个真正的开发者遥不可及。打开Udemy，课程列表满满当当，但总感觉...
- 用Python做WiFi嗅探?5分钟上手黑客同款技能(附代码)
-
本文是【Python网络安全】入门教学文章，建议收藏！适合安全学习者、网络审计员、Python进阶者阅读。有没有想过，你的电脑其实可以像个“监听器”，实时捕捉周围WiFi的蛛丝马迹？是的，哪怕你不是...
- 用 Python 守护你的 API:从入门到实践的安全监测指南
-
今天我们聊聊一个既技术又务实的话题——如何用Python进行API安全监测。在互联网快速发展的今天，API已成为现代应用程序的核心桥梁，从前端到后端，从移动端到物联网设备，几乎无处不在。可与...
- 学计算机专业，到底学些啥玩意儿?
-
#计算机专业##学计算机#跟你们说个真事儿：我表弟去年报志愿，听人说“学计算机能拿高薪”，咔咔就选了软件工程。结果开学第一周就给我发消息：“哥，啥是‘数据结构’？老师讲指针的时候，我感觉自己脑子像...
- Python 12 个鲜为人知的宝藏库，让运维工作量减少 90%
-
Python12个鲜为人知的宝藏库，让运维工作量减少90%作为一名开发者，你可能对Jenkins流水线、繁琐的配置和午夜紧急回滚习以为常。尽管你可能是Python编程高手，但面对运维的日...
- 别小看“拖延症”:Python 惰性(Lazy)求值的 9 种用法
-
如果要选出一个最能体现Python优雅之处的特性，我会毫不犹豫地选择——惰性（lazy）求值。所谓惰性求值（LazyEvaluation），就是将计算延迟到真正需要的时候才执行。这种机制让P...
- 学 Python 就像谈恋爱:从暧昧到正式牵手，我用 8 个瞬间讲透了!
-
你有没有发现，人生里很多重要的事情，第一步都是最难的。第一次约会、第一次上台讲话、第一次进健身房……总有点怯场。学Python也一样。很多人一听到“编程”两个字，脑海里浮现的画面是：黑屏幕上飞...
- Python 入门不用愁!5 个核心知识 + 3 个偷懒技巧，小白 3 天就能上手
-
提到编程，很多人会觉得“太难了，学不会”。但Python不一样，它就像编程语言里的“白话文”，语法简单、逻辑清晰，哪怕是零基础小白，掌握几个核心知识点和小技巧，也能快速上手。今天就带大家解锁...
- 信息技术专业学什么?从敲代码到搞安全，这些内容要掌握
-
提到信息技术专业，很多人第一反应是“写代码的”。其实这个专业的学习内容远不止于此，它更像一个“数字时代工具箱”，既教你搭建系统，也教你维护网络，还能让你搞懂数据背后的逻辑。下面就用大白话讲讲这个专...
欢迎 你 发表评论:
- 一周热门
- 最近发表
- 标签列表
-
- python计时 (73)
- python安装路径 (56)
- python类型转换 (93)
- python进度条 (67)
- python吧 (67)
- python的for循环 (65)
- python格式化字符串 (61)
- python静态方法 (57)
- python列表切片 (59)
- python面向对象编程 (60)
- python 代码加密 (65)
- python串口编程 (77)
- python封装 (57)
- python写入txt (66)
- python读取文件夹下所有文件 (59)
- python操作mysql数据库 (66)
- python获取列表的长度 (64)
- python接口 (63)
- python调用函数 (57)
- python多态 (60)
- python匿名函数 (59)
- python打印九九乘法表 (65)
- python赋值 (62)
- python异常 (69)
- python元祖 (57)