最近在做OpenHarmony兼容性平台认证接入,在此记录一下整个过程遇到的问题和解决办法。

注册账号

进入OpenHarmony兼容是测评主页:https://www.openharmony.cn/certification/document/guid
在这里插入图片描述
点击申请测评, 会跳转到开放原子基金会登录页面。
在这里插入图片描述
如果已经注册账号,直接登录即可。未注册账号,则需点击立即注册。
注意:目前必须注册企业账号,才能直接使用。注册个人账号,需要加入团队,才能进行操作。
在这里插入图片描述

创建产品评测申请

账号登录后,需要在兼容性测评页面点击创建申请。
在这里插入图片描述
按要求填写联系人信息
在这里插入图片描述
填写产品定义信息:
在这里插入图片描述
其中需要重点注意的几个参数,后续用到:

参数项 含义 对应文件路径
企业简称英文(登录后在账户管理->用户管理中可查看) 对应HalGetManufacture函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
品牌英文名称 对应HalGetBrand函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
设备型号 对应HalGetProductModel函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
软件版本号 对应HalGetDisplayVersion函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
安全补丁标签 对应GetSecurityPatchTag函数接口获取的值 //base/startup/syspara_lite/frameworks/parameter/src/parameter_common.c
版本id 对应BuildVersionId函数接口获取的值 //base/startup/syspara_lite/frameworks/parameter/src/parameter_common.c
版本Hash 对应GetBuildRootHash函数接口获取的值 //base/startup/syspara_lite/frameworks/parameter/src/parameter_common.c

其中,版本id由如下参数组成,以斜杠连接:

static const char *BuildVersionId(void)
{
    char value[VERSION_ID_LEN];
    int len = sprintf_s(value, VERSION_ID_LEN, "%s/%s/%s/%s/%s/%s/%s/%d/%s/%s",
        GetDeviceType(), GetManufacture(), GetBrand(), GetProductSeries(),
        GetOSFullName(), GetProductModel(), GetSoftwareModel(),
        OHOS_SDK_API_VERSION, GetIncrementalVersion(), GetBuildType());
    if (len < 0) {
        return EMPTY_STR;
    }
    const char *versionId = strdup(value);
    return versionId;
}
参数项(按拼接顺序) 含义 对应文件路径
设备类型 对应HalGetDeviceType函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
企业简称英文 对应HalGetManufacture函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
品牌英文名称 对应HalGetBrand函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
产品系列 对应HalGetProductSeries函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
操作系统版本 对应BuildOSFullName函数接口获取的值(具体值由宏OHOS_OS_NAME, MAJOR_VERSION, SENIOR_VERSION, FEATURE_VERSION, BUILD_VERSION指定) //base/startup/syspara_lite/frameworks/parameter/src/parameter_common.c
产品模型 对应HalGetProductModel函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
软件模型 对应HalGetSoftwareModel函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
SDK API版本 对应OHOS_SDK_API_VERSION宏的值 //base/startup/syspara_lite/frameworks/parameter/src/parameter_common.c
增量版本 对应HalGetIncrementalVersion函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c
构建类型 对应HalGetBuildType函数接口获取的值 //vendor/xxx/xxx/hals/utils/sys_param/hal_sys_param.c

软证书获取

下载软证书
在这里插入图片描述
为防止软证书被窃取,软证书(.lic)是加密的,需要将其与之前生成的privatekey.txt文件拷贝到解密工具脚本同级目录:
在这里插入图片描述
由于解密工具依赖java,需要先安装java环境才能运行:
在这里插入图片描述
配置java环境变量:
在系统属性->环境变量中,添加用户变量JAVA_HOME,变量值为刚刚java-jdk的安装路径:
在这里插入图片描述

打开cmd窗口,输入java --version命令,验证java安装是否成功:
在这里插入图片描述
能够打印出版本号即表示安装成功。

java运行环境装好后,直接双击RsaDec.bat脚本即可开始解密,解密成功会生成一个与.lic文件同名的.zip文件,解压后里面有一个.txt文件,文件的每一行(字符长度为151)表示一台设备的软证书,行数应该与之前申请软证书的数量一致。
在这里插入图片描述
申请的所有软证书都在txt文件中,如下图所示:
在这里插入图片描述
需要将这些软证书,写入到产品的安全分区,用于兼容性授权验证。

授权验证组件编译集成与适配

先写到这,后续补充…

Logo

社区规范:仅讨论OpenHarmony相关问题。

更多推荐