摘要：崩潰分析使用指南最新版本更新內容支持插件，可收集異常修復啟動次數統計一快速集成崩潰分析，支持及以上版本。會用進行錯誤堆棧還原幫助快速定位問題。手動上報的異常將多帶帶顯示在分析報表的異常欄目中。本文由崩潰分析產品經理撰寫。

TestBird 崩潰分析(Artisan) Android SDK 使用指南

**

**

支持H5插件，可收集H5 JS異常；

修復啟動次數統計bug

TestBird 崩潰分析(Artisan) Android SDK，支持Android 2.3 及以上版本。

集成具體方法如下:

Step 1. 創建App

請注冊TestBird賬戶并登陸產品后臺，點這里注冊登陸；

通過“添加應用”按鈕上傳應用的apk文件，添加您的新應用；

添加應用后，在頁面下方的“崩潰分析”面板中獲取您的AppKey，初始化SDK時需要使用；

Step 2. 下載SDK

下載SDK并解壓，支持收集Java異常導致的應用崩潰

如果您的應用是基于HTML的Hybird App，還可以下載集成HTML Plugin，支持收集javascript異常

如果您的工程有Native代碼（C/C++）或者集成了其他第三方SO庫，需要監控Native崩潰，建議下載Artisan的NDK動態庫，下載NDK

Step 3. 導入SDK

Eclipse，導入拷貝TestbirdAgent-1.0.4.jar到libs目錄.

Android Studio

添加libs目錄,并拷貝TestBirdAgent-1.0.4.jar到libs目錄

打開module setting，選擇dependencies頁面，選擇添加file dependency，選中TestbirdAgent-1.0.4.jar文件

Step 4. 導入NDK

若您的應用中使用了C/C++開發模塊，或接入了第三方的NDK，則需要捕獲C/C++的底層異常，還需要引入NDK的SO庫文件

Eclipse，拷貝需要支持的arch文件夾到libs目錄

Android Studio，則在build.gradle中添加jniLibs.srcDirs字段

注意，集成TestBird SO庫時，請只保留支持的架構SO庫

Step 5. 參數配置

在AndroidManifest.xml中添加權限：

請避免混淆TestBird Artisan，同時為了定位問題更加方便精準，需要在還原后的堆棧中顯示行號和源文件的信息。需要在項目工程的Proguard混淆文件中添加以下配置：

-keepattributes SourceFile,LineNumberTable
-keep public class com.testbird.artisan.TestBirdAgent.**{*;}

Step 6. 初始化SDK

SDK初始化需要繼承Application對象，并在OnCreate函數中進行初始化。

public class MyApplication extends Application {
    @Override
    public void onCreate() {
           super.onCreate();
           // 初始化TestBird崩潰分析SDK
           CrashManager.register(this, "創建App時得到的AppKey");

           // 打開SDK Logcat日志輸出，默認是關閉狀態
           CrashManager.setDebug(true);
    }
}

注意：請先關閉其他第三方SDK的崩潰捕獲接口，然后再初始化TestBird SDK，或將TestBird SDK初始化代碼放到最后進行初始化，避免沖突。

SDK提供了崩潰測試函數。

如果啟動日志中出現"I/Testbird: testbird agent init complete."語句，則表示SDK初始化成功。

**為確保SDK正常工作，請觸發一次崩潰，并檢查日志和Web分析報表
注意：多數時候需要重啟一次應用，崩潰信息才能夠上報成功**

調用CrashManager.setDebug(true)，打開SDK Logcat日志輸出，默認是關閉狀態

觸發javacrash，調用CrashManager.testJavaCrash()

觸發nativecrash，調用CrashManager.testNativeCrash()

如果Logcat中出現"Writing unhandledexception to:"語句則表示SDK記錄崩潰成功.

3.1 Java符號化文件

如果項目使用了Proguard混淆代碼，將自動生成mapping.txt文件。TestBird會用mapping.txt進行錯誤堆棧還原,幫助快速定位問題。所以要優先上傳該文件，根據開發環境不同，可以從以下路徑找到mapping.txt。

Android Studio: 在 projectname/app/build/outputs/mapping/目錄下

Eclipse: 在 projectname/proguard/目錄下

上傳文件：請通過崩潰分析應用設置中的“版本管理”直接上傳mapping.txt，各個版本需要分別上傳符號化文件。

3.2 Native符號化文件

Native錯誤堆棧還原,需要使用編譯過程中生成的obj文件.壓縮obj/local文件夾下的所有文件為zip文件，并上傳。

4.1 初始化SDK

啟用TestBirdAgent，注冊的APP Key。還可以注冊渠道ID，以便監控分析不同渠道APK包的表現，默認channelId為空。

public static void register(Context context, String appKey, String channelId)

4.2 設置User ID

調用該方法，設置當前使用App的用戶賬號，以便跟蹤用戶反饋，找出對應的崩潰或異常。

public static void setUserId(String userId)

4.3 自定義Log日志

調用一下方法，添加不同日志級別的自定義Log日志，該Log會隨崩潰堆棧等信息收集到崩潰報表中。自定義Log日志緩存Buffer是32KB。

public static void addVerboseLog(String line)·
public static void addInfoLog(String line)
public static void addDebugLog(String line)
public static void addWarnLog(String line)
public static void addErrorLog(String line)

4.4 自定義鍵值對參數

添加鍵值對

調用該方法后，將向緩存中添加一條鍵值對參數，參數將會被收集到崩潰報表中。最多設置32條自定義鍵值對，每對最大1 KB。

public static void addCustomKeyPair(String key, Object value)

移除鍵值對

public static void removeCustomKeyPair(String key)

清除鍵值對

public static void clearCustomKeyPairs()

4.5 SDK日志輸出控制

將SDK設置為debug模式后，TestBirdAgent會輸出Logcat日志，默認為關閉狀態。

public static void setDebug(Boolean isDebug)

4.6 主動上報catch的異常

將開發者代碼中catch住的異常，進行主動上報。手動上報的異常將多帶帶顯示在分析報表的“異常”欄目中。

public static void submitException(Throwable throwable)

4.7 設置傳輸方式為HTTPs

將SDK的通信方式改變為HTTPs，默認方式為HTTP。

public static void enableHttps()

本文由TestBird崩潰分析產品經理撰寫。想了解更多開發測試相關信息，請訪問 TestBird