本文介绍如何进行符号表管理和 SourceMap 管理。

符号表管理

符号表用来解析崩溃堆栈的内容，将 minidump 格式转换成可读性较强的文本。

iOS 符号表管理

1. 登录 应用性能监控全链路版控制台。

2. 单击目标应用下的 App端监控。

3. 在控制台左上角选择 文件管理 > 符号表管理。

4. 在 符号表管理 页面，选择 iOS 系统，然后单击+或拖拽文件上传符号表文件。
   

   • 符号表文件为 dSYM 文件。

   • 因为 dSYM 文件本身是个文件夹，上传必须要对 dSYM 文件压缩，大小不超过 1GB。

   • 多个文件上传时，直接对所有符号表整体压缩后上传。压缩过程中不能添加多余的文件夹层级。
     压缩时，Mac 中 zip 需要执行以下命令，去除默认生成的DS_Store__MACOSX文件。

     zip -r test.app.dSYM.zip test.app.dSYM -x "*.DS_Store" -x "__MACOSX"
     

     说明

     请把test.app.dSYM.zip和test.app.dSYM替换为您的符号表名称。

5. 上传成功后，在符号表列表中已上传页签下校验是否上传成功。
   符号表列表中展示了已上传的符号表文件的信息，具体信息如下表所示。

   参数	说明
   UUID	二进制的 UUID 包。在命令行执行dwarfdump -uuid，可以查看 UUID。
   包名	应用的 Bundle ID。
   大小	已上传符号表文件的大小。
   版本号	App 版本号。
   上传人	上传该符号表文件的操作人。
   上传时间	上传该符号表文件的时间。
   操作	单击 下载：查看符号表文件。

Android 符号表管理

1. 登录 应用性能监控全链路版控制台。

2. 单击目标应用下的 App端监控。

3. 在控制台左上角选择 文件管理 > 符号表管理。

4. 在 符号表管理 页面，选择 Android 系统，选择 崩溃类型，然后单击 上传符号表。
   
   API Key 和 API Token，用于自动上传符号表。具体请参见（可选）步骤三：上传符号表。

   注意

   当崩溃类型为 Native崩溃 时，请上传 Debug SO 文件。
   Android平台中，Debug SO文件是指具有调试信息的SO文件，其中包含用户还原堆栈的符号信息。为了方便找回Crash对应的Debug SO文件和还原堆栈，建议每次构建或者发布 APP 版本前，备份 Debug SO 文件。

   • CMake编译项目：
     • 默认情况下，Debug编译的Debug SO文件将位于：<项目文件夹>//build/intermediates/cmake/debug/obj/local<架构>/
   • NDK编译项目：
     • 默认情况下，Debug编译的Debug SO文件将位于：<项目文件夹>//build/intermediates/ndk/debug/obj/local<架构>/
     • Release编译的Debug SO文件将位于： <项目文件夹>//build/intermediates/ndk/release/obj/local<架构>/
   • NDK编译项目的符号表也可能位于：
     • Debug编译<项目文件夹>//build/intermediates/ndkBuild//debug/obj/local<架构>/
     • Release编译<项目文件夹>//build/intermediates/ndkBuild//release/obj/local<架构>/

5. 在上传符号表对话框，单击+或拖拽符号表文件，并配置版本号。
   
   配置项说明：

   配置项	说明
   符号表文件	上传打包后生成的 mapping 文件。
   版本号	输入符号表对应的应用版本号 version_code。

6. 上传成功后，在符号表列表的 已上传 页签中校验是否上传成功。
   符号表列表中展示了已上传的符号表文件的信息，具体信息如下表所示。

   参数	说明
   so库名称	符号表名称。当崩溃类型为 Native崩溃时，会显示该列信息。
   版本号	应用版本号。
   UUID	二进制的 UUID 包。
   大小	已上传符号表文件的大小。
   上传人	上传该符号表文件的操作人。
   上传时间	上传该符号表文件的时间。
   操作	单击 下载：查看符号表文件。 单击 更新：在本地选择符号表文件后，重新上传符号表文件。

Harmony 符号表管理

1. 登录 应用性能监控全链路版控制台。

2. 单击目标应用下的 App端监控。

3. 在控制台左上角选择 文件管理 > 符号表管理。

4. 在 符号表管理 页面，选择 Harmony 系统，选择 崩溃类型，然后单击 上传符号表。
   
   API Key 和A PI Token，用于自动上传符号表。具体请参见（可选）步骤三：上传符号表。

5. 在 上传符号表 对话框，单击+或拖拽符号表文件，并配置版本号。
   
   配置项说明：

   配置项	说明
   符号表文件	上传打包后生成的 mapping 文件。
   版本号	输入符号表对应的应用版本号 version_code。

6. 上传成功后，在符号表列表的 已上传 页签中校验是否上传成功。
   符号表列表中展示了已上传的符号表文件的信息，具体信息如下表所示。

   参数	说明
   so库名称	符号表名称。当崩溃类型为 Native崩溃时，会显示该列信息。
   版本号	应用版本号。
   UUID	二进制的UUID包。
   大小	已上传符号表文件的大小。
   上传人	上传该符号表文件的操作人。
   上传时间	上传该符号表文件的时间。
   操作	单击 下载：查看符号表文件。 单击 更新：在本地选择符号表文件后，重新上传符号表文件。

SourceMap管理

SourceMap是存储源代码和编译代码对应位置映射的信息文件，可以将经过压缩、混淆、合并的产物代码还原回未打包的原始形态，帮助您在生产环境中精准定位问题发生的行列位置。

1. 登录应用性能监控全链路版控制台。

2. 单击目标应用下的App端监控。

3. 在控制台左上角选择文件管理 > Sourcemap管理。

4. 在Sourcemap管理页面，单击点击上传Sourcemap。
   

5. 在上传Sourcemap文件页面，完成以下配置，然后单击确定。
   
   配置项说明：

   配置项	说明
   待解析文件名	自定义文件名，用于识别该Sourcemap文件。
   上传Sourcemap	单击添加文件。 仅支持上传一个文件。 仅支持.js.map格式的文件。