harmony 鸿蒙ArkTS子系统Changelog

2025-06-16
浏览 (3)

ArkTS子系统Changelog

cl.arkts.1 convertXml模块未支持parentKey属性的行为变更

访问级别

公开接口

变更原因

convertXml模块未实现parentKey属性，生成的object中不具有parentKey属性的值。

变更影响

该变更为不兼容性变更。

变更前： convertToJSObject接口对xml字符串的入参进行解析时，未支持设置parentKey属性的值。

变更后： convertToJSObject接口对xml字符串的入参进行解析时，可以支持正确设置parentKey属性的值。

起始API Level

API 9

变更发生版本

从OpenHarmony 5.0.1.1 版本开始。

变更的接口/组件 ConvertXML模块下的接口：

convertToJSObject(xml: string, options?: ConvertOptions): Object;

适配指导

变更：convertToJSObject接口对xml字符串的入参进行解析时，可以支持正确设置parentKey属性的值。

import { convertxml } from '@kit.ArkTS';

let xml =
  '<?xml version="1.0" encoding="utf-8"?>' +
    '<note importance="high" logged="true">' +
    '    <title>Happy</title>' +
    '    <todo>Work</todo>' +
    '    <todo>Play</todo>' +
    '</note>';
let conv = new convertxml.ConvertXML()
let options: convertxml.ConvertOptions = {
  trim: false,
  declarationKey: "_declaration",
  instructionKey: "_instruction",
  attributesKey: "_attributes",
  textKey: "_text",
  cdataKey: "_cdata",
  doctypeKey: "_doctype",
  commentKey: "_comment",
  parentKey: "_parent",
  typeKey: "_type",
  nameKey: "_name",
  elementsKey: "_elements"
}
let result: ESObject = conv.convertToJSObject(xml, options);

// 变更前：result的值实际为： {"_declaration":{"_attributes":{"version":"1.0","encoding":"utf-8"}},"_elements":[{"_type":"element","_name":"note","_attributes":{"importance":"high","logged":"true"},"_elements":[{"_type":"element","_name":"title","_elements":[{"_type":"text","_text":"Happy"}]},{"_type":"element","_name":"todo","_elements":[{"_type":"text","_text":"Work"}]},{"_type":"element","_name":"todo","_elements":[{"_type":"text","_text":"Play"}]}]}]}

// 变更后：result的值实际为（新增parentKey属性）： {"_declaration":{"_attributes":{"version":"1.0","encoding":"utf-8"}},"_elements":[{"_type":"element","_name":"note","_attributes":{"importance":"high","logged":"true"},"_elements":[{"_type":"element","_name":"title","_parent":"note","_elements":[{"_type":"text","_text":"Happy"}]},{"_type":"element","_name":"todo","_parent":"note","_elements":[{"_type":"text","_text":"Work"}]},{"_type":"element","_name":"todo","_parent":"note","_elements":[{"_type":"text","_text":"Play"}]}]}]}

// 对于开发者使用场景来说，不影响开发者使用。
// 获取title标签的parentKey属性的方法是：result1["_elements"][0]["_elements"][0]._parent 
// 变更前：获取title标签的parentKey属性为：undefined
// 变更后：获取title标签的parentKey属性为实际值：note

cl.arkts.2 util.TextEncoder模块utf-16le和utf-16be编码数据行为变更

访问级别

公开接口

变更原因

TextEncoder编码器在编码格式设置为utf-16le和utf-16be时，获得的编码数据相反。 utf-16le为小端编码格式，编码出数据应该符合小端编码数据，但是实际表现为大端编码数据。 utf-16be为大端编码格式，编码出数据应该符合大端编码数据，但是实际表现为小端编码数据。这两种编码格式所编码出的数据行为与标准定义不符合，需要修复此问题。

变更影响

该变更为不兼容性变更。

变更前： utf-16le为小端编码格式，编码出数据应该符合小端编码数据，但是实际表现为大端编码数据。 utf-16be为大端编码格式，编码出数据应该符合大端编码数据，但是实际表现为小端编码数据。

变更后： utf-16le为小端编码格式，实际表现为小端编码数据。 utf-16be为大端编码格式，实际表现为大端编码数据。

起始API Level

API 9

变更发生版本

从OpenHarmony 5.0.1.1 版本开始。

变更的接口/组件 util.TextEncoder模块的接口：

encodeInto(input?: string): Uint8Array; encodeIntoUint8Array(input: string, dest: Uint8Array): EncodeIntoUint8ArrayInfo;

适配指导

变更描述：修复TextEncoder编码器在编码格式设置为utf-16le和utf-16be时获取编码数据与定义不相符的BUG。

encodeInto接口的表现：

import { util } from '@kit.ArkTS';

let encoderUtf16Le = new util.TextEncoder("utf-16le");
let encoderUtf16Be = new util.TextEncoder("utf-16be");

// 变更前：
// let u8_le = encoderUtf16Le.encodeInto('abcdefg'); // u8_le: 0,97,0,98,0,99,0,100,0,101,0,102,0,103
// let u8_be = encoderUtf16Be.encodeInto('abcdefg'); // u8_be: 97,0,98,0,99,0,100,0,101,0,102,0,103,0


// 变更后：
let u8_le = encoderUtf16Le.encodeInto('abcdefg'); // u8_le: 97,0,98,0,99,0,100,0,101,0,102,0,103,0
let u8_be = encoderUtf16Be.encodeInto('abcdefg'); // u8_be: 0,97,0,98,0,99,0,100,0,101,0,102,0,103

encodeIntoUint8Array接口的表现：

import { util } from '@kit.ArkTS';

let encoderUtf16Le = new util.TextEncoder("utf-16le");
let encoderUtf16Be = new util.TextEncoder("utf-16be");

// 变更前：
// let dest_le = new Uint8Array(14);
// let dest_be = new Uint8Array(14);
// let res_le = encoderUtf16Le.encodeIntoUint8Array('abcdefg', dest_le); // dest_le: 0,97,0,98,0,99,0,100,0,101,0,102,0,103
// let res_be = encoderUtf16Be.encodeIntoUint8Array('abcdefg', dest_be); // dest_be: 97,0,98,0,99,0,100,0,101,0,102,0,103,0

// 变更后：
let dest_le = new Uint8Array(14);
let dest_be = new Uint8Array(14);
let res_le = encoderUtf16Le.encodeIntoUint8Array('abcdefg', dest_le); // dest_le: 97,0,98,0,99,0,100,0,101,0,102,0,103,0
let res_be = encoderUtf16Be.encodeIntoUint8Array('abcdefg', dest_be); // dest_be: 0,97,0,98,0,99,0,100,0,101,0,102,0,103