符号文件上传¶
符号文件上传¶
plugin 打包符号文件¶
ft-plugin 版本需要 1.3.0 以上版本支持最新的符号文件打包规则,支持 productFlavor 多版本区分管理。建议使用 generateSourceMapOnly = true 先生成符号压缩包,再通过公网 DataWay 上传。
FTExt {
// ...
autoUploadMap = true
autoUploadNativeDebugSymbol = true
env = 'common'
// nativeLibPath='/build/intermediates/merged_native_libs/release/out/lib'
generateSourceMapOnly = true
prodFlavors {
prodTest {
autoUploadMap = true
autoUploadNativeDebugSymbol = true
env = "gray"
generateSourceMapOnly = true
}
prodPublish {
autoUploadMap = true
autoUploadNativeDebugSymbol = true
env = "prod"
generateSourceMapOnly = true
}
}
}
符号文件相关参数均为可选项,可按需启用。若项目包含多个 productFlavor,建议在 prodFlavors 中分别配置;其内部配置会覆盖外层同名参数。
| 参数名 | 类型 | 默认值 | 说明 | 适用场景 |
|---|---|---|---|---|
| autoUploadMap | Boolean | false |
是否自动打包 mapping.txt。 |
开启 R8 / Proguard 混淆,且需要还原 Java / Kotlin 堆栈时启用。 |
| autoUploadNativeDebugSymbol | Boolean | false |
是否自动打包 Native 符号文件。 | 接入 ft-native 或存在 C/C++ 崩溃分析需求时启用。 |
| env | String | 空 | 符号文件所属环境。 | 需要区分 prod、gray 等发布环境时配置。 |
| nativeLibPath | String | 自动识别 | Native so 文件目录,需指向各 ABI 目录的上层路径。 | 默认路径识别失败,或 so 输出目录被自定义时配置。 |
| generateSourceMapOnly | Boolean | false |
仅生成符号压缩包,不自动上传。压缩包路径示例:/app/build/tmp/ft{flavor}SourceMapMerge-release.zip。ft-plugin 1.3.4 及以上支持。 |
推荐开启后,再通过公网 DataWay 上传。 |
| prodFlavors | Closure | 空 | 针对不同 productFlavor 单独配置上传参数。 |
多渠道、多环境构建需要分别上传不同符号文件时使用。 |
nativeLibPath只需要指定到 ABI 目录的上层,例如.../merged_native_libs/release/out/lib。
手动或脚本上传¶
使用 plugin 开启 generateSourceMapOnly = true,执行 gradle task assembleRelease 生成,或自行打包成 zip 文件后,再通过公网 DataWay 上传 SourceMap。推荐使用 zip 命令行进行打包,避免将一些系统隐藏文件打入 zip 包中。
更多详情,可查看:
Unity Native Symbol 文件请参考官方文档