用途:MetricKit 用于低开销采集与分析生产环境 iOS/iPadOS 性能遥测,作为 Instruments 与 Xcode Organizer 本地分析的补充。iOS/iPadOS 27 起推荐使用 Swift 优先的 MetricManager 报告序列,MXMetricManager 仅保留于 iOS 26 兼容分支。
主要能力:在应用启动时创建一个长期持有的 MetricManager,并分别为 metricReports 与 diagnosticReports 各启动一个消费者任务;两者均为 AsyncSequence。MetricReport 可编码且可发送,包含 timeRange、环境元数据、intervalEntries 与 stateEntries,通常按天到达;诊断报告为事件型,包含 CrashDiagnostic、HangDiagnostic、CPUExceptionDiagnostic、DiskWriteExceptionDiagnostic、AppLaunchDiagnostic 与 iOS 27 新增的 MemoryExceptionDiagnostic。诊断处理应使用 @unknown default 并保留原始报告。自定义区间指标通过 manager.logHandle(category:) 与 mxSignpost 的 begin/end 创建,聚合结果为 MetricResult.signpostInterval。
使用方式:先编码完整报告,原子化入队到应用自有的耐久 outbox,再异步上传并支持重试、退避、批量与保留限制。启动扩展测量使用 trackLaunchTask(id:onTrackingError:_:),其结果为 MetricResult.extendedLaunch。
限制:iOS 27 接口基于当前 beta 文档,尚未在本地编译器验证,发布前需以正式 Xcode 27 SDK 重新核对编译。诊断报告受系统采样与资格限制,并非每次事件都会生成。不能将每日聚合当作单次用户操作的精确追踪,也不能在序列消费循环内直接同步上传。版本兼容需用可用性检查隔离 iOS 26 的 MXMetricManager 路径。