蒲公英文档中心

使用 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,点击下载,下载完的效果如下图:

    搜索插件

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

    添加插件

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

    插件配置信息

    插件填写参数说明:

    参数 说明
    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,如下图:

    上传蒲公英的log

  2. 上传蒲公英成功后,可在 jenkins 中的其他构建中使用蒲公英上传成功后返回的参数:

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

    在其他构建中使用蒲公英的返回值

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