用途:用于诊断 iOS 应用中的本地文件存储问题,应对“文件消失”“重启后数据丢失”“备份过大”“无法保存文件”“找不到文件”“存储已满”等报告。核心判断是:多数问题源于存储位置选错、文件保护级别理解错误或未设置备份排除,而非文件系统缺陷。
主要能力:提供按症状排查的诊断流程与决策树,覆盖三类场景。文件消失类:区分 tmp/(重启即被清理)、Caches/(存储压力下被清理)、Documents/ 与 Library/Application Support/(不会被清理且会备份)的差异;文件不可访问类:检查文件保护级别(如 .complete 在设备锁定时不可读)与后台任务访问冲突;备份过大类:审计 Documents 与 Application Support 目录大小,将可重新下载的内容标记为不备份。
使用方式:先运行诊断检查,依次查看文件所在路径、protectionKey 保护级别、isExcludedFromBackup 状态、文件是否存在及大小、父目录体积,再据结果按决策树定位根因。若要修改代码,示例包括将临时数据从 temporaryDirectory 改到 cachesDirectory,后台访问文件改用 .completeFileProtectionUntilFirstUserAuthentication,为可重新下载内容设置 isExcludedFromBackup = true。
适用场景:iOS 应用中文件异常消失、用户数据丢失、后台任务权限报错、应用备份体积过大等排查。
限制:资料未提供该技能的安装命令、平台支持范围、收费方式与具体版本要求;相关参考技能(axiom-storage、axiom-file-protection-ref、axiom-storage-management-ref)的具体内容暂未提供。