用途:MetricKit 用于以低开销收集和分析生产环境 iOS/iPadOS 的性能遥测,与本地 Instruments、Xcode Organizer 分析互补。iOS/iPadOS 27 起推荐 Swift 优先的 MetricManager 报告序列;MXMetricManager 仅保留在显式 iOS 26 兼容分支。
主要能力:在应用启动时创建一个长期持有的 MetricManager,为 metricReports 与 diagnosticReports 各启动恰好一个消费任务;两个属性均为非抛错 AsyncSequence。MetricReport 为 Codable 且 Sendable,含 timeRange、环境元数据、intervalEntries 与 stateEntries,通常按日到达;DiagnosticReport 同样 Codable 且 Sendable,含 timeRange、必需环境元数据和单个 DiagnosticResult,覆盖崩溃、挂起、CPU 异常、磁盘写入异常、应用启动与内存异常(iOS 27 新增)等类型。CallStackTree 提供 forEachFrame、callStackThreads、binaryInfo。自定义区间经 manager.logHandle(category:) 与 mxSignpost 的 begin/end 生成 MetricResult.signpostInterval。扩展启动可用 trackLaunchTask。
使用方式:先持久化完整报告再解析结果,字符串按 @unknown default 分支保留未知类型;用 JSONEncoder 编码后原子入队到应用自有持久 outbox,记录类型、模式版本、应用版本与去重键,之后异步重试上传,勿在序列循环内同步上传。符号化需保留二进制标识与偏移及匹配 dSYM。
适用场景与限制:适合生产症状与趋势识别,而非本地复现;诊断报告是系统采样产生的,不保证每次事件都生成。开发设备运行不能复现生产报告的总体、频率与聚合。iOS 27 相关接口基于当前 beta 文档,尚未用 Xcode 27 编译验证,发布前需核对 Apple 文档并用正式 SDK 编译。