Google is committed to advancing racial equity for Black communities. See how.
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

開始使用Firebase Crashlytics

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

在你開始之前

  1. 如果尚未將Firebase添加到您的iOS項目中。如果您沒有iOS應用,則可以下載示例應用

  2. 可選:要獲取崩潰指標,例如無崩潰用戶,麵包屑和自定義事件,您需要在Firebase項目中啟用Google Analytics(分析)。

    1. 如果您現有的Firebase項目未啟用Google Analytics(分析),則可以從“ >“項目設置”的“ 集成”標籤中啟用Google Analytics(分析)。

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

    2. 最後,在Google Analytics(分析)控制台中,在“管理”標籤>“帳戶設置” >“數據共享設置”中啟用數據共享。

      對於較舊的Firebase項目,請注意,您可能需要在 >項目設置(在Firebase控制台中)的“ 集成”選項卡中啟用數據共享。

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

  1. Firebase控制台的左側導航面板中,單擊Crashlytics

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

  3. 單擊“啟用Crashlytics”

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

  1. 打開您為Firebase項目創建的Podfile,然後添加FirebaseCrashlytics Pod。為了獲得Firebase Crashlytics的最佳體驗,我們建議您通過在應用程序中添加適用於Google Analytics(分析)的Firebase Pod,在項目中啟用Google Analytics(分析)。確保您添加了Google Analytics(分析)6.3.1或更高版本,以獲取無崩潰的實時用戶和麵包屑。

    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. 將Firebase模塊導入UIApplicationDelegate

    迅速

    import Firebase

    物鏡

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

    迅速

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

    物鏡

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      
  5. 重新編譯您的應用程序。

步驟3 :初始化Crashlytics

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

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

  2. 從“選擇項目或目標”下拉列表中,選擇您的主要構建目標。

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

  4. 展開出現的新的“運行腳本”部分。在腳本字段(位於命令行管理程序字段下)中,添加一個新的運行腳本:

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

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

    您還可以在構建階段的“輸入文件”字段中提供應用程序的構建Info.plist位置:

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

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

步驟4 :執行專案

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

下一步