fir.im Gradle 插件幫助開發者使用一條指令發布應用至 fir.im，簡單快速。除此之外，還可以上傳符號表到 BugHD。

下面來看下如何配置、使用 Gradle Plugin。

開始配置

• 在項目的 build.gradle（Top-level build.gradle，項目最外層的 build.gradle 文件）中添加，例如:

    buildscript {
        repositories {
            jcenter() 
                         
    //添加maven源      
            maven { 
                url "http://maven.bughd.com/public"
            }
        }
        dependencies {
            classpath 'com.android.tools.build:gradle:1.3.0'
                         
    //添加fir插件依賴
            classpath 'im.fir:gradle-fir-publisher:1.0.0'
        }
    }           
  

• 在要集成的項目的 build.gradle 中添加配置，如下：

    apply plugin: 'im.fir.plugin.gradle'//必填 
    fir{
  
    //必填 上傳 fir.im apk 字段，否則無法上傳 APP 到 fir.im
        apiToken '?替換為你的 fir.im API_TOKEN'
  
    //可選 上傳fir.im 中顯示的changelog
        changeLog '?替換為你的更新日志'
    }
    
    //可選 如需實現自動上傳符號表到 BugHD 功能，為必填項
    bughd{
        projectId '?替換為你的 BugHD PROJECT_ID'
        apiToken '?替換為你的 BugHD API_TOKEN'
    }
    
    
    //注意
    buildTypes {
     
    debug {
            signingConfig signingConfigs.debug
        }
        
    //需要添加 release 配置
        release {
           //混淆配置打開時，才會自動上傳符號表到 BugHD 
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguardandroid.txt'), 'proguard-rules.pro'
            //需要使用正式證書簽名，才能發布到fir.im
            signingConfig signingConfigs.release
        }
    }
  

?以上信息中有部分內容需要替換配置才能生效，需要替換的信息有以下幾個：

• 1.fir.im 的 apiToken （必填）
• 2.fir.im 的 changeLog （可選）
• 3.BugHD 的 projectID （需要自動上傳符號表功能時為必選）
• 4.BugHD 的 apiToken（需要自動上傳符號表功能時為必選）
• 5.buildTypes 中的 release 配置僅為示例，可根據項目的實際情況修改相應配置

?相關提示：

1. 查看 fir.im api_token

作用： fir.im 上傳 APP 的調用權限

注意： 如果?需要自動上傳應用為必填項

查看方法：請訪問 fir.im，登錄后，點擊頭像 選擇 API token 進行查看

fir.im

2. 查看BugHD api_token

作用： BugHD上傳 mapping.txt/dSYM 文件的調用權限

注意： 如果不需要上傳混淆表不需要填寫

查看方法：請訪問 BugHD API token，登錄后，進行查看.

fir.im

3. 查看BugHD project ID

作用： 判斷上傳到具體到哪個 ?BugHD 的項目

注意： 如果填寫過 BugHD ?apiTOken 后，該選項為必填

查看方法： 請訪問 BugHD Projects，登錄后找到你要上傳符號表的項目后，進入該項目， 并選擇 項目設置 選項卡，進行查看。

fir.im

開始使用

Gradle Plugin 配置成功后，只需要如下一條命令就可以發布應用到fir.im：

gradle publishApkRelease 

注意

• publishApkRelease 任務依附于 gradle 的 assembleTask，也就意味著需要在工程的 build.gradle 的 buildTypes 中添加 release 配置并對 APK 簽名，該插件才會正常運行。

• 使用 Gradle Plugin 上傳符號表到 BugHD 時，需要在工程的 build.gradle 的 buildTypes 中添加 release 打開混淆配置，才會自動上傳符號表到 BugHD。

最后，如使用過程出現任何問題，請發郵件至 help@fir.im。

感謝你的支持。