跳转至

符号文件上传

符号文件上传

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 符号文件所属环境。 需要区分 prodgray 等发布环境时配置。
nativeLibPath String 自动识别 Native so 文件目录,需指向各 ABI 目录的上层路径。 默认路径识别失败,或 so 输出目录被自定义时配置。
generateSourceMapOnly Boolean false 仅生成符号压缩包,不自动上传。压缩包路径示例:/app/build/tmp/ft{flavor}SourceMapMerge-release.zipft-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 文件请参考官方文档

文档评价

文档内容是否对您有帮助? ×