关于安卓bugly更新，bugly上传符号表实现

背景

tencent bugly经过漫长的岁月，最后走到了只剩下一个错误统计的结局，这是偶然也是必然。面对众多应用合规的调整，这也是无可厚非的事情。而对于错误收集统计，大部分都会依赖三方的错误收集，本文使用的是bugly实现错误统计收集。

环境

androidstudio 4+
win10
jdk 1.8

集成

集成bugly，或者升级bugly，请移步到：官方链接
如果是升级bugly到最新版本，需要注意一下事项：
（1）4.0.0以上版本已将jar和so合并发布，所以开发者升级，只需要依赖如下即可：

android {
    defaultConfig {
        ndk {
            // 设置支持的SO库架构
            abiFilters 'armeabi' //, 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'
        }
    }
}

dependencies {
    implementation 'com.tencent.bugly:crashreport:latest.release' //其中latest.release指代最新Bugly SDK版本号，也可以指定明确的版本号，例如4.0.3
}

（2）3.4.4及之后版本不再采集Android id，所以需要从代码里面，主动调用方法，设置设备id，具体如下：

// 通过UserStrategy设置
strategy.setDeviceID("userdefinedId");

// 也可以通过CrashReport类设置，适合无法在初始化sdk时获取到deviceId的场景，context和deviceId不能为空（或空字符串）
CrashReport.setDeviceId(Context context, String deviceId);

（3）最新版本默认不再获取手机型号，所以需要从代码获取，具体代码如下：

// 通过UserStrategy设置
strategy.setDeviceModel("userdefinedModel");

// 也可以通过CrashReport类设置，适合无法在初始化sdk时获取到deviceModel的场景，context和deviceModel不能为空（或空字符串）
CrashReport.setDeviceModel(Context context, String deviceModel);

而对于开发者而言，“设备型号”，一般都是手机品牌+手机型号，具体代码如下：

    /**
     * 获取手机的品牌
     */
    fun getBrand(): String {
        val model = Build.MODEL
        if (!TextUtils.isEmpty(Build.BRAND)) {
            return Build.BRAND + "/" + model
        } else if (!TextUtils.isEmpty(Build.MANUFACTURER)) {
            return Build.MANUFACTURER + "/" + model
        }
        return model
    }

通过Build类，即可获取手机品牌以及手机型号，但是建议在用户同意隐私协议后，才进行获取，避免不必要的隐私合规问题。

上述就是较为明显的变化，具体可以浏览官方的“进阶功能”查看详情：链接

至此，已经初步接入bugly了。可以通过代码throw exception后，控制台查看是否存在崩溃记录即可。

重点来了

下面要讲的是，如何上传混淆后的mapping文件，对于这个文件，只要是打包的时候，进行了代码混淆并且gradle配置正常，都会在生成目录下出现。默认目录就是app->build某个目录，请自行观察。

而怎样取上传这个文件了，官方给出了这样的答案：
只能通过调用官方的jar包，实现mapping文件。具体链接如下：mapping教程
下载后，有个buglyqq-upload-symbol.jar文件，就是通过这个文件进行mapping.txt上传的。
具体指令如下：

java -jar buglyqq-upload-symbol.jar -appid <APP ID>
                                    -appkey<APP KEY>
                                    -bundleid <App BundleID>
                                    -version <App Version>
                                    -platform <App Platform>
                                    -inputSymbol <Original Symbol File Path>
                                    -inputMapping <mapping file>

-appid 在bugly.qq.com上产品对应的appid
-appkey 在bugly.qq.com上产品对应的appkey
-bundleid Android平台是包名、iOS平台叫bundle id
-version App版本号 (PS:注意版本号里不要有特殊字符串，比如( )，不然运行可能会报错)
-platform 平台类型，当前支持的三个选项 分别是 Android、IOS，注意大小写要正确。
-inputSymbol原始符号表[dsym、so]所在文件夹目录地址，如果是Android平台同时包含mapping和so，此处输入两个原始符号表存储的共同父目录。
-inputMapping mapping所在文件夹目录地址[Android平台特有，ios忽略]

最后，放出一个上传示例：

 java -jar buglyqq-upload-symbol.jar -appid 470f772429
                                     -appkey 59cb8e9b-e882-4996-b81b-6c36875f6729
                                     -bundleid com.example.ktdemo
                                     -version 1.0
                                     -platform Android
                                     -inputSymbol C:\Users\Administrator\Desktop\buglyqq-upload-symbol
                                     -inputMapping C:\Users\Administrator\Desktop\buglyqq-upload-symbol\mapping.txt

而对于嫌麻烦的开发，可以自行封装好一个脚本（如run.bat）。
脚本内容就是获取控制台输入的版本号即可，后续拼接到上传指令中:
实例代码如下：

@echo off
CLS
chcp 65001
echo "------------------------begin------------------------"

echo "------------------------注意！注意！注意！mapping文件需要放在mappingfile目录下------------------------"

echo "------------------------版本号------------------------"
set /p codeInput="请输入app版本号(例如:1.0.0):"
echo 输入app版本号为:%codeInput%

echo "------------------------java版本信息------------------------"

java -version

echo "------------------------开th始上传------------------------"

最后输入刚刚那条jar指令

that's all--------------------------------------------------------------