HarmonyOS开发者社区

迁移到 6.1 时，不建议只按“接口名替换”处理，重点要看能力边界、权限模型和异步时序是否发生变化。通常可以从三层排查：

1. 能力检测先行。新 API 可能依赖更细的 SystemCapability、设备形态或 API version，代码里要先判断能力是否存在，再决定走新实现还是旧实现降级。
2. 权限从“声明即可用”转向“按场景申请、按数据最小化访问”。相册、位置、后台、相机、支付、分布式等能力尤其要检查权限类型、申请入口、用户授权结果和失败兜底。
3. 性能上新接口往往更强调批量、异步、懒加载和系统托管能力。迁移时不要把旧版同步流程直接包一层 await，而要重新梳理资源创建、释放、回调注销和错误码处理。

建议迁移顺序是：先列出旧接口清单，再逐个确认替代 API、起始版本、权限、错误码、生命周期和降级方案。上线前至少覆盖低版本设备、未授权、拒绝授权、能力不支持、横竖屏/折叠状态变化几类场景。这样迁移会比单纯追新 API 稳定得多。