開始使用 Firebase Crashlytics

該快速入門介紹如何設置了火力地堡Crashlytics與火力地堡Crashlytics SDK您的應用程序,這樣你就可以得到全面的崩潰報告火力地堡控制台

在你開始之前

  1. 如果你還沒有,添加火力地堡到iOS項目。如果你沒有一個iOS應用程序,你可以下載一個示例應用程序

  2. 建議:為了讓喜歡自由碰撞用戶,麵包屑日誌和警報速度的功能,您需要啟用谷歌Analytics(分析)在您的火力地堡項目。

    • 如果現有的火力地堡的項目沒有啟用谷歌分析,您可以啟用谷歌Analytics(分析) 集成選項卡中的 >項目設置在火力地堡控制台。

    • 如果您要創建新的 Firebase 項目,請在項目創建工作流程中啟用 Google Analytics。

第1步:在火力地堡控制台啟用Crashlytics

  1. 轉至Crashlytics儀表盤在火力地堡控制台。

  2. 請確保您的應用程序從下拉列表中選擇旁邊Crashlytics在頁面的頂部。

  3. 單擊啟用Crashlytics。

第2步:添加火力地堡Crashlytics SDK到您的應用

  1. 打開你的火力地堡項目創建的podfile並添加FirebaseCrashlytics吊艙。

    對於Crashlytics最佳體驗,我們建議讓谷歌Analytics(分析)在您的火力地堡項目,並添加火力地堡吊艙谷歌Analytics(分析)應用程式。

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. 安裝艙,然後重新打開.xcworkspace文件,看看在Xcode項目:

    pod install
    open your-project.xcworkspace
    
  3. 導入火力地堡模塊在UIApplicationDelegate

    迅速

    import Firebase

    目標-C

    @import Firebase;
  4. 配置一個FirebaseApp共享實例,通常在你的應用程序的application:didFinishLaunchingWithOptions:方法:

    迅速

      // Use the Firebase library to configure APIs.
      FirebaseApp.configure()
      

    目標-C

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      

第3步:設置Xcode的自動上傳的dSYM文件

為了生成人類可讀的崩潰報告,Crashlytics 需要您項目的調試符號 (dSYM) 文件。以下步驟描述瞭如何配置 Xcode 以自動生成您的 dSYM,處理它們,並在您構建應用程序時上傳文件。

  1. 打開項目的 Xcode 工作區,然後在左側導航器中選擇其項目文件。

  2. 目標列表中選擇你的主要的構建目標。

  3. 點擊生成設置選項卡,然後完成以下步驟,以便為Xcode中建立你產生dSYMs。

    1. 單擊所有,然後搜索debug information format

    2. 設置調試信息格式進行的dSYM文件,您的所有構建類型侏儒

  4. 單擊生成階段選項卡,然後完成以下步驟,以便Xcode中可以處理你的dSYMs和上傳文件。

    1. 點擊 >新運行腳本階段

      確保這個新的運行腳本階段是項目的最後構建階段;否則,Crashlytics 無法正確處理 dSYM。

    2. 展開新的運行腳本部分。

    3. 在腳本字段(位於殼牌標籤下方),添加以下運行的腳本。

      此腳本處理您項目的 dSYM 文件並將文件上傳到 Crashlytics。

      "${PODS_ROOT}/FirebaseCrashlytics/run"
    4. 輸入文件中的部分,添加以下文件的路徑。

      • 將路徑添加到項目的 dSYM 文件

        這使 Crashlytics 能夠更快地處理大型應用程序的 dSYM。

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
      • 路徑添加到項目中的內置Info.plist文件

        這使 Crashlytics 能夠將應用程序版本與 dSYM 相關聯。

        $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

有關的dSYM文件和Crashlytics(包括如何手動上傳的dSYM文件)的更多詳細信息,請訪問獲取反混淆崩潰報告

第4步:運行項目

運行您的應用程序。您的設備日誌應顯示初始化已完成的 Firebase 驗證。

第5步:強制碰撞試驗,完成安裝

要完成 Crashlytics 的設置並在 Firebase 控制台的 Crashlytics 儀表板中查看初始數據,您需要強制進行測試崩潰。

有關如何做到這一點的詳細信息,請訪問測試您的實現

下一步