移動APP崩潰捕獲解決方案CrashSight之常用術語解釋（下）

CrashSight為全平臺（移動/PC/主機）開發者提供崩潰異常捕獲、上報、分析和規避方案等全鏈路閉環專業服務。幫助開發者快速定位並解決異常問題，降低產品崩潰率，提升使用者體驗。

國內：https://crashsight.qq.com
出海/海外：

1 介紹
什麼是符號表？ 符號表是記憶體地址與函式名、檔名、行號的對映表。符號表元素如下所示：

 

為什麼要配置符號表？

為了能快速並準確地定位使用者APP發生Crash的程式碼位置，CrashSight使用符號表對APP發生Crash的程式堆疊進行解析和還原。 舉一個例子：
 

而符號表工具，正是CrashSight提供給開發者提取符號表檔案(.symbol)的工具。 如果專案工程中沒有Native程式碼，但使用了程式碼混淆proguard，那麼只需要上傳Proguard生成的Mapping檔案。該符號表也支援Mapping檔案的上傳，具體方法請參看下文。

1.1 環境要求
符號表工具的執行需要Java執行環境（Java SE Runtime Envrionment），JRE或者JDK版本需要>=1.6。

1.2 符號表提取要求

提取符號表需要符號表工具和Debug SO檔案（具有除錯資訊的SO的檔案，可參考下文的第三部分：“3. Debug SO檔案”）。

1.3上傳功能

CrashSight Android符號表工具2.5.0及以上版本增加了上傳功能，並支援Mapping檔案的上傳。 使用上傳功能時，需要指定以下資訊： App ID App Key App版本 App包名 上報地址
1.4 如何獲取App ID和App Key
 

2 提取符號表檔案的方法
符號表工具支援Windows、Linux、Mac三個平臺，提供了JAR包crashSightSymbolAndroid.jar，crashSightSymboliOS.jar
進入官網下載符號表：
國內：https://crashsight.qq.com
出海/海外：

2.1 工具使用方法及選項
 

注意該版本的符號表工具預設不生成Symbol檔案，如果需要指定"-symbol"引數執行符號表工具。
上報URL：預設新加坡
⦁    國內：https://api.crashsight.qq.com/openapi/file/upload/symbol
⦁    新加坡：

2.2 使用示例
以下為具體使用示例，實際使用需要根據專案的具體情況更改下。
#2.2.1 Debug SO的符號表生成和上傳
示例資訊如下：
 

生成符號表檔案並自動上傳
使用符號表工具的JAR包生成符號表檔案，並自動上傳的命令如下：
 

注：上述示例命令中使用的上報地址為海外，如上傳國內環境，自需替換國內環境：https://api.crashsight.qq.com/openapi/file/upload/symbol
#2.2.2 Mapping檔案的上傳
示例資訊如下：
 

使用符號表工具上傳Mapping檔案的命令如下：

  注：上述示例命令中使用的上報地址為海外，如上傳國內環境，自需替換國內環境：https://api.crashsight.qq.com/openapi/file/upload/symbol
常見問題
⦁    符號表工具的具體輸入檔案是什麼？
安卓需要輸入的檔案是帶除錯資訊的.so檔案，iOS的輸入是dsym檔案
⦁    符號表的 UUID 是什麼?
UUID是so/dsym內建的屬性，同一份檔案，該值不會改變；
⦁    符號表的上傳更新是增量更新還是覆蓋更新？
相同UUID會覆蓋，不同UUID會保留.
⦁    使用符號表上傳工具，上傳完成之後怎麼自動確認（校驗）上傳是成功了的。
一般來說符號表工具成功執行完成，就是成功了。也可以在頁面檢查對應版本的符號表是否上傳。
⦁    上傳工具需要更新的話，是如何進行通知以及更新的？ 非必要更新，是會放到本文件中。如果存在必須要更新才能使用的情況，會透過接入時的溝通渠道進行聯絡。

寫在最後：
CrashSight為開發者提供異常捕獲，上報和分析服務。幫助開發者快速定位並解決異常問題，降低產品崩潰率，提升使用者體驗。支援移動/PC/主機全平臺，主要包括：
平臺：
⦁    移動端：iOS、Android
⦁    PC端：Windows
⦁    主機端：Nintendo Switch、PS4、XBOX
語言：
⦁    C/C++/C#、Java、Object-C/Swift
引擎：
⦁    Unity，UE4，Cocos
立刻前往官網：
國內：https://crashsight.qq.com
出海/海外：