fir.im Jenkins 插件使用方法

fir.im Jenkins 插件可以更快速地上传 apk/ipa 安装包到 fir.im.

安装 Jenkins

• 方法一：直接下载安装包 

  Download Jenkins

  安装完成后在 Terminal 中输入，即可打开 Jenkins。

  open /Applications/Jenkins/jenkins.war
  

• 方法二：使用命令行安装

  安装 homebrew

  $ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  

  安装 Jenkins

  $ brew install jenkins         
  

  启动 Jenkins

  $ jenkins
  

访问 Jenkins

• 请在浏览器输入地址:

    http://localhost:8080/
  

• 使用安装包安装后会自动打开，如果端口冲突那么请修改端口

    defaults write /Library/Preferences/org.jenkins-ci httpPort xxxx
  

注意：xxxx为你要修改的端口号

安装 fir.im 的上传插件

插件介绍

该插件主要功能有2点：

• 上传 apk/ipa 安装包 到 fir.im
• 上传符号表到 BugHD，方便查看混淆后的 Log 日志

注意：在使用之前，请确认自己创建的 Jenkins 项目可以正常编译生成 ipa/apk 文件。 该插件的一般使用情景是编译完生成 apk/ipa 后，如果未指定 apk/ipa 生成目录，插件会默认选择 Jenkins 项目目录。

下载插件

Jenkins 插件下载地址

安装插件

• 进入 Jenkins 管理界面后，点击左侧进入 系统管理

• 然后找到 管理插件 并点击进入 

• 进入插件管理后，点击 高级 选项卡

• 然后在页面找到 上传插件，选择已下载好的 fir.im jenkins 插件文件路径，并点击 上传 等待安装成功。

• 安装成功后，如果没有创建 Jenkins 项目，请先创建项目。如果需要配置已存在的项目，请进入在 配置 中找到 增加构建后操作步骤 ，并选择 Upload to fir.im 添加到 Jenkins 项目中。

• 添加成功后开始配置各种参数，如图显示：

配置插件

1. fir.im Token（必填）

• fir.im Token 查看方法：直接点击 API token 进行查看.

2.IPA/APK Files（可选）

接下来，选择生成 ipa/apk 文件路径

注意：如果没有填写该选项，插会件自动默认查找 Jenkins 创建的项目目录下的 apk/ipa 文件

3.BugHD token（可选）

作用：BugHD上传 mapping.txt/dSYM 文件 API 的调用权限

注意：如果需要上传符号表则是必填项；不需要上传混淆表，则不需要填写

BugHD token 查看方法：请访问 BugHD API token，登录后进行查看。

4. BugHD project ID(可选)

作用：判断具体上传到指定的 bughd 项目

注意：如果需要上传符号表，则是必填项；不需要上传则不用填写

BugHD project ID 查看方法： 请访问 BugHD Projects，登录后找到你要上传符号表的项目，进入该项目，选择 项目设置 选项卡进行查看。

5.dSYM File or mapping File(可选)

作用：选择生成 dSYM/mapping.txt 文件路径

注意：如果需要上传符号表，则是必填项；不需要上传则不用填写

6. Build Notes(可选)

作用：上传 fir.im 后，可显示出更新日志

Jenkins 插件更新日志

• 2015-11-13          V1.1     上线 
• 2015-11-25          V1.2     修复 slave 状态下上传失败的Bug
• 2015-11-30          V1.3     修复上传 apk 图标过小的问题
• 2015-12-01          V1.4     修复ipa文件解析 icon 出错的问题
• 2015-12-08          V1.5     增加上传apk/ipa文件的过滤条件
• 2015-12-16          V1.6     Bug fix
• 2016-01-08          V1.7     Bug fix