Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

開始使用 Firebase Crashlytics

本快速入門介紹瞭如何使用 Firebase Crashlytics SDK 在您的應用中設置 Firebase Crashlytics,以便您可以在Firebase 控制台中獲得全面的崩潰報告。

在你開始之前

  1. 如果您還沒有,請將 Firebase 添加到您的 iOS 項目。如果您沒有 iOS 應用程序,則可以下載示例應用程序

  2. 推薦:要獲得無崩潰用戶、麵包屑日誌和速度警報等功能,您需要在 Firebase 項目中啟用 Google Analytics。

    • 如果您現有的 Firebase 項目未啟用 Google Analytics,您可以從 Firebase 控制台中 >項目設置集成選項卡啟用 Google Analytics。

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

第 1 步:在 Firebase 控制台中設置 Crashlytics

  1. 在的左側導航面板中單擊Crashlytics 火力地堡控制台

  2. 如果您的 Firebase 項目中註冊了多個應用,請從控制台頂部欄中Crashlytics旁邊的下拉菜單中選擇您剛剛添加的應用。

  3. 單擊啟用 Crashlytics

第 2 步:將 Firebase Crashlytics SDK 添加到您的應用

  1. 打開您為 Firebase 項目創建的 podfile 並添加FirebaseCrashlytics pod。

    為了獲得 Crashlytics 的最佳體驗,我們建議在您的 Firebase 項目中啟用 Google Analytics ,並將適用於 Google Analytics 的 Firebase pod 添加到您的應用中。

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

    pod install
    open your-project.xcworkspace
    
  3. UIApplicationDelegate導入 Firebase 模塊:

    迅速

    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];
      
  5. 重新編譯您的應用程序。

第 3 步:初始化 Crashlytics

您可以通過向項目的構建階段添加運行腳本來初始化 Crashlytics。運行腳本允許 Xcode 在您的應用程序崩潰時自動上傳您項目的 dSYM 文件,以便 Crashlytics 可以自動生成崩潰報告。

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

  2. Select a project or target下拉列表中,選擇您的主要構建目標。

  3. 選擇Build Phases選項卡,然後單擊 > New Run Script Phase

  4. 展開出現的新運行腳本部分。在腳本字段(位於Shell字段下)中,添加一個新的運行腳本:

    "${PODS_ROOT}/FirebaseCrashlytics/run"
  5. 將您應用的 dSYM 位置添加為輸入文件,讓 Crashlytics 能夠更快地為大型應用自動生成 dSYM。例如:

    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
    

    您還可以將應用的構建Info.plist位置提供給構建階段的Input Files字段:

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

在您將 SDK 添加到您的應用程序後,Crashlytics 會自動開始偵聽和收集崩潰報告。

第 4 步:運行您的項目

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

第 5 步:強制測試崩潰以完成設置

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

有關如何執行此操作的詳細信息,請訪問測試您的實現

下一步