SuperAPI AI 工具集

android-serialization-offline-sync

数据与分析

查看项目

更新于 10-16 06:22

技能介绍

用途:当请求涉及 Android 离线同步、序列化模型映射、缓存冲突解决时使用本技能,主要目标是协调 Android 应用中的序列化、缓存、冲突处理与离线优先同步流程。

适用与衔接:范围扩大时可交接给 android-networking-retrofit-okhttp 与 android-room-database 两个相邻技能。

工作流程:先确认数据源、持久化边界、同步模型与设备能力;在接入网络、存储、媒体或后台 API 前显式建模契约;采用推荐的 AndroidX 或平台模式并保证迁移安全;针对示例应用与场景验证离线、重试与进程死亡行为;必要时把安全、性能或发布风险升级给支持的关联技能。

约束:优先使用类型化模型与显式序列化器,而非临时 map 或 bundle;后台任务保持幂等并可取消;不把存储、媒体或网络细节泄露到表现层;将用户数据持久性、隐私与迁移路径视为实现的一部分。

反模式:用磁盘或网络调用阻塞主线程;把可重试的同步失败当作面向用户的终止性错误;不经映射层直接混用缓存模型与网络模型;在存在更窄 API 时申请宽泛的存储或通知权限。

示例:正常路径可用 cd examples/orbittasks-compose && ./gradlew :app:testDebugUnitTest;边界情况用 cd examples/orbittasks-xml && ./gradlew :app:testDebugUnitTest;失败恢复验证用 python3 scripts/eval_triggers.py --skill android-serialization-offline-sync。

完成检查:实现路径明确、最小并绑定正确的 Android 接口;相关示例命令与基准提示已执行或更新;跨边界时记录相邻技能交接;官方参考覆盖所选模式及主要迁移或排障路径。

官方参考:https://developer.android.com/topic/architecture/data-layer/offline-first、https://developer.android.com/kotlin/parcelize、https://kotlinlang.org/docs/serialization.html、https://developer.android.com/topic/architecture/data-layer。其他具体实现细节与更多场景示例暂未提供。