Skip to content

D
Docs

OpenHarmony / Docs
大约 1 年 前同步成功

通知 159
Star 292
Fork 28
D
Docs

体验新版 GitCode，发现更多精彩内容 >>

提交 45aae75b 编写于 作者: W wangqi
浏览文件
操作

Description: Upload Readme 

Signed-off-by: N王琪 <wangqi327@huawei.com>
上级 c0722413
隐藏空白更改
内联 并排
Showing with 164 addition and 165 deletion
zh-cn/application-dev/device/sample-server-guidelines.md
浏览文件 @ 45aae75b
......@@ -8,211 +8,210 @@
1. 生成SSL证书
生成serverKey.pem和serverCert.cer两个文件，用于示例服务器的SSL协议通信。
生成serverKey.pem和serverCert.cer两个文件，用于示例服务器的SSL协议通信。
```bash
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"
```
```bash
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字段中开始位置新增一行。
在build字段的sub_component字段中开始位置新增一行。
```cmake
"sub_component": [
"//base/update/updateservice/server_sample:testserver",
...
],
```
```cmake
"sub_component": [
"//base/update/updateservice/server_sample:testserver",
...
],
```
3. 下载代码仓
repo方式下载OpenHarmony全仓
repo方式下载OpenHarmony全仓
```bash
repo init -u https://gitee.com/openharmony/manifest.git -b master --no-repo-verify
repo sync -c
repo forall -c 'git lfs pull'
```
```bash
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方式下载本代码仓
```bash
git clone https://gitee.com/openharmony/update_updateservice.git -b master
```
```bash
git clone https://gitee.com/openharmony/update_updateservice.git -b master
```
4. 建立代码目录
进入到update_updateservice目录下，执行以下命令，建立代码目录。
进入到update_updateservice目录下，执行以下命令，建立代码目录。
```bash
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文件
```
```bash
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文件
```
5. 编译文件BUILD.gn编写
文件BUILD.gn一共编译两个ohos组件，一个是ohos_shared_library库文件libserver_process.z.so，另一个是ohos_executable可执行文件testserver。
文件BUILD.gn一共编译两个ohos组件，一个是ohos_shared_library库文件libserver_process.z.so，另一个是ohos_executable可执行文件testserver。
```cmake
import("//build/ohos.gni")
```cmake
import("//build/ohos.gni")
ohos_shared_library("server_process") {
sources = [
"//base/update/updateservice/./src/server_process.c",
]
ohos_shared_library("server_process") {
sources = [
"//base/update/updateservice/./src/server_process.c",
]
include_dirs = [
"//base/update/updateservice/server_sample/include",
"//third_party/openssl/include",
]
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",
]
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"
}
part_name = "update_service"
}
ohos_executable("testserver") {
source = [
"//base/update/updateservice/server_sample/src/main.cpp",
]
ohos_executable("testserver") {
source = [
"//base/update/updateservice/server_sample/src/main.cpp",
]
include_dirs = [
"//base/update/updateservice/server_sample/include",
]
include_dirs = [
"//base/update/updateservice/server_sample/include",
]
deps = [
"//base/update/updateservice/server_sample:server_process",
]
deps = [
"//base/update/updateservice/server_sample:server_process",
]
part_name = "update_service"
}
```
part_name = "update_service"
}
```
6. 头文件server_process.h编写
文件server_process.h声明了示例服务器的接口。
文件server_process.h声明了示例服务器的接口。
```c++
#ifndef __SERVER_PROCESS_H__
#define __SERVER_PROCESS_H__
```c++
#ifndef __SERVER_PROCESS_H__
#define __SERVER_PROCESS_H__
/*
Init函数：用于创建socket环境，并预设置一些属性
*/
int Init();
/*
Init函数：用于创建socket环境，并预设置一些属性
*/
int Init();
/*
SetParam函数：所有插件参数设置的统一接口
*/
int SetParam(const char *key, const char *value);
/*
SetParam函数：所有插件参数设置的统一接口
*/
int SetParam(const char *key, const char *value);
/*
GetParam函数：所有插件参数获取的统一接口
*/
int GetParam(const char *key, char *value);
/*
GetParam函数：所有插件参数获取的统一接口
*/
int GetParam(const char *key, char *value);
/*
ReverseSetParamCallback函数：回调
*/
int ReverseSetParamCallback(int(*setParam)(const char *key, const char *value));
/*
ReverseSetParamCallback函数：回调
*/
int ReverseSetParamCallback(int(*setParam)(const char *key, const char *value));
/*
Open函数：用于服务打开的接口
*/
int Open();
/*
Open函数：用于服务打开的接口
*/
int Open();
/*
MainLoop函数：每隔100ms调用一次
*/
int MainLoop();
/*
MainLoop函数：每隔100ms调用一次
*/
int MainLoop();
/*
Close函数，用于关闭服务并释放资源
*/
int Close();
/*
Close函数，用于关闭服务并释放资源
*/
int Close();
#endif //__SERVER_PROCESS_H__
```
#endif //__SERVER_PROCESS_H__
```
7. 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\": \"update.bin\","
"}],"
"\"descriptInfo\": [{"
"\"descriptPackageId\": \"update.bin\","
"\"content\": \"This package message is used for sampleContent\""
"}]"
文件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\": \"update.bin\","
"}],"
"\"descriptInfo\": [{"
"\"descriptPackageId\": \"update.bin\","
"\"content\": \"This package message is used for sampleContent\""
"}]"
"}";
```
```
8. 编译输出产物
编译输出目录会新增testserver和libserver_process.z.so两个文件。
编译输出目录会新增testserver和libserver_process.z.so两个文件。
9. 升级包制作
[参考OpenHarmony的update_packaging_tools仓制作升级包。](https://gitee.com/openharmony/update_packaging_tools)
[参考OpenHarmony的update_packaging_tools仓制作升级包。](https://gitee.com/openharmony/update_packaging_tools)
10. 启动搜包服务器
建议在开发板上新建一个纯英文路径，然后将testserver、libserver_process.z.so、serverCert.cer和serverKey.pem放到同一个目录下，进入该目录，执行以下启动命令即可启动搜包服务器。
建议在开发板上新建一个纯英文路径，然后将testserver、libserver_process.z.so、serverCert.cer和serverKey.pem放到同一个目录下，进入该目录，执行以下启动命令即可启动搜包服务器。
```bash
./testserver ./libserver_process.z.so &
```
```bash
./testserver ./libserver_process.z.so &
```
zh-cn/application-dev/device/sample-server-overview.md
浏览文件 @ 45aae75b
......@@ -18,21 +18,21 @@
```json
{
"searchStatus": 0,
"errMsg": "success",
"checkResults": [{
"versionName": "versionNameSample",
"versionCode": "versionCodeSample",
"verifyInfo": "verifyInfoSHA256Value1234567",
"size": 1234567,
"packageType": 1,
"url": "http://serverAddressSample/packageNameSample.fileTypeSample",
"descriptPackageId": "packageNameSample.fileTypeSample"
}],
"descriptInfo": [{
"descriptPackageId": "packageNameSample.fileTypeSample",
"content": "This package is used for update."
}]
"searchStatus": 0,
"errMsg": "success",
"checkResults": [{
"versionName": "versionNameSample",
"versionCode": "versionCodeSample",
"verifyInfo": "verifyInfoSHA256Value1234567",
"size": 1234567,
"packageType": 1,
"url": "http://serverAddressSample/packageNameSample.fileTypeSample",
"descriptPackageId": "packageNameSample.fileTypeSample"
}],
"descriptInfo": [{
"descriptPackageId": "packageNameSample.fileTypeSample",
"content": "This package is used for update."
}]
}
```
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或