iOS Firebase 集成文档

Firebase 是 google 旗下的移动平台,它能帮助开发者很快的写出Web端和移动端的应用。

官网地址:https://firebase.google.com/

iOS SDK github地址:https://github.com/firebase/firebase-ios-sdk

1、创建应用

进入Firebase控制台(https://console.firebase.google.com/),选择 “添加项目”,设置项目信息;

创建项目.png

2、配置文件

按官网引导下载 “GoogleService-Info.plist”文件移至 Xcode 项目的根目录


下载配置文件.png

plist 文件中包含了应用的 client_id、api_key、bundle_id 等应用信息,用于 firbase sdk 登录、请求api时进行鉴权等,如下:


配置文件内容.png

工程集成Firebase后,调用 [FIRApp configure]SDK会自动检测工程目录下的 GoogleService-Info.plist

另外,工程目录下有多个配置文件,也可以手动指定 Friebase 读取配置文件的路径,代码如下:

let filePath = Bundle.main.path(forResource: "GoogleService-Info", ofType: "plist")!
let options = FirebaseOptions(contentsOfFile: filePath)
FirebaseApp.configure(options: options!)

3、集成 SDK

通过 pod 集成 firebase sdk,根据功能不同如下:

# Firebase 数据采集
pod 'Firebase/Analytics'
    
# Firebase 性能监控
pod 'Firebase/Performance'
    
# Firebase 云推送
pod 'Firebase/Messaging’

# Firebase 崩溃采集
pod 'Firebase/Crashlytics'

在 AppDelegate.m 中,调用 [FIRApp configure];

3-1)信息采集(Analytics)

Google Analytics(分析)是一款免费的应用衡量解决方案,可提供关于应用使用情况和用户互动度的数据分析。
工程集成 Analytics SDK 后,在 AppDelegate.m 中执行 [FIRApp configure]后,便可启动数据采集;
多次启动app、跳转页面,打开 Firebase 控制台即可查看信息采集数据,部分图表如下:


Google Analytics.png

Analytics 会采集一些 firebase 定义的默认事件,如 screen_view(页面跳转)、first_open(首次启动)等多种事件(详见firebase官方文档),也可以自定义采集事件,如下调试采集信息所示:


DebugView.png

其中 screen_view、user_engagement为默认事件,add_inputSN(手动添加)、ad_scanQR(扫码)、sign_up(注册)为手动创建事件

3-2)崩溃分析( Crashlytics)

Firebase Crashlytics 是一个轻量级的实时崩溃报告解决方案,可帮助您对影响应用质量的稳定性问题进行跟踪、确定优先解决顺序并加以修复。 Crashlytics 会对崩溃进行智能分组并突出显示导致这些崩溃的环境因素,从而为您节省问题排查的时间。

工程集成 Crashlytics SDK,然后在工程的主 target 的 Build Phase 中添加一个 New Run Script Phase,增加如下shell:

"${PODS_ROOT}/FirebaseCrashlytics/run"

在 input files 中加入info.plist的路径,如下:

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

然后在工程代码中加入一个崩溃,用于调试;编译工程,断开xcode(官网说会影响 crash 数据收集),多次运行app,触发crash,打开 firebase 控制台 右侧栏选择 Crashlytics ,显示如下则代表控制台已检测到crash上报:


Crashlytics.png

正式集成的包需要上传打包时的 dSYM 才能生成崩溃分析报告;

3-3)性能监控(Performance)

Performance SDK 收集应用的性能数据,然后在 Firebase 控制台中查看和分析这些数据。性能监控服务可帮助了解何时可以改进应用性能以及改进哪些方面,以便根据这些信息来修复性能问题。

工程集成 Performance SDK 后,在 AppDelegate.m 中执行 [FIRApp configure]后,便可启动数据采集;
如下为采集时 xcode 控制台打印的日志,firebase 尚未检测到 Performance SDK 被集成(待解决):


Performance.png

3-4)云消息(Cloud Messaging)

Firebase Cloud Messaging (FCM) 是一种跨平台消息传递解决方案,可供您可靠地传递消息,且无需任何费用。

使用 FCM 需要配置 iOS 推送证书(APNs证书)或 APNs p8 文件(token & key),如下:


Cloud Messaging.png

配置证书好后,可在 firebase 控制台发布消息,如下:


FCM.png

你可能感兴趣的:(iOS Firebase 集成文档)