diff --git a/zh-cn/application-dev/device/sample_server_guidelines.md b/zh-cn/application-dev/device/sample_server_guidelines.md index 21a6c7acf144217914c897c6a1bc03905108597c..38e19c79af2d717a7bc87bca767d761e7965be76 100644 --- a/zh-cn/application-dev/device/sample_server_guidelines.md +++ b/zh-cn/application-dev/device/sample_server_guidelines.md @@ -4,16 +4,9 @@ 升级服务示例服务器开发指导的主要工作是为了解决升级服务的实际应用场景测试中缺乏相应搜包服务器提供查询升级包、获取升级包下载url等功能,使得测试升级服务和二次开发功能验证比较困难的问题得到解决,为升级服务的应用场景提供尽可能完善的端到端环境搭建。开发者能够基于此指导快速开发一个简易的搜包服务器用于升级服务应用场景测试。 -## 接口说明 - -| 接口名 | 描述 | -| ------------------------------------------------ | ---------------- | -| int SetParam(const char *key, const char *value) | 设置字段参数值。 | -| int GetParam(const char *key, char *value) | 获取字段参数值。 | - ## 开发步骤 -### 生成SSL证书 +1. 生成SSL证书 会生成serverKey.pem和serverCert.cer两个文件。 @@ -23,7 +16,7 @@ openssl req -newkey rsa:2048 -nodes -keyout serverKey.pem -x509 -days 365 -out s -### 修改bundle.json +2. 修改bundle.json 在build字段的sub_component字段中开始位置新增一行。 @@ -34,17 +27,23 @@ openssl req -newkey rsa:2048 -nodes -keyout serverKey.pem -x509 -days 365 -out s ], ``` -### 下载代码仓 +3. 下载代码仓 通过repo下载OpenHarmony全仓,或者通过git clone下载本代码仓。 ```bash +// repo下载OpenHarmony全仓 +repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify +repo sync -c +repo forall -c 'git lfs pull' + +// git clone下载本代码仓 git clone https://gitee.com/openharmony/update_updateservice.git -b master ``` -### 建立代码目录 +4. 建立代码目录 进入到本仓update_updateservice目录下,执行以下命令,建立代码目录。 @@ -58,7 +57,7 @@ touch server_sample/src/server_process.c // 创建server_process.c文件 touch server_sample/src/main.cpp // 创建main.cpp文件 ``` -### 编译文件BUILD.gn编写 +5. 编译文件BUILD.gn编写 文件BUILD.gn一共编译两个ohos组件,一个是ohos_shared_library库文件libserver_process.z.so,一个是ohos_executable可执行文件testserver。 @@ -103,7 +102,7 @@ ohos_executable("testserver") { } ``` -### 头文件server_process.h编写 +6. 头文件server_process.h编写 文件server_process.h声明了示例服务器的一些接口。 @@ -149,7 +148,7 @@ int Close(); #endif //__SERVER_PROCESS_H__ ``` -### server_process.c、main.cpp编写 +7. server_process.c、main.cpp编写 文件server_process.c主要声明了服务器的返回报文格式respondContent;main.cpp编写在此略去,可参考普通SSL协议的服务器编写,注意包含相关头文件,同时加载serverKey.pem和serverCert.cer两个证书。 @@ -198,11 +197,11 @@ respondContent = "{" "}"; ``` -### 编译输出产物 +8. 编译输出产物 编译输出目录会新增testserver和libserver_process.z.so两个文件。 -### 升级包制作 +9. 升级包制作 参考OpenHarmony的update_packaging_tools仓制作升级包。 @@ -210,7 +209,8 @@ respondContent = "{" https://gitee.com/openharmony/update_packaging_tools ``` -**启动搜包服务器** +10. 启动搜包服务器 + 建议在开发板上新建一个纯英文路径;然后将testserver、libserver_process.z.so、serverCert.cer和serverKey.pem放到同一个目录下,进入该目录,执行以下启动命令即可启动搜包服务器。 diff --git a/zh-cn/application-dev/device/sample_server_overview.md b/zh-cn/application-dev/device/sample_server_overview.md index 923e4da15c8c81fd8a2d9162db99b9fe8b2c9376..fb6c3191655171497484ca44cd84d9e0f6ae80d1 100644 --- a/zh-cn/application-dev/device/sample_server_overview.md +++ b/zh-cn/application-dev/device/sample_server_overview.md @@ -4,35 +4,18 @@ ## 基本概念 -- 搜包服务 +- 搜包服务:升级服务(UpdateService)提供的服务能力之一,依赖环境需要TCP连接并支持SSL协议的服务器。 -升级服务(UpdateService)提供的服务能力之一,依赖环境需要TCP连接并支持SSL协议的服务器。 +- 搜包服务器:即上文支持搜包服务的通过TCP连接并支持SSL协议的服务器,本概述提及的升级服务示例服务器即是符合要求的搜包服务器之一。 -- 搜包服务器 +- 下载服务器:普通的HTTP服务器即可满足下载服务器的要求,可以参考Nginx和Tomcat搭建,并将升级包放在对应路径下。 -即上文支持搜包服务的通过TCP连接并支持SSL协议的服务器,本概述提及的升级服务示例服务器即是符合要求的搜包服务器之一。 +- 设置升级包下载url:在搜包报文的url字段指定升级包下载url即可完成设置。 -- 下载服务器 - - -普通的HTTP服务器即可满足下载服务器的要求,可以参考Nginx和Tomcat搭建,并将升级包放在对应路径下。 - -- 设置升级包下载url - - -在搜包报文的url字段指定升级包下载url即可完成设置。 - -- 系统参数update.serverip.search - - -指升级服务(UpdateService)侧配置的搜包服务器IP地址,默认值:127.0.0.1。 +- 系统参数update.serverip.search:指升级服务(UpdateService)侧配置的搜包服务器IP地址,默认值:127.0.0.1。 ## 约束与限制 -- 客户端请求报文格式Json示例 - -参考升级服务组件搜包相关代码定义格式约束。 - - 服务器返回报文格式Json示例 ```json