使用 Jenkins 插件上传应用到蒲公英

这篇文章将向大家介绍如何使用 jenkins 插件上传 ipa/pak 到蒲公英。

这款 jenkins 插件来自源于热心的蒲公英用户,插件开源于Github :https://github.com/jenkinsci/upload-pgyer-plugin ,在此,蒲公英向这位插件的开发者 @Yang Fan表示感谢。

功能

  1. 通过可视化表单信息填写,上传 ipa/apk到蒲公英。
  2. 可以将上传后蒲公英返回的信息用于jenkins的其他构建步骤。

使用方法

  1. 下载插件:jenkins -> 系统管理 -> 插件管理,搜索 Upload to pgyer,点击下载,下载完的效果如下图:

    通过共享文件的方式搭配Jenkins自动上传文件到Windows系统 jenkins上传文件插件_上传

  2. 在 jenkins 的 job 配置页面 构建或 构建后操作中添加构建步骤 upload to pgyer 如下图:

    通过共享文件的方式搭配Jenkins自动上传文件到Windows系统 jenkins上传文件插件_文件路径_02

    插件添加成功后,会显示一下效果:

    通过共享文件的方式搭配Jenkins自动上传文件到Windows系统 jenkins上传文件插件_文件路径_03

    插件填写参数说明:

参数

说明

pgyer uKey

蒲公英的 uKey (必填)

pgyer api_key

蒲公英的 api_key (必填)

scandir

ipa/apk 所在目录 (必填)

file widcard

上传文件的通配符 (必填)

installType(optional)

应用安装方式,值为(1,2,3)。1:公开,2:密码安装,3:邀请安装。默认为1公开(选填)

password(optional)

设置App安装密码(选填)

updateDescription(optional)

版本更新描述(选填)

qrcodePath(optional)

如果你需要下载蒲公英返回的二维码,那么这里填写二维码的存储路径,如果你不需要下载,那么你不需要在这里填写任何内容(选填)

envVarsPath(optional)

如果你想存储蒲公英返回的上传信息,那么这里填写保存信息的文件路径,如果你不需要保存,那么你不需要在这里填写任何内容(选填)

注意:
qrcodePath与envVarPath是存储二维码和应用信息的文件路径地址,而不是一个文件夹的地址。例如可以这样填写这两个参数:

qrcodePath: /Users/James/IOS_Integration/${BUILD_TYPE}/${BUILD_TIME}/qrcode.png
 envVarPath: /Users/James/IOS_Integration/${BUILD_TYPE}/${BUILD_TIME}/envVars.txt**
  1. 执行构建,蒲公英上传插件将输出相应的 log,如下图:

    通过共享文件的方式搭配Jenkins自动上传文件到Windows系统 jenkins上传文件插件_上传_04

  2. 上传蒲公英成功后,可在 jenkins 中的其他构建中使用蒲公英上传成功后返回的参数:
  1. 这款会将蒲公英返回的参数注入为jenkins的全局变量,在其他构建步骤的使用方法直接引用这个全局变量即可,变量名称直接使用返回的 key值。例如:${appBuildURL}

通过共享文件的方式搭配Jenkins自动上传文件到Windows系统 jenkins上传文件插件_上传_05

  1. 蒲公英上传成功后返回参数的参考请看这里