网页上传符号表
上传入口
上传入口一:设置/符号表
- 点击「上传符号表」按钮,即可唤起上传符号表对话框;
- 或者当列表中存在待上传符号表时,点击「待上传」,即可唤起上传符号表对话框。此时会假定用户期望上传指定UUID的符号表文件,此时会自动填写UUID,而且会校验UUID。
上传入口二:个例详情/符号表
- 分析异常个例时,如果发现符号没有翻译,可以直接切到符号表Tab,快速上传符号表。
- 在个例详情页上传符号表时,会假定用户期望上传指定的符号表文件,会自动填写App版本,构建号,针对so或者dSYM还会自动填写UUID,并且校验UUID。
上传操作
上传Android mapping文件
- 将要上传的mapping文件压缩成zip文件,拖到上传区域即可。
- 针对相同版本号和构建号的mapping文件,支持批量上传,通过文件名区分。
- 当前只支持针对一级目录进行mapping文件的查找,即需要将多个需要上传的mapping文件放到相同目录下,通过文件名区分,通过zip压缩目录。
- 如下示例所示,mapping目录下包含a_mapping.txt, b_mapping.txt, c_mapping.txt, d_mapping.txt, mapping.txt 共5个mapping文件。
- 将mapping目录压缩成mapping.zip文件,拖动上传,首次上传时,提示上传成功。
- 再次上传,会提示覆盖上传,如果确定覆盖,点击「继续上传」按钮,即可覆盖同名文件。
- 推荐将宿主的mapping文件命名为mapping.txt,其他组件或者插件的mapping文件命名为xxx_mapping.txt。
- Bugly翻译平台后续会按 mapping.txt > xxx_maping.txt的顺序来组装大mapping,即针对一行堆栈,优先得宿主的mapping文件进行翻译,再用组件,或者插件的mapping文件进行翻译。
上传Android so文件
- 将要上传的so符号表文件压缩成zip文件,拖到上传区域即可。
- 针对相同版本号和构建号的so符号表文件,支持批量上传。
- so的符号表文件通过UUID唯一标识。如果检测发现,相同UUID文件已经上传过,会提醒用户是否需要覆盖。
上传iOS dSYM文件
- 将要上传的dSYM文件压缩成zip文件,拖到上传区域即可。
- 针对相同版本号和构建号的dSYM文件,支持批量上传。
- dSYM文件通过UUID唯一标识。如果检测发现,相同UUID文件已经上传过,会提醒用户是否需要覆盖。
上传Harmony SO文件
操作同上传Android so文件。
上传Harmony nameCache & sourceMaps文件
操作同上传Android mapping文件,支持nameCache、sourceMaps文件独立上传。
案例演示
1. 怎么批量上传so符号表文件?
如下图所示,在build/intermediates/cmake/release/obj目录下可以看到不同CPU架构的目录。可以直接将整个obj目录压缩,得到obj.zip文件,直接拖动obj.zip文件到上传文件区域,点击「确认上传」即可。
文件比较大时,耗时可能要久一点,请耐心等待,上传成功后,即可在网页看到刚才批量上传的文件。
2. Android应用怎样上传插件的符号表?
- Android 的mapping文件,通过App版本和构建号来定位指定异常的符号表。
- Bugly 符号表系统支持针对指定App版本和构建号,上传多个mapping文件,如下图所示,包含5个mapping文件。
- Bugly 符号表系统推荐按以下规则来命名mapping文件:宿主的mapping文件命名为 mapping.txt,插件或者组件的mapping文件命名为xxx_mapping.txt。
- 上传符号表时,既可以将所有这些mapping文件放在一个目录下,压缩成zip,批量上传。
- 也可以分批上传,例如先上传mapping.txt,再上传c_mapping.txt, d_mapping.txt,再上传a_mapping.txt, b_mapping.txt,共分三批上传。
- 如果发现某个插件的mapping文件传错了,也可以覆盖上传,Bugly符号平台会提示用户存在覆盖的情况。
重要提醒
Android 的mapping文件是通过App版本,构建号,以及文件名来唯一标识的,而跟具体的文件无关。也就是说,同个mapping文件,分别上传两次,只要App版本号,构建号,文件名三者中,有差异,都不会识别为覆盖上传。