移植案例与原理 - startup子系统之syspara_lite系统属性部件 （2）

【本文正在参与优质创作者激励】

系统属性部件syspara_lite负责提供获取与设置操作系统相关的系统属性，包括默认系统属性、OEM厂商系统属性和自定义系统属性。为满足OpenHarmony产品兼容性规范，产品解决方案需要实现获取设备信息的接口，如：产品名、品牌名、厂家名等，同时提供设置/读取系统属性的接口。在《移植案例与原理 - startup子系统之syspara_lite系统属性部件》中，我们介绍了移植开发板时如何适配系统属性部件syspara_lite，并介绍了相关的运行机制原理。本文主要介绍如何使用syspara_lite系统属性部件的接口，然后详细介绍下syspara_lite系统属性部件的各个接口。

1、系统参数syspara_lite部件使用例子

下面是系统参数syspara_lite部件使用例子，来自https://gitee.com/openharmony/startup_syspara_lite。⑴处获取设备类型，⑵处获取厂商名称，⑶处获取品牌名称。其他系统属性接口调用的例子类似，详细的接口说明下文会提供。

⑴  char* value1 = GetDeviceType();
    printf("Device type =%s\n", value1);
    free(value1);
⑵  char* value2 = GetManufacture();
    printf("Manufacture =%s\n", value2);
    free(value2);
⑶  char* value3 = GetBrand();
    printf("GetBrand =%s\n", value3);
    free(value3);
           

2、系统参数syspara_lite部件接口信息

在文件base\startup\syspara_lite\interfaces\innerkits\native\syspara\include\parameter.h中定义了系统属性的接口。系统属性接口说明如下表所示：

接口名	描述
int GetParameter(const char* key, const char* def, char* value, unsigned int len)	获取系统参数
int SetParameter(const char* key, const char* value)	设置/更新系统参数
const char* GetDeviceType(void)	返回当前设备类型
const char* GetManufacture(void)	返回当前设备生产厂家信息
const char* GetBrand(void)	返回当前设备品牌信息
const char* GetMarketName(void)	返回当前设备传播名
const char* GetProductSeries(void)	返回当前设备产品系列名
const char* GetProductModel(void)	返回当前设备认证型号
const char* GetSoftwareModel(void)	返回当前设备内部软件子型号
const char* GetHardwareModel(void)	返回当前设备硬件版本号
const char* GetHardwareProfile(void)	返回当前设备硬件profile
const char* GetSerial(void)	返回当前设备序列号（SN号）
const char* GetOSFullName(void)	返回操作系统名
const char* GetDisplayVersion(void)	返回当前设备用户可见的软件版本号
const char* GetBootloaderVersion(void)	返回当前设备Bootloader版本号
const char* GetSecurityPatchTag(void)	返回安全补丁标签
const char* GetAbiList(void)	返回当前设备支持的指令集（Abi）列表
int GetSdkApiVersion(void)	返回与当前系统软件匹配的SDK API 版本号
int GetFirstApiVersion(void)	返回系统软件首版本SDK API 版本号
const char* GetIncrementalVersion(void)	返回差异版本号
const char* GetVersionId(void)	返回版本id
const char* GetBuildType(void)	返回构建类型
const char* GetBuildUser(void)	返回构建账户用户名
const char* GetBuildHost(void)	返回构建主机名
const char* GetBuildTime(void)	返回构建时间
const char* GetBuildRootHash(void)	返回当前版本hash
const char* GetOsReleaseType(void)	返回系统发布类型
int GetDevUdid(char *udid, int size)	获取设备udid

参考站点

• OpenHarmony / startup_syspara_lite
• HarmonyOS Device > 文档 > 指南 > 基础能力: syspara系统属性部件
• 轻量带屏解决方案之恒玄芯片移植案例

小结

本文介绍了如何使用syspara_lite系统属性部件的接口，然后详细介绍下syspara_lite系统属性部件的各个接口。因为时间关系，仓促写作，或能力限制，若有失误之处，请各位读者多多指正。感谢阅读，有什么问题，请留言。

【本文正在参与优质创作者激励】

想了解更多关于鸿蒙的内容，请访问：

51CTO和华为官方合作共建的鸿蒙技术社区

https://harmonyos.51cto.com/#bkwz