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