使用 Gradle Plugin 发布应用到 fir.im

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。

---

最后，如使用过程出现任何问题，请发邮件至 [email protected]。

感谢你的支持。