最近在做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文件中,如下图所示:
需要将这些软证书,写入到产品的安全分区,用于兼容性授权验证。
授权验证组件编译集成与适配
先写到这,后续补充…