Sentry命令列工具除錯資訊檔案
阿新 • • 發佈:2018-11-08
sentry-cli可用於驗證和上傳除錯資訊檔案(dSYM,Proguard檔案等)。
除錯資訊檔案是其他檔案,可幫助我們提供有關崩潰報告的更多資訊。我們目前支援以下格式:
- 適用於iOS,tvOS和macOS的dSYM檔案
- 適用於Linux和Android的ELF符號
- 適用於Windows的PDB檔案
- Breakpad或Crashpad的Breakpad符號
- 適用於Android的Proguard對映
請注意,源對映雖然也是除錯資訊檔案,但在Sentry中的處理方式也不同。有關更多資訊,請參閱sentry-cli中的Sourcemaps。
一、檔案關聯
通常,Sentry通過其唯一ID將除錯資訊檔案與事件相關聯。每個除錯資訊檔案至少有一個唯一ID。作為特殊情況,dSYM檔案可以包含多個ID的符號。如果您有除錯資訊檔案,則可以使用sentry-cli difutil check命令列印包含的ID。 ID取決於檔案型別:dSYMs和proguard檔案使用UUID,Linux符號使用更長的雜湊值(例如SHA256),PDB使用UUID和年齡欄位。
同樣,上傳命令(例如,sentry-cli upload-dif)允許通過提供其已知識別符號來搜尋特定除錯資訊檔案。
二、檢查檔案
Sentry並非所有除錯資訊檔案都可以使用。要檢視它們是否可用,您可以使用sentry-cli difutil check命令:
sentry-cli difutil check /path/to/debug/information/file
這將報告除錯資訊檔案的UUID以及它是否通過Sentry的基本要求。
三、查詢檔案
如果您在Sentry的UI中看到除錯資訊檔案丟失但您不確定如何找到它們,則可以使用sentry-cli difutil find命令查詢它們:
sentry-cli difutil find <identifier>
此外,sentry-cli upload-dif可以自動搜尋資料夾或ZIP存檔中的檔案。
四、上傳檔案
除錯檔案上載的選項取決於上載環境和除錯格式。有關詳細說明,請參閱其他文章。