siegrainwong / To Do
Projects that are alternatives of or similar to To Do
TO-DO
简介
- 这是一个无后端的待办事项应用，数据用LeanCloud进行同步，也是我的第三个 iOS 项目。
- 做这个项目的初衷是想比较全面地体现我的前后端水平，该同步算法从整理思路到实现95%的代码（意为接近稳定）花了两周时间，除思路外没有任何代码可以参考（反正我是没有找到...
- 界面设计来源于 DO ，部分素材和界面为本人设计。
- 该项目于 2016-12-29 日第一版开发完成，之前由于意外收录可能有些朋友 clone 的是不稳定版，还请重新下载一次。
项目演示
一共6张GIF，共9M，请耐心等待。
测试服务器
为了方便大家观察服务器的数据，测试账号已公开，要是有什么情况请通知我，（当然万一发生了类似超额的情况我不一定会解决），另一方面会这样做的主要原因是自己搭建的话可能比较麻烦。
注：从2016年12月31日起，该项目中的所有的第三方API Key已经换成测试账号中的新秘钥，且之前的 API Key 都被弃用。
LeanCloud 账号
七牛账号（存放头像）
高德
高德 Key 要 BundleID，请各位自行配置，不用地图也一样。
自己搭建
该项目一共接入了三个第三方服务，分别为七牛、LeanCloud 和高德地图，对应的 API Key 各位请向服务商申请，然后在 SGAPIKeys.h 中进行配置。
除此之外，LeanCloud 的配置请参考 TO-DO 的 LeanCloud 配置指南 ，这是必需的，毕竟 LeanCloud 的 SDK 没有提供类似事务的功能。
同步算法、思路等
如果你对这个感兴趣的话，请查看以下内容，并对照相应代码进行理解。
相关代码位于 SGSyncManager.m 和配置于 LeanCloud 云函数中的 nodejs 代码。
思路来源
该同步思路来源于以下两篇回答，并根据项目需求总结而来。
服务端和各种客户端（手机端，平板端，web端）怎样进行数据同步？
同步方式
每一批次两个并行队列，每次最多同步X条数据，超过X条下次进行同步。
每批同步分上传和下载（与队列不对应），若上传或下载数超过上限，则下一批次同步。
同步类型
- 若本地没有同步记录，则将本地所有数据进行上传，并将服务器上所有的数据进行下载（Incremental Sync）
- 若
lastSyncTimeOnServer = lastSyncTimeOnClient，表明服务器数据没有变化，则仅需要上传本地修改过的数据和新增的数据（Send Changes） - 若
lastSyncTimeOnServer > lastSyncTimeOnClient，则进行全量同步，先对比同步所有已有数据，再将其他数据从服务器上下载(Full Sync) - 其他情况进行（Incremental Sync）
注意事项
- 所有同步时间戳均以服务器时间为准，每次同步之前先获取服务器的时间戳
- 对比同步规则：1.大版本同步小版本 2.版本相同的话，以线上数据为准进行覆盖（另一种做法是建立冲突副本，根据本项目的实际情况不采用这种方式）
异常情况
以下几种情况会影响同步时数据的原子性：
- 云函数返回之前挂掉：下次同步则为full sync，同时在对比时会将objectId赋值给本地对应的待办事项。
- 若在批次之间挂掉的话（上一批成功，下一批挂掉），这时需要在判断同步类型时，判断上一次同步成功的记录次数，若次数超限，此次同步为full sync。
同步难点
- 处理各种异常情况，保证数据的一致性和原子性
- 同步效率
- 分批同步
同步流程
同步稳定性
从我大致写好同步功能（2016-6-20）到今天（2016-12-30）一共产生了3300条同步记录，暂时没有发现数据错误的地方，如果各位发现这方面有什么问题和Bug请一定提交 issue，非常感谢。
同步记录截图：
License
TO-DO is available under the MIT license. See the LICENSE file for more info.