Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
ba1f9c17
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
ba1f9c17
编写于
4月 22, 2022
作者:
O
openharmony_ci
提交者:
Gitee
4月 22, 2022
浏览文件
操作
浏览文件
下载
差异文件
!3198 Upload Readme
Merge pull request !3198 from 创世纪边缘/master
上级
a7c1ec95
b581c531
变更
3
隐藏空白更改
内联
并排
Showing
3 changed file
with
240 addition
and
0 deletion
+240
-0
zh-cn/application-dev/device/Readme-CN.md
zh-cn/application-dev/device/Readme-CN.md
+3
-0
zh-cn/application-dev/device/sample-server-guidelines.md
zh-cn/application-dev/device/sample-server-guidelines.md
+199
-0
zh-cn/application-dev/device/sample-server-overview.md
zh-cn/application-dev/device/sample-server-overview.md
+38
-0
未找到文件。
zh-cn/application-dev/device/Readme-CN.md
浏览文件 @
ba1f9c17
...
...
@@ -13,3 +13,6 @@
-
振动
-
[
振动开发概述
](
vibrator-overview.md
)
-
[
振动开发指导
](
vibrator-guidelines.md
)
-
升级服务
-
[
示例服务器开发概述
](
sample-server-overview.md
)
-
[
示例服务器开发指导
](
sample-server-guidelines.md
)
zh-cn/application-dev/device/sample-server-guidelines.md
0 → 100644
浏览文件 @
ba1f9c17
# 示例服务器开发指导
## 场景介绍
示例服务器解决了升级服务器实际应用场景中,缺乏相应搜包服务器提供查询升级包、获取升级包下载url等问题,支持测试升级服务和二次开发功能验证,为升级服务的应用场景提供尽可能完善的端到端环境搭建。
## 开发步骤
1.
生成SSL证书
生成serverKey.pem和serverCert.cer两个文件,用于示例服务器的SSL协议通信。
```
openssl req -newkey rsa:2048 -nodes -keyout serverKey.pem -x509 -days 365 -out serverCert.cer -subj "/C=CN/ST=GD/L=GZ/O=abc/OU=defg/CN=hijk/emailAddress=test.com"
```
2.
修改bundle.json
在build字段新增一个sub_component。
```
"sub_component": [
"//base/update/updateservice/server_sample:testserver",
...
],
```
3.
建立代码目录
进入到update_updateservice目录下,执行以下命令,建立代码目录。
```
mkdir server_sample // 建立示例服务器server_sample目录
touch server_sample/BUILD.gn // 创建BUILD.gn编译文件
mkdir server_sample/include // 建立示例服务器头文件include目录
touch server_process.h // 创建server_process.h头文件
mkdir server_sample/src // 建立示例服务器c/c++文件src目录
touch server_sample/src/server_process.c // 创建server_process.c文件
touch server_sample/src/main.cpp // 创建main.cpp文件
```
4.
编写编译文件BUILD.gn
文件BUILD.gn一共编译两个ohos组件,一个是ohos_shared_library库文件libserver_process.z.so,另一个是ohos_executable可执行文件testserver。
```
import("//build/ohos.gni")
ohos_shared_library("server_process") {
sources = [
"//base/update/updateservice/server_sample/src/server_process.c",
]
include_dirs = [
"//base/update/updateservice/server_sample/include",
"//third_party/openssl/include",
]
deps = [
"//base/update/updater/services/log:libupdaterlog",
"//third_party/bounds_checking_function:libsec_static",
"//third_party/openssl:crypto_source",
"//third_party/openssl:ssl_source",
"//utils/native/base:utils",
]
part_name = "update_service"
}
ohos_executable("testserver") {
sources = [
"//base/update/updateservice/server_sample/src/main.cpp",
]
include_dirs = [
"//base/update/updateservice/server_sample/include",
]
deps = [
"//base/update/updateservice/server_sample:server_process",
]
part_name = "update_service"
}
```
5.
编写头文件server_process.h
文件server_process.h声明了示例服务器的接口。
```c++
#ifndef __SERVER_PROCESS_H__
#define __SERVER_PROCESS_H__
/*
Init函数:用于创建socket环境,并预设置一些属性
*/
int Init();
/*
SetParam函数:所有插件参数设置的统一接口
*/
int SetParam(const char *key, const char *value);
/*
GetParam函数:所有插件参数获取的统一接口
*/
int GetParam(const char *key, char *value);
/*
ReverseSetParamCallback函数:回调
*/
int ReverseSetParamCallback(int(*setParam)(const char *key, const char *value));
/*
Open函数:用于服务打开的接口
*/
int Open();
/*
MainLoop函数:每隔100ms调用一次
*/
int MainLoop();
/*
Close函数,用于关闭服务并释放资源
*/
int Close();
#endif //__SERVER_PROCESS_H__
```
6.
编写server_process.c、main.cpp
文件server_process.c主要声明了服务器的返回报文格式respondContent,main.cpp可参考普通SSL协议的服务器编写,注意包含相关头文件,同时加载serverKey.pem和serverCert.cer两个证书。
```c
#include "server_process.h"
#include <netinet/in.h>
#include <sys/types.h>
#include <sys/socket.h>
#include <arpa/inet.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>
#include <stdio.h>
#include "openssl/err.h"
#include "openssl/ssl.h"
#define SERVER_PEM "/data/sdcard/serverKey.pem" //使用绝对路径
#define SERVER_CER "/data/sdcard/serverCert.cer" //使用绝对路径
#define LOG_PRINT(fmt, ...) printf("[ServerProcess][%s:%d] " fmt "\n", __func__, __LINE__, ##__VA_ARGS__)
#define DO_CHECK(cond, log, ...) \
if (!(cond)) {\
LOG_PRINT(log);\
__VA_ARGS__;\
return -1;\
}
// 请参考server_process.h的接口予以实现,注意服务器返回的内容格式。
respondContent = "{"
"\"searchStatus\": 0,"
"\"errMsg\": \"success\","
"\"checkResults\": [{"
"\"versionName\": \"sampleVersionName\","
"\"versionCode\": \"sampleVersionCode\","
"\"verifyInfo\": \"sampleVerifyInfoSha256Value\","
"\"size\": 1234567,"
"\"packageType\": 1,"
"\"descriptPackageId\": \"abcdefg1234567ABCDEFG\","
"}],"
"\"descriptInfo\": [{"
"\"descriptPackageId\": \"abcdefg1234567ABCDEFG\","
"\"content\": \"This package message is used for sampleContent\""
"}]"
"}";
```
7.
编译输出产物
编译输出目录会新增testserver和libserver_process.z.so两个文件。
8.
升级包制作
参考[update_packaging_tools仓](https://gitee.com/openharmony/update_packaging_tools)制作升级包。
9.
启动搜包服务器
建议在开发板上新建一个纯英文路径,然后将testserver、libserver_process.z.so、serverCert.cer和serverKey.pem放到同一个目录下,进入该目录,执行以下启动命令即可启动搜包服务器。
```
./testserver ./libserver_process.z.so &
```
zh-cn/application-dev/device/sample-server-overview.md
0 → 100644
浏览文件 @
ba1f9c17
# 示例服务器开发概述
示例服务器提供一个简易的升级包部署的服务器实例参考,用于升级服务子系统的辅助验证环境搭建。
## 基本概念
-
搜包服务:升级服务(UpdateService)提供的服务能力之一,依赖支持TCP和SSL协议的服务器。
-
搜包服务器:即支持搜包服务的通过TCP连接并支持SSL协议的服务器,本概述提及的升级服务示例服务器即是符合要求的搜包服务器之一。
-
下载服务器:普通的HTTP服务器即可满足下载服务器的要求。
-
update.serverip.search:系统参数,指升级服务(UpdateService)侧配置的搜包服务器IP地址,默认值:127.0.0.1。
## 约束与限制
-
服务器返回报文格式Json示例,注意verifyInfo字段是升级包的sha256值,size字段是升级包的大小,单位为字节。
```
json
{
"searchStatus"
:
0
,
"errMsg"
:
"success"
,
"checkResults"
:
[{
"versionName"
:
"versionNameSample"
,
"versionCode"
:
"versionCodeSample"
,
"verifyInfo"
:
"verifyInfoSHA256Value1234567"
,
"size"
:
1234567
,
"packageType"
:
1
,
"url"
:
"http://serverAddressSample/packageNameSample.fileTypeSample"
,
"descriptPackageId"
:
"abcdefg1234567ABCDEFG"
}],
"descriptInfo"
:
[{
"descriptPackageId"
:
"abcdefg1234567ABCDEFG"
,
"content"
:
"This package is used for update."
}]
}
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录