1 2# 全球化子系统变更说明 3 4## cl.global.1 资源匹配逻辑变更 5 6**访问级别** 7 8公开接口 9 10**变更原因** 11 12插入SIM卡时未能获取到正确的mcc目录资源，影响开发者差异化定制资源。 13 14**变更影响** 15 16该变更为不兼容变更。 17 18变更前：应用配置了mcc目录等差异化资源，插sim卡显示的是默认语言目录下资源，未插sim卡显示的是mcc目录下资源。 19 20如：插卡时会显示“Wi-Fi”字串，不插卡时会显示“WLAN”字串。 21 22变更后：插sim卡显示的是mcc目录下资源，未插sim卡显示的是默认语言目录下资源。 23 24如：插卡时会显示“WLAN”字串，不插卡时会显示“Wi-Fi”字串。 25 26**起始API Level** 27 28API 9 29 30**变更发生版本** 31 32从OpenHarmony SDK 5.0.0.33开始。 33 34**变更的接口/组件** 35 36SystemCapability.Global.ResourceManager获取资源相关接口。 37相关接口查看[接口文档](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis-localization-kit/js-apis-resource-manager.md) 38 39**适配指导** 40 41变更前开发者如果有在默认语言目录配置“WLAN”字串，mcc目录配置“Wi-Fi”字串，变更后需要适配将“WLAN”字串配置在mcc目录，“Wi-Fi”字串配置在默认语言目录。 42 43## cl.golbal.2 string头文件变更 44 45**访问级别** 46 47公开接口 48 49**变更原因** 50 51string库文件是C++标准库，影响头文件在C语言环境下正常使用。 52 53**变更影响** 54 55该变更为不兼容变更 56 57若开发者引用了string库函数，且未手动引入string库头文件，则会出现编译不过的问题。 58 59**起始API Level** 60 61API 8 62 63**变更发生的版本** 64 65从OpenHarmony SDK 5.0.0.33开始。 66 67**变更的接口/组件** 68 69string头文件 70 71**适配指导** 72 73若开发者在变更前引用了string库函数，且未手动引入string库头文件依赖raw_file.h头文件，可以通过#include引入头文件解决。 74 75## cl.golbal.3 raw_file模块接口废弃 76 77**访问级别** 78 79公开接口 80 81**废弃原因** 82 83接口中使用了引用参数，影响接口在C语言环境下正常使用。 84 85**废弃影响** 86 87该变更为兼容性变更 88 89变更前开发者使用了 OH_ResourceManager_GetRawFileDescriptor 和OH_ResourceManager_ReleaseRawFileDescriptor 接口，变更后则需要适配新的接口。 90 91**废弃发生的版本** 92 93从OpenHarmony SDK 5.0.0.33开始。 94 95**废弃的接口/组件** 96 97| 接口声明 | 废弃说明 | 替代接口 | 98|-----------------------------------------------------------------------------------------------------|---------|---------------------------------------------------------------------------------------------------------| 99| bool OH_ResourceManager_GetRawFileDescriptor(const RawFile \*rawFile, RawFileDescriptor &descriptor) | 使用接口获取rawfile文件描述符 | bool OH_ResourceManager_GetRawFileDescriptorData(const RawFile \*rawFile, RawFileDescriptor \*descriptor) | 100| bool OH_ResourceManager_ReleaseRawFileDescriptor(const RawFileDescriptor &descriptor) | 使用接口释放rawfile文件描述符 | bool OH_ResourceManager_ReleaseRawFileDescriptorData(const RawFileDescriptor \*descriptor) | 101 102 103**适配指导** 104 105变更后则需要适配新的接口，调用新接口 OH_ResourceManager_GetRawFileDescriptorData 获取rawfile文件描述符来读取rawfile文件内容，调用新接口 OH_ResourceManager_ReleaseRawFileDescriptorData 来释放已获取到的rawfile文件描述符。 106 107## cl.golbal.4 ohresmgr模块接口废弃 108 109**访问级别** 110 111公开接口 112 113**废弃原因** 114 115接口中使用了可选参数，影响接口在c语言环境下正常使用。 116 117**废弃影响** 118 119该变更为兼容性变更 120 121接口已废弃不推荐使用，推荐适配使用新接口。 122 123**废弃发生的版本** 124 125从OpenHarmony SDK 5.0.0.33开始。 126 127**废弃的接口/组件** 128 129| 接口声明 | 废弃说明 | 替代接口 | 130|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| 131| ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64(const NativeResourceManager \*mgr, uint32_t resId, char \*\*resultValue, uint64_t \*resultLen, uint32_t density = 0) | 使用接口通过资源id获取媒体文件base64编码值 | ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64Data(const NativeResourceManager \*mgr, uint32_t resId, char \*\*resultValue, uint64_t \*resultLen, uint32_t density) | 132| ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64ByName(const NativeResourceManager \*mgr, const char \*resName, char \*\*resultValue, uint64_t \*resultLen, uint32_t density = 0) | 使用接口通过资源名称获取媒体文件base64编码值| ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64DataByName(const NativeResourceManager \*mgr, const char \*resName, char \*\*resultValue, uint64_t \*resultLen, uint32_t density) | 133| ResourceManager_ErrorCode OH_ResourceManager_GetMedia(const NativeResourceManager \*mgr, uint32_t resId, uint8_t \*\*resultValue, uint64_t \*resultLen, uint32_t density = 0) | 使用接口通过资源id获取媒体文件内容 | ResourceManager_ErrorCode OH_ResourceManager_GetMediaData(const NativeResourceManager \*mgr, uint32_t resId, uint8_t \*\*resultValue, uint64_t \*resultLen, uint32_t density) | 134| ResourceManager_ErrorCode OH_ResourceManager_GetMediaByName(const NativeResourceManager \*mgr, const char \*resName, uint8_t \*\*resultValue, uint64_t \*resultLen, uint32_t density = 0) | 使用接口通过资源名称获取媒体文件内容 | ResourceManager_ErrorCode OH_ResourceManager_GetMediaDataByName(const NativeResourceManager \*mgr, const char \*resName, uint8_t \*\*resultValue, uint64_t \*resultLen, uint32_t density) | 135| ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptor(const NativeResourceManager \*mgr, uint32_t resId, ArkUI_DrawableDescriptor \*\*drawableDescriptor, uint32_t density = 0, uint32_t type = 0) | 使用接口通过资源id获取图片的描述符 | ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorData(const NativeResourceManager \*mgr, uint32_t resId, ArkUI_DrawableDescriptor \*\*drawableDescriptor, uint32_t density, uint32_t type) | 136| ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorByName(const NativeResourceManager \*mgr, const char \*resName, ArkUI_DrawableDescriptor \*\*drawableDescriptor, uint32_t density = 0, uint32_t type = 0) | 使用接口通过资源名称获取图片的描述符 | ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorDataByName(const NativeResourceManager \*mgr, const char \*resName, ArkUI_DrawableDescriptor \*\*drawableDescriptor, uint32_t density, uint32_t type) | 137| ResourceManager_ErrorCode OH_ResourceManager_GetLocales(const NativeResourceManager \*mgr, char \*\*\*resultValue, uint32_t \*resultLen, bool includeSystem = false) | 使用接口获取当前语言和地区信息 | ResourceManager_ErrorCode OH_ResourceManager_GetLocalesData(const NativeResourceManager \*mgr, char \*\*\*resultValue, uint32_t \*resultLen, bool includeSystem) | 138 139 140**适配指导** 141 142开发者需要停止使用可选参数的函数接口，在新版本开发过程中，使用新接口。 143 144ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64Data(const NativeResourceManager \*mgr, uint32_t resId, 145 char \*\*resultValue, uint64_t \*resultLen, uint32_t density); 146 147ResourceManager_ErrorCode OH_ResourceManager_GetMediaBase64DataByName(const NativeResourceManager \*mgr, 148 const char \*resName, char \*\*resultValue, uint64_t \*resultLen, uint32_t density); 149 150ResourceManager_ErrorCode OH_ResourceManager_GetMediaData(const NativeResourceManager \*mgr, uint32_t resId, 151 uint8_t \*\*resultValue, uint64_t \*resultLen, uint32_t density); 152 153ResourceManager_ErrorCode OH_ResourceManager_GetMediaDataByName(const NativeResourceManager \*mgr, const char \*resName, 154 uint8_t \*\*resultValue, uint64_t \*resultLen, uint32_t density); 155 156ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorData(const NativeResourceManager \*mgr, 157 uint32_t resId, ArkUI_DrawableDescriptor \*\*drawableDescriptor, uint32_t density, uint32_t type); 158 159ResourceManager_ErrorCode OH_ResourceManager_GetDrawableDescriptorDataByName(const NativeResourceManager \*mgr, 160 const char \*resName, ArkUI_DrawableDescriptor \*\*drawableDescriptor, uint32_t density, uint32_t type); 161 162ResourceManager_ErrorCode OH_ResourceManager_GetLocalesData(const NativeResourceManager \*mgr, char \*\*\*resultValue, 163 uint32_t \*resultLen, bool includeSystem);