1# 示例服务器开发概述
2
3示例服务器提供一个简易的升级包部署的服务器实例参考，用于搭建升级服务子系统的辅助验证环境。
4
5## 场景介绍
6
7开发者在实际应用中，需要服务器提供升级包的查询、下载等能力。示例服务器为开发者提供了如下能力:
8
9- 升级包的查询: 服务器返回升级包的版本信息。
10
11- 升级包的下载: 服务器返回升级包的下载链接。
12
13示例服务器支持测试升级服务和二次开发功能验证，为升级服务的应用场景提供尽可能完善的端到端环境搭建。
14
15## 基本概念
16
17- 搜包服务：升级服务（UpdateService）提供的服务能力之一，依赖支持TCP和SSL协议的服务器。
18
19- 搜包服务器：即支持搜包服务的通过TCP连接并支持SSL协议的服务器，本概述提及的升级服务示例服务器即是符合要求的搜包服务器之一。
20
21- 下载服务器：普通的HTTP服务器即可满足下载服务器的要求。
22
23- update.serverip.search：系统参数，指升级服务（UpdateService）侧配置的搜包服务器IP地址，默认值：127.0.0.1。
24
25## 约束与限制
26
27- 服务器返回报文格式json示例，注意verifyInfo字段是升级包的sha256值，size字段是升级包的大小，单位为字节。
28
29```json
30{
31    "searchStatus": 0,
32    "errMsg": "success",
33    "checkResults": [{
34        "versionName": "versionNameSample",
35        "versionCode": "versionCodeSample",
36        "verifyInfo": "verifyInfoSHA256Value1234567",
37        "size": 1234567,
38        "packageType": 1,
39        "url": "http://serverAddressSample/packageNameSample.fileTypeSample",
40        "descriptPackageId": "abcdefg1234567ABCDEFG"
41    }],
42    "descriptInfo": [{
43        "descriptionType": 0,
44        "content": "This package is used for update."
45    }]
46}
47```
48
49