diff --git a/zh-cn/application-dev/reference/apis/js-apis-hiappevent.md b/zh-cn/application-dev/reference/apis/js-apis-hiappevent.md index 5887ffaecdfd82e17bec2a2d38cf614db67fe11f..b76fa9caf301084b6e13bdc679811b3280498ee9 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hiappevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hiappevent.md @@ -20,7 +20,7 @@ import hiAppEvent from '@ohos.hiAppEvent'; **事件名称** -事件名称为string类型,字符串非空且长度在48个字符以内,有效的字符是0-9、a-z、下划线,只能以小写字母开头,不能以下划线结尾。 +事件名称为string类型,字符串非空且长度在48个字符以内,有效的字符是数字字符、字母字符、下划线字符,只能以字母字符或$字符开头,不能以下划线字符结尾。 **事件类型** @@ -30,7 +30,7 @@ import hiAppEvent from '@ohos.hiAppEvent'; 事件参数为object类型,key为事件的参数名称,value为事件的参数值,其规格定义如下: -- 参数名为string类型,字符串非空且长度在16个字符以内,有效的字符是0-9、a-z、下划线,只能以小写字母开头,不能以下划线结尾; +- 参数名为string类型,字符串非空且长度在16个字符以内,有效的字符是数字字符、字母字符、下划线字符,只能以字母字符或$字符开头,不能以下划线字符结尾; - 参数值支持string、number、boolean、数组类型; - 参数值为string类型时,其长度需在8*1024个字符以内,超出会做丢弃处理; - 参数值为number类型时,其取值需在Number.MIN_SAFE_INTEGER~Number.MAX_SAFE_INTEGER范围内,超出可能会产生不确定值; diff --git a/zh-cn/application-dev/reference/apis/js-apis-hiviewdfx-hiappevent.md b/zh-cn/application-dev/reference/apis/js-apis-hiviewdfx-hiappevent.md index 2c41ccc0392e70edb1e2d0c40870bf1cbbdeee6b..5bd145347f57e93eb8d96cf11b54d6043112c116 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-hiviewdfx-hiappevent.md +++ b/zh-cn/application-dev/reference/apis/js-apis-hiviewdfx-hiappevent.md @@ -123,9 +123,9 @@ hiAppEvent.write({ | 名称 | 类型 | 必填 | 说明 | | --------- | ----------------------- | ---- | ------------------------------------------------------------ | | domain | string | 是 | 事件领域。事件领域名称支持数字、小写字母、下划线字符,需要以小写字母开头且不能以下划线结尾,长度非空且不超过32个字符。 | -| name | string | 是 | 事件名称。事件名称支持数字、小写字母、下划线字符,需要以小写字母开头且不能以下划线结尾,长度非空且不超过48个字符。 | +| name | string | 是 | 事件名称。事件名称支持数字字符、字母字符、下划线字符,需要以字母字符或$字符开头且不能以下划线字符结尾,长度非空且不超过48个字符。 | | eventType | [EventType](#eventtype) | 是 | 事件类型。 | -| params | object | 是 | 事件参数对象,每个事件参数包括参数名和参数值,其规格定义如下:
- 参数名为string类型,只支持数字、小写字母、下划线字符,需要以小写字母开头且不能以下划线结尾,长度非空且不超过16个字符。
- 参数值支持string、number、boolean、数组类型,string类型参数长度需在8*1024个字符以内,超出会做丢弃处理;number类型参数取值需在Number.MIN_SAFE_INTEGER~Number.MAX_SAFE_INTEGER范围内,超出可能会产生不确定值;数组类型参数中的元素类型只能全为string、number、boolean中的一种,且元素个数需在100以内,超出会做丢弃处理。
- 参数个数需在32个以内,超出的参数会做丢弃处理。 | +| params | object | 是 | 事件参数对象,每个事件参数包括参数名和参数值,其规格定义如下:
- 参数名为string类型,只支持数字字符、字母字符、下划线字符,需要以字母字符或$字符开头且不能以下划线字符结尾,长度非空且不超过16个字符。
- 参数值支持string、number、boolean、数组类型,string类型参数长度需在8*1024个字符以内,超出会做丢弃处理;number类型参数取值需在Number.MIN_SAFE_INTEGER~Number.MAX_SAFE_INTEGER范围内,超出可能会产生不确定值;数组类型参数中的元素类型只能全为string、number、boolean中的一种,且元素个数需在100以内,超出会做丢弃处理。
- 参数个数需在32个以内,超出的参数会做丢弃处理。 | ## hiAppEvent.configure diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-hiappevent.md b/zh-cn/application-dev/reference/errorcodes/errorcode-hiappevent.md index 1249deef43af46f479ec2ba0ac5d3abcff535066..271bbd5c2b7d272896003b57896f4d4b641bc097 100644 --- a/zh-cn/application-dev/reference/errorcodes/errorcode-hiappevent.md +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-hiappevent.md @@ -63,8 +63,8 @@ Invalid event name. 传入的事件名称不符合以下规则: -- 事件名称只包含数字、小写字母、下划线字符。 -- 事件名称以小写字母开头,不以下划线结尾。 +- 事件名称只包含数字字符、字母字符、下划线字符。 +- 事件名称以字母字符或$字符开头,不以下划线字符结尾。 - 事件名称非空且长度不超过48个字符。 **处理步骤** @@ -121,8 +121,8 @@ Invalid event parameter name. 传入的事件名称不符合以下规则: -- 事件名称只包含数字、小写字母、下划线字符。 -- 事件名称以小写字母开头,不以下划线结尾。 +- 事件名称只包含数字字符、字母字符、下划线字符。 +- 事件名称以字母字符或$字符开头,不以下划线字符结尾。 - 事件名称非空且长度不超过16个字符。 **处理步骤** diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_4.0.10.3/changelogs-dfx.md b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.10.3/changelogs-dfx.md new file mode 100644 index 0000000000000000000000000000000000000000..755fcbd7f398e4ff7f953ebdc2399b0a66719620 --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_4.0.10.3/changelogs-dfx.md @@ -0,0 +1,22 @@ +# DFX子系统ChangeLog + +## cl.hiviewdfx.1 HiAppEvent模块write接口事件校验规格变更 + +应用打点功能由于需要支持Analytics预埋点事件接入,需要对打点接口支持的事件规格做拓展,现做出如下变更: + + - 事件名称由支持[小写字母|数字|下划线],变更为支持[$字符开头|大小写字母|数字|下划线]。 + - 事件参数名称由支持[小写字母|数字|下划线],变更为支持[$字符开头|大小写字母|数字|下划线]。 + +**变更影响** + +打点接口支持的事件定义格式更丰富。 + +**关键的接口/组件变更** + +涉及接口 + + - hiAppEvent.write; + +**适配指导** + +兼容原有规格,无需额外适配。