跳到主要内容

日志概览

AIBudsLogSDK 为 AIBuds SDK 模块和 App 提供进程级日志入口。当前启用的 LogService 负责记录消息、导出保留的日志并清理过期条目。

功能概览​

使用 AI 辅助实现

使用 AI 开发

让 AI 帮助实现此工作流

使用官方“管理 AIBuds 日志”技能，根据你的 App 完成实现。

请阅读并遵循 https://docs-aibuds.github.io/zh-Hans/skills/manage-aibuds-logs，使用该技能在当前 iOS 项目中完成“管理 AIBuds 日志”，并验证结果。
查看官方技能

日志模型​

LogConfiguration 控制：

设置默认值用途
level.info默认日志器记录的最低严重级别。
destination.xlfacility当前输出目标。
logsDirectory.aibuds/logs相对于 Documents 的文件输出目录。
maxFileSize10,000,000 字节单个日志文件的最大大小。
logFileMaxAge3 天日志清理使用的保留期限。

LogDestination 支持 .console、.oslogger、.file 和 .xlfacility，同一时间只能启用一个目标。

集成流程​

  1. 在 App 启动早期配置级别、输出目标、存储和保留设置。
  2. 使用 .xlfacility 时，在写入日志前安装 AIBudsXLFacility 插件。
  3. 通过 AIBudsLogSDK.logService 记录消息，或让 AIBuds 模块共用该服务。
  4. 通过当前 LogService 导出或清理日志。

重要行为​

  • Console 和 OS Logger 输出目标不支持导出。
  • File 和 XLFacility 输出目标支持导出与保留清理。
  • 未安装自定义服务时，AIBudsLogSDK.logService 返回内置 DefaultLogger。
  • 未配置插件却选择 .xlfacility 时，会在控制台输出错误，且无法通过 XLFacility 持久化或导出日志。