获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

开始使用适用于 Apple 平台的性能监控

在你开始之前

如果您还没有,请将 Firebase 添加到您的 Apple 项目中。

第 1 步:将性能监控添加到您的应用程序

添加性能监控 SDK 后,Firebase 会自动开始收集应用的屏幕渲染数据、与应用生命周期相关的数据(如应用启动时间)以及HTTP/S 网络请求的数据。

使用 Swift Package Manager 安装和管理 Firebase 依赖项。

  1. 在 Xcode 中,打开您的应用项目,导航到File > Add Packages
  2. 出现提示时,添加 Firebase Apple 平台 SDK 存储库:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. 选择性能监控库。
  5. 完成后,Xcode 将在后台自动开始解析和下载您的依赖项。

接下来,配置 Firebase 模块:

  1. 在您的UIApplicationDelegate中导入FirebaseCore模块,以及您的应用委托使用的任何其他Firebase 模块。例如,要使用 Cloud Firestore 和身份验证:

    迅速

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 在您的应用委托的application(_:didFinishLaunchingWithOptions:)方法中配置FirebaseApp共享实例:

    迅速

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

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  1. 重新编译您的应用程序。

第 2 步:为初始数据显示生成性能事件

当您成功将 SDK 添加到您的应用时,Firebase 开始处理这些事件。如果您仍在本地开发,请与您的应用交互以生成用于初始数据收集和处理的事件。

  1. 继续使用模拟器或测试设备开发您的应用程序。

  2. 通过在后台和前台之间多次切换您的应用程序、通过跨屏幕导航与您的应用程序交互和/或触发网络请求来生成事件。

  3. 转到 Firebase 控制台的性能信息中心。您应该会在几分钟内看到您的初始数据显示。

    如果您没有看到初始数据的显示,请查看故障排除提示

第 3 步:(可选)查看性能事件的日志消息

  1. 启用调试日志记录,如下所示:

    1. 在 Xcode(最低 v13.3.1)中,选择Product > Scheme > Edit scheme
    2. 从左侧菜单中选择运行,然后选择参数选项卡。
    3. 启动时传递的参数部分,添加-FIRDebugEnabled
  2. 检查您的日志消息中是否有任何错误消息。

  3. 性能监控使用Firebase/Performance标记其日志消息,以便您可以过滤日志消息。

  4. 检查以下类型的日志,这些日志表明性能监控正在记录性能事件:

    • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL
  5. 单击 URL 以在 Firebase 控制台中查看您的数据。数据在仪表板中更新可能需要一些时间。

如果您的应用没有记录性能事件,请查看故障排除提示

第 4 步:(可选)为特定代码添加自定义监控

要监控与应用中特定代码相关的性能数据,您可以检测自定义代码跟踪

使用自定义代码跟踪,您可以测量应用程序完成特定任务或一组任务需要多长时间,例如加载一组图像或查询您的数据库。自定义代码跟踪的默认指标是其持续时间,但您也可以添加自定义指标,例如缓存命中和内存警告。

在您的代码中,您可以使用性能监控 SDK 提供的 API 定义自定义代码跟踪的开始和结束(并添加任何所需的自定义指标)。

访问为特定代码添加监控以了解有关这些功能以及如何将它们添加到您的应用程序的更多信息。

第 5 步:部署您的应用程序,然后查看结果

在您使用 Xcode 模拟器和一台或多台测试设备验证性能监控后,您可以将应用程序的更新版本部署给您的用户。

您可以在 Firebase 控制台的性能信息中心监控性能数据。

已知的问题

  • 性能监控已知与 GTMSQLite 的兼容性问题。我们建议不要对使用 GTMSQLite 的应用程序使用性能监控。
  • 调用FirebaseApp.configure()后的方法调配可能会干扰性能监控 SDK。
  • iOS 8.0-8.2 模拟器的已知问题会阻止性能监控捕获性能事件。这些问题已在 iOS 8.3 Simulator 及更高版本中得到修复。
  • 使用 NSURLSession 的backgroundSessionConfiguration建立的连接将比预期的连接时间长。这些连接在进程外执行,时间反映进程内回调事件。

下一步