神马笔记 版本2.1——软件更新·数据篇

一、目标

梳理软件更新功能涉及到的数据，以保证数据安全性。

二、体验地址

神马笔记最新版本下载：【神马笔记 版本2.1.0——软件更新功能.apk】

三、实现方案

1. 版本信息

• VersionEntry

名称	类型	说明	示例
title	string	软件标题	神马笔记
name	string	版本名称	2.1
developer	string	开发者名称	Amoy Inc.
size	long	安装包大小，字节数	3210782
brief	string	概要介绍，markdown格式
detail	string	详细介绍，markdown格式
*code	int	版本号	26
*checksum	string	校验码
*source	string	下载地址

需要注意的是，没有*号字段仅用于向用户显示，不会参与业务逻辑。

带*号字段，code，checksum，source这3个字段参与软件更新的业务逻辑。一旦发现3个字段发生变化，将触发重新下载安装包文件。

2. 更新信息

• UpdateEntry

名称	类型	说明	示例
downloadId	string	下载任务ID
downloadCode	string	下载的版本号	26
downloadChecksum	string	下载的校验码
daily	string	检查更新的时间	2019-04-08
version	VersionEntry	版本信息

UpdateEntry用于记录软件更新的用户操作数据，以支持整个更新流程。

3. 下载信息

• DownloadEntry

名称	类型	说明	示例
id	string	唯一标识符
source	string	HTTP源地址，远程
destination	string	File目标地址，本地
length	long	文件大小，将第一次响应的ContentLength作为文件大小。 注意跟VersionEntry#size的含义不同

• DownloadTable

名称	类型	说明	示例
list	List<DownloadEntry>

DownloadEntry和DownloadTable用于支持文件下载功能。

与UpdateEntry#downloadId配合，可以查询到下载的源地址及目标地址。

4. 配置信息

• ConfigEntry

名称	类型	说明	示例
debug	boolean	是否开启调试模式	false
baseUrl	string	服务接口的基地址

ConfigEntry为只读数据，用户无关。

是为了调试应用的特定功能而设计，例如：

发布新版本信息时，必须在测试环境下进行测试，保证一切稳定后，才会发布到正式环境中。

通过配置ConfigEntry，可以在不改动代码的情况下，切换测试与正式环境。

四、组合起来

首先，读取ConfigEntry应用配置信息，

其次，用户进入软件更新界面时，请求VersionEntry，

服务返回版本信息后，保存到UpdateEntry中，

用户下载安装包时，创建DownloadEntry，并将相关信息保存到UpdateEntry中。

五、Finally

～自在飞花轻似梦～无边丝雨细如愁～