fir.im Jenkins 插件使用方法

fir.im Jenkins 插件使用方法

2015年11月11日 標籤：更新日誌, 幫助中心, 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
• 2016-03-14      V1.9.1   修復 解析圖標失敗後致使沒法上傳 & 獲取git log失敗的問題
• 2016-03-18      V1.9.2   更新 dsym/mapping 路徑 支持環境變量 changelog支持環境變量
• 2016-06-29      V1.9.2.3   修復 應用上傳問題
• 2016-09-06      V1.9.3   修復 apk/ipa解析的錯誤
• 2016-09-16      V1.9.4   修復 ChangeLog選項環境變量不變的bug
• 2016-11-09      V1.9.4   修復 解析ipa的問題