SuperAPI AI 工具集

appmigrationkit

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

AppMigrationKit 提供一次性跨平台应用资源迁移能力,使应用在设备设置或引导阶段把数据导出到另一平台或从另一平台导入。适用平台为 iOS 26.0+ / iPadOS 26.0+,数据容器权限为 iOS 26.1+ / iPadOS 26.1+ / Mac Catalyst 26.1+,语言为 Swift 6.3。资料标注为 Beta 敏感,具体 API 细节可能变化,使用前应重新核对 Apple 文档。

工作方式:采用 App Extension 模型,由系统编排设备间传输,应用提供符合导出与导入协议的扩展,系统在适当时机调用该扩展;应用本身不管理设备间网络连接。

典型流程:确认平台可用性、迁移权限、扩展目标与共享容器布局;清点可迁移资源、稳定路径、大小上限、版本与来源应用标识;通过 ResourcesArchiver 直接导出,保持追加间隔有界并传递进度与取消;导入需事务化,校验每个资源、保留可恢复证据,并在成功或失败后清理 app-group 状态;用 AppMigrationTester 验证取消、部分归档、版本偏差、低存储、重试与状态清除等场景。

主要 API 与要求:扩展需符合 ResourcesExportingWithOptions 或 ResourcesExporting(导出)以及 ResourcesImporting(导入);需添加 com.apple.developer.app-migration.data-container-access 权限,权限数组只含包含应用的 bundle identifier;resourcesSizeEstimate 返回合理字节估计,resourcesVersion 用于导入时的格式兼容检查;包含应用首次启动时检查 MigrationStatus.importStatus,处理完后调用 clearImportStatus()。

常见限制与错误:不应捕获 ResourcesArchiver 抛出的取消错误,否则系统会终止扩展;不要在 append 调用之间留长间隔,以免被系统判定挂起而终止;导出时不要把文件转成中间格式,避免临时副本耗尽磁盘;导入出错时系统会清应用容器但不会清 app group,需先清理 app group 再写入;处理完导入状态后必须清除,否则迁移界面每次启动都会显示。

适用场景为设备设置或引导期间的一次性迁移,不涉及设备间网络连接管理。其他细节可参见扩展模式文档 references/appmigrationkit-patterns.md 及官方框架文档。