Google Analytics是 Firebase 的分析引擎。当您在应用中同时使用 Analytics 和 Crashlytics 时,您会获得一些功能,这些功能可帮助您产生问题并以更细粒度的方式跟踪崩溃数据,例如未发生崩溃的用户、在崩溃之前跟踪特定事件的面包屑以及 BigQuery,其中您可以可视化应用的关键指标。
本指南介绍了如何将 Analytics 添加到已设置 Crashlytics 的应用程序(如果您尚未设置 Crashlytics,请将 Crashlytics 添加到您的应用程序)。
第 1 步:添加 Firebase 配置文件
- 打开您的项目设置。在您的应用卡片中,选择您需要配置文件的应用的捆绑包 ID。
单击下载 GoogleService-Info.plist以获取您的 Firebase Apple 平台配置文件 (
GoogleService-Info.plist
)。您可以随时再次下载您的Firebase Apple 平台配置文件。
确保配置文件名未附加其他字符,例如
(2)
。
将配置文件移动到 Xcode 项目的根目录中。如果出现提示,请选择将配置文件添加到所有目标。
如果您的项目中有多个 bundle ID,则必须将每个 bundle ID 与 Firebase 控制台中注册的应用相关联,以便每个应用都可以拥有自己的GoogleService-Info.plist
文件。
第 2 步:将 Analytics SDK 添加到您的应用程序
使用 Swift Package Manager 安装和管理 Firebase 依赖项。
- 在 Xcode 中,打开您的应用程序项目,导航至File > Swift Packages > Add Package Dependency 。
- 出现提示时,添加 Firebase Apple 平台 SDK 存储库:
- 添加适用于 Google Analytics 的 Firebase SDK,选择包含或不包含 IDFA 集合的库。
- 完成后,Xcode 将自动开始在后台解析和下载您的依赖项。
https://github.com/firebase/firebase-ios-sdk
接下来,配置 Firebase 模块:
- 在您的
UIApplicationDelegate
中导入FirebaseCore
模块,以及您的应用委托使用的任何其他Firebase 模块。例如,要使用 Cloud Firestore 和身份验证:斯威夫特用户界面
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
迅速
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
目标-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- 在您的应用委托的
application(_:didFinishLaunchingWithOptions:)
方法中配置一个FirebaseApp
共享实例:斯威夫特用户界面
// Use Firebase library to configure APIs FirebaseApp.configure()
迅速
// Use Firebase library to configure APIs FirebaseApp.configure()
目标-C
// Use Firebase library to configure APIs [FIRApp configure];
- 如果您使用的是 SwiftUI,则必须创建一个应用程序委托并通过
UIApplicationDelegateAdaptor
或NSApplicationDelegateAdaptor
将其附加到您的App
结构。您还必须禁用应用委托调配。有关详细信息,请参阅SwiftUI 说明。斯威夫特用户界面
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
您的应用现已设置为使用 Google Analytics。
下一步
- 使用DebugView验证您的事件。
- 在Firebase 控制台中探索您的数据。
- 浏览有关事件和用户属性的指南。
- 了解如何将数据导出到BigQuery。