1.1 离线优先的定义

离线优先（Offline-First）是一种应用设计理念，将离线能力视为一等公民，而非网络不可用时的降级方案。应用在本地持久化核心数据，用户操作直接写入本地存储，随后通过后台同步引擎与远程服务器交换变更。网络状态仅影响同步进度，不影响核心功能使用。与之相对，传统在线应用依赖于“始终在线”假设，网络中断即导致功能不可用或数据丢失。

1.2 离线优先 vs 传统在线应用

1.3 典型业务场景与离线策略

• 社交应用（如微信、Slack）：消息发送立即写入本地数据库，并标记为“发送中”；后台同步时检查远程状态，更新送达回执。离线时用户仍可浏览历史消息、编辑草稿。
• 笔记应用（如Notion、OneNote）：用户新建/编辑文档直接落地到本地SQLite（Room），同步引擎在后台合并段落级差异。冲突时采用“最后写入者胜”或手动合并UI。
• 电商应用（如购物车、商品浏览）：商品信息缓存在本地，用户添加商品到购物车时立即更新本地购物车表，同步时将增量变更发送给服务端，服务端校验库存并返回结果。

1.4 核心技术栈预览

实现离线优先Android应用需要以下组件协同工作：

• 本地持久化：Room（SQLite抽象层），定义Entity、DAO，提供线程安全的数据访问。
• 同步引擎：WorkManager + 自定义SyncAdapter，定期或触发式拉取远程变更。
• 冲突解决：基于时间戳或向量时钟的合并策略，提供UI让用户手动处理。
• 网络状态监听：ConnectivityManager + LiveData/Flow，根据网络变化调整同步策略。

最小依赖配置（app/build.gradle）：

dependencies {
    implementation "androidx.room:room-runtime:2.6.1"
    implementation "androidx.room:room-ktx:2.6.1"
    ksp "androidx.room:room-compiler:2.6.1"
    implementation "androidx.work:work-runtime-ktx:2.9.0"
    implementation "com.google.code.gson:gson:2.10.1"
}