跳到主要内容

示例服务器开发指导

开发步骤

  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声明了示例服务器的接口。

    #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两个证书。

    #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\": [{"
    "\"descriptionType\": 0,"
    "\"content\": \"This package message is used for sampleContent\""
    "}]"
    "}";
  7. 编译输出产物

    编译输出目录会新增testserver和libserver_process.z.so两个文件。

  8. 升级包制作

    参考update_packaging_tools仓制作升级包。

  9. 启动搜包服务器

    建议在开发板上新建一个纯英文路径,然后将testserver、libserver_process.z.so、serverCert.cer和serverKey.pem放到同一个目录下,进入该目录,执行以下启动命令即可启动搜包服务器。

    ./testserver ./libserver_process.z.so &