@hmos-library-adapter/fast 0.0.17-beta.0 → 0.0.17-beta.2

package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/5.1.0(18)/os-api-behavior-changes.md

@@ -0,0 +1,1294 @@
+---
+title: OS平台API行为的变更
+source: https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-5101
+category: harmonyos-releases
+downloaded_at: 2026-09-03
+---
+
+# OS平台API行为的变更
+
+## ArkTS
+
+### 默认不合并依赖混淆规则变更说明
+
+**变更原因**
+
+混淆默认合并依赖混淆规则，由于部分开发者不了解混淆机制，在发布的三方库中的obfuscation.txt文件中引入了混淆开关选项，其它应用依赖这些三方库后出现应用启动崩溃，且开发者无法直接感知这些三方库引入了混淆开关。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前:
+
+编译一个模块时，生效的混淆规则为当前模块所有混淆配置与依赖模块及三方库**所有混淆配置**合并后的结果：
+
+即如果当前模块、依赖的HAR模块、依赖的三方库中混淆配置如下：
+
+```
+// current-obfuscation-rules.txt
+-enable-toplevel-obfuscation
+-keep-global-name
+currentVar
+
+// dependencyHar-consumer-rule.txt
+-enable-property-obfuscation
+-keep-global-name
+harVar
+-keep-property-name
+harProp
+
+// dependencyThirdParty-obfuscation.txt
+-compact
+-keep-property-name
+thirdPartyProp
+```
+
+那么编译当前模块时生效的混淆规则为：
+
+```
+-enable-toplevel-obfuscation
+-enable-property-obfuscation
+-compact
+-keep-global-name
+currentVar
+harVar
+-keep-property-name
+harProp
+thirdPartyProp
+```
+
+变更后:
+
+编译一个模块时，生效的混淆规则为当前模块所有混淆配置与依赖模块及三方库的**混淆保留选项**合并后的结果：
+
+即对于上面的例子，编译当前模块时生效的混淆规则为：
+
+```
+-enable-toplevel-obfuscation
+-keep-global-name
+currentVar
+harVar
+-keep-property-name
+harProp
+thirdPartyProp
+```
+
+**起始API Level**
+
+10
+
+**变更的接口/组件**
+
+不涉及
+
+**适配指导**
+
+在当前编译模块的混淆配置文件obfuscation-rules.txt中配置混淆开关选项-enable-lib-obfuscation-options，可实现编译当前模块时合并依赖模块及三方库中所有的混淆配置，即规则合并功能与变更前一致。
+
+## ArkUI
+
+### getKeyboardAvoidMode接口返回值变更
+
+**变更原因**
+
+getKeyboardAvoidMode接口实际返回值为字符串，与文档描述返回值为KeyboardAvoidMode枚举值类型不符。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+-   变更前：getKeyboardAvoidMode接口返回字符串类型。
+    
+-   变更后：getKeyboardAvoidMode接口返回KeyboardAvoidMode枚举值，为整数类型。
+    
+
+**起始API Level**
+
+11
+
+**变更的接口/组件**
+
+getKeyboardAvoidMode
+
+**适配指导**
+
+如下代码实现：
+
+```typescript
+//EntryAbility.ets
+import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { window } from '@kit.ArkUI';
+import { KeyboardAvoidMode } from '@kit.ArkUI';
+
+const DOMAIN = 0x0000;
+
+export default class EntryAbility extends UIAbility {
+  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
+    this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
+  }
+
+  onDestroy(): void {
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onDestroy');
+  }
+
+  onWindowStageCreate(windowStage: window.WindowStage): void {
+    // Main window is created, set main page for this ability
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
+
+    windowStage.loadContent('pages/Index', (err) => {
+      let keyboardAvoidMode = windowStage.getMainWindowSync().getUIContext().getKeyboardAvoidMode();
+      hilog.info(0x0000, '========keyboardAvoidMode========: %{public}s', JSON.stringify(keyboardAvoidMode));
+      if (keyboardAvoidMode === KeyboardAvoidMode.OFFSET) {
+        windowStage.getMainWindowSync().getUIContext().setKeyboardAvoidMode(KeyboardAvoidMode.RESIZE)
+      }
+      let keyboardAvoidMode1 = windowStage.getMainWindowSync().getUIContext().getKeyboardAvoidMode();
+      hilog.info(0x0000, '========keyboardAvoidMode========: %{public}s', JSON.stringify(keyboardAvoidMode1));
+      if (err.code) {
+        hilog.error(DOMAIN, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err));
+        return;
+      }
+      hilog.info(DOMAIN, 'testTag', 'Succeeded in loading the content.');
+    });
+  }
+
+  onWindowStageDestroy(): void {
+    // Main window is destroyed, release UI related resources
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
+  }
+
+  onForeground(): void {
+    // Ability has brought to foreground
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
+  }
+
+  onBackground(): void {
+    // Ability has back to background
+    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
+  }
+}
+```
+```
+//Index.ets
+@Entry
+@Component
+struct KeyboardAvoidExample1 {
+  build() {
+    Column() {
+      Row().height("30%").width("100%").backgroundColor(Color.Gray)
+      TextArea().width("100%").borderWidth(1)
+      Text("I can see the bottom of the page").width("100%").textAlign(TextAlign.Center).backgroundColor('rgb(179,217,235)').layoutWeight(1)
+    }.width('100%').height("100%")
+  }
+}
+```
+
+### XComponent组件上使用renderFit接口显示效果变更
+
+**变更原因**
+
+优化XComponent组件上使用renderFit接口显示效果的正确性。
+
+**变更影响**
+
+此变更要求涉及XComponent组件上使用renderFit接口的应用进行适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+-   变更前：在XComponent组件上使用renderFit接口，使用部分fit模式的显示效果不符合预期。
+    
+-   变更后：XComponent组件上使用renderFit接口后，可以正确显示。
+    
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/79/v3/BnI6mJPmSYSouV0mPug54g/zh-cn_image_0000002295394565.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=F655B062B4F0D4BCC05E5B8396D324CA6F84CC98C5A6BDD8BD3181E6F726382E)
+
+**起始API Level**
+
+10
+
+**变更的接口/组件**
+
+涉及接口: renderFit。
+
+涉及组件: XComponent组件。
+
+**适配指导**
+
+默认行为变更，涉及XComponent组件上使用renderFit接口的应用进行适配，若出现显示效果变更，则需要按照正确效果进行布局。
+
+### 当使用自定义组件名和内置属性重名时编译报错变更
+
+**变更原因**
+
+当使用自定义组件名和内置属性重名时，编译会根据指定的白名单进行拦截报错，如果白名单中不存在，编译就拦截不到，导致编译转换后的产物出现问题。
+
+**变更影响**
+
+该变更涉及应用适配。
+
+举例说明，执行以下用例：
+
+```
+@Entry
+@Component
+struct enableAnalyzer {
+  build() {
+    Canvas()
+      .enableAnalyzer(true)
+  }
+}
+```
+
+变更前：
+
+不在白名单的内置组件属性与自定义组件重名时，编译没有拦截报错，导致运行时crash。
+
+变更后：
+
+在白名单的内置组件属性与自定义组件重名时，编译拦截报错。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/08/v3/G-3HBGkHREOOKlFqTe3Gpw/zh-cn_image_0000002260714460.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=8277FAB8F44CD018D80907C1657BA2ADC528D58096329709CF82D1F49187744D)
+
+**起始API Level**
+
+10
+
+**变更的接口/组件**
+
+ArkUI 内置组件属性API。
+
+**适配指导**
+
+自定义组件名和内置组件属性重名时，编译报错，修改自定义组件名为其他非内置组件属性名即可解决。
+
+修改前：
+
+自定义组件enableAnalyzer和Canvas的enableAnalyzer重名。
+
+```
+@Entry
+@Component
+struct enableAnalyzer {
+  build() {
+    Canvas()
+      .enableAnalyzer(true)
+  }
+}
+```
+
+修改后：
+
+将自定义组件名改为任意不和内置组件重名的名称，如EnableAnalyzerComp。
+
+```
+@Entry
+@Component
+struct EnableAnalyzerComp {
+  build() {
+    Canvas()
+      .enableAnalyzer(true)
+  }
+}
+```
+
+### CanvasRenderingContext2D方法传NaN和Infinity值后执行的其他绘制方法由不绘制变更为正常绘制
+
+**变更原因**
+
+CanvasRenderingContext2D绘制路径时，若存在方法的number类型参数传入NaN或Infinity值，部分内容无法绘制或绘制异常，与Html5的行为不一致。
+
+**变更影响**
+
+此变更不涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+变更前：绘制路径时，若存在路径方法的number类型参数传入NaN或Infinity值，整个路径无法绘制；对画布进行缩放、旋转、移动或使用变换矩阵进行图形变化时，number类型参数传入NaN或Infinity值，后面执行的方法无法绘制。
+
+变更后：绘制路径时，传入NaN或Infinity值的方法不做处理，根据有效的路径参数进行绘制；对画布进行缩放、旋转、移动或使用变换矩阵进行图形变化时，number类型参数传入NaN或Infinity值，其他传入有效参数的方法正常绘制。
+
+具体接口的差异如下：
+
+| 方法 | 变更前 | 变更后 |
+| --- | --- | --- |
+| moveTo | 任一路径绘制方法的number类型参数传入NaN或Infinity值时，整个路径无法绘制。 | 路径绘制方法的number类型参数传入NaN或Infinity值时，该方法不生效。其他传入有效参数的路径绘制方法正常绘制。 |
+| lineTo | 任一路径绘制方法的number类型参数传入NaN或Infinity值时，整个路径无法绘制。 | 路径绘制方法的number类型参数传入NaN或Infinity值时，该方法不生效。其他传入有效参数的路径绘制方法正常绘制。 |
+| bezierCurveTo | 任一路径绘制方法的number类型参数传入NaN或Infinity值时，整个路径无法绘制。 | 路径绘制方法的number类型参数传入NaN或Infinity值时，该方法不生效。其他传入有效参数的路径绘制方法正常绘制。 |
+| quadraticCurveTo | 任一路径绘制方法的number类型参数传入NaN或Infinity值时，整个路径无法绘制。 | 路径绘制方法的number类型参数传入NaN或Infinity值时，该方法不生效。其他传入有效参数的路径绘制方法正常绘制。 |
+| arc | 任一路径绘制方法的number类型参数传入NaN或Infinity值时，整个路径无法绘制。 | 路径绘制方法的number类型参数传入NaN或Infinity值时，该方法不生效。其他传入有效参数的路径绘制方法正常绘制。 |
+| ellipse | 任一路径绘制方法的number类型参数传入NaN或Infinity值时，整个路径无法绘制。 | 路径绘制方法的number类型参数传入NaN或Infinity值时，该方法不生效。其他传入有效参数的路径绘制方法正常绘制。 |
+| rect | 任一路径绘制方法的number类型参数传入NaN或Infinity值时，整个路径无法绘制。 | 路径绘制方法的number类型参数传入NaN或Infinity值时，该方法不生效。其他传入有效参数的路径绘制方法正常绘制。 |
+| arcTo | 任一路径绘制方法的number类型参数传入NaN或Infinity值时，整个路径无法绘制。 | 路径绘制方法的number类型参数传入NaN或Infinity值时，该方法不生效。其他传入有效参数的路径绘制方法正常绘制。 |
+| globalAlpha | 绘制方法的number类型参数传入NaN或Infinity值，在该方法后执行的绘制方法无法绘制。 | number类型参数传入NaN或Infinity值参数时该方法不生效。其他传入有效参数的绘制方法正常绘制。 |
+| rotate | 绘制方法的number类型参数传入NaN或Infinity值，在该方法后执行的绘制方法无法绘制。 | number类型参数传入NaN或Infinity值参数时该方法不生效。其他传入有效参数的绘制方法正常绘制。 |
+| scale | 绘制方法的number类型参数传入NaN或Infinity值，在该方法后执行的绘制方法无法绘制。 | number类型参数传入NaN或Infinity值参数时该方法不生效。其他传入有效参数的绘制方法正常绘制。 |
+| transform | 绘制方法的number类型参数传入NaN或Infinity值，在该方法后执行的绘制方法无法绘制。 | number类型参数传入NaN或Infinity值参数时该方法不生效。其他传入有效参数的绘制方法正常绘制。 |
+| setTransform | 绘制方法的number类型参数传入NaN或Infinity值，在该方法后执行的绘制方法无法绘制。 | number类型参数传入NaN或Infinity值参数时该方法不生效。其他传入有效参数的绘制方法正常绘制。 |
+| translate | 绘制方法的number类型参数传入NaN或Infinity值，在该方法后执行的绘制方法无法绘制。 | number类型参数传入NaN或Infinity值参数时该方法不生效。其他传入有效参数的绘制方法正常绘制。 |
+| lineDashOffset | 设置了虚线样式的线条绘制出来是实线。 | 设置了虚线样式的线条绘制出来是虚线。 |
+
+| 示例 | 变更前 | 变更后 |
+| --- | --- | --- |
+| context.moveTo(100, 100)context.lineTo(NaN, 100)context.lineTo(200, 200)context.stroke() | 无绘制内容 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fb/v3/iEy_D8KPTkmNx4Uf3HhG0w/zh-cn_image_0000002260817538.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=93E37C6BC02E16FEB777B7A758475B238B717550F9676E6DA7C533D83F5744AD) |
+
+**起始API Level**
+
+9
+
+**变更的接口/组件**
+
+CanvasRenderingContext2D
+
+OffscreenCanvasRenderingContext2D
+
+Path2D
+
+**适配指导**
+
+默认行为变更，无需适配，但应注意变更后的行为是否对整体应用逻辑产生影响。
+
+### CanvasRenderingContext2D的drawImage接口默认单位变更
+
+**变更原因**
+
+当drawImage传入9个参数时，若首个参数（image）为PixelMap类型，则第2至第5个参数（sx、sy、sw和sh）以px为单位进行解析。与文档描述不一致，且绘制得到的图片大小存在问题。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+当drawImage传入9个参数时，且首个参数为PixelMap类型时：
+
+-   变更前：第2至第5个参数都会以px为单位进行解析。
+-   变更后：第2至第5个参数会以vp为单位进行解析。
+
+|  | 变更前 | 变更后 |
+| --- | --- | --- |
+| 第2至第5个参数以vp为单位传入 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/74/v3/TOOlwKcGT8aoyhUaeGUHeg/zh-cn_image_0000002295507621.jpeg?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=77CA44BFBBE4859B5E846D71F181FC5DEC87A3D46ACCCB87474C62CF1EAB00BB) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/40/v3/gFoupHkpSpOHNOjjkdApbA/zh-cn_image_0000002295394569.jpeg?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=BDA294A5BF968E0CC109452220968BF16E91E7B097044324AE2E25762F144ADA) |
+| 第2至第5个参数以px为单位传入 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/76/v3/eVgyzXvySL-kyl-KTqEaFw/zh-cn_image_0000002260714464.jpeg?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=3099E5F71172623433F5BD54FAC5B522CD32A8707C8F3BCBE83B23125D222A86) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e8/v3/5TGVcGDfQKyL_0QZabc1CA/zh-cn_image_0000002260817542.jpeg?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=694C476FC5BB8C3AE07FA7DC450309955FA03ADFCBEFB74864F979855A81513A) |
+
+**起始API Level**
+
+9
+
+**变更的接口/组件**
+
+CanvasRenderingContext2D的drawImage接口
+
+**适配指导**
+
+变更后，使用drawImage接口时，若传入9个参数，且首个参数为PixelMap类型时，要注意第2至第5个参数会以vp为单位进行解析。
+
+示例:
+
+```typescript
+import { image } from '@kit.ImageKit'
+
+@Entry
+@Component
+struct Demo {
+  private settings: RenderingContextSettings = new RenderingContextSettings(true)
+  private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
+
+  build() {
+    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
+      Canvas(this.context)
+        .width('100%')
+        .height('100%')
+        .onReady(() => {
+          let context = getContext(this)
+          let imageSourceApi = image.createImageSource(context.filesDir + "/view.jpg")
+          let pixelmap = imageSourceApi.createPixelMapSync();
+          let imageInfo = pixelmap.getImageInfoSync()
+          let width = px2vp(imageInfo.size.width)
+          let height = px2vp(imageInfo.size.height)
+          this.context.drawImage(pixelmap, 0, 0, width, height, 50, 50, 250, 200)
+          this.context.drawImage(pixelmap, 0, 0, imageInfo.size.width, imageInfo.size.height, 50, 300, 250, 200)
+        })
+    }
+    .width('100%')
+    .height('100%')
+  }
+}
+```
+
+### 修复blendMode接口离屏模式会影响组件设置的不透明度的问题
+
+**变更原因**
+
+blendMode离屏模式与不透明度属性（opacity）同时使用时，组件的不透明度并不等于设置的不透明度，效果异常。
+
+**变更影响**
+
+此变更涉及应用适配，仅针对组件设置了blendMode离屏模式且具有不透明度的场景。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+变更前：组件设置了blendMode离屏模式，同时设置了opacity不透明度 A，则组件实际不透明度为 A \* A
+
+变更后：组件设置了blendMode离屏模式，同时设置了opacity不透明度 A，则组件实际不透明度为 A
+
+变更前后效果如下:
+
+| 变更前 | 变更后 |
+| --- | --- |
+| ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ee/v3/MS5nSIpzQmq7X0-pQDEspA/zh-cn_image_0000002295507625.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=4CE72AC85C34F13A14BADFC080E3B32D49FAFC498D9C2306F2665DDEF807B5B6) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/df/v3/yXmZWDRCR9Gvyqh_SKpjIg/zh-cn_image_0000002295394573.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=C63221819D90F38E0DDF9A84419087A8B166462F5E9152A6EFCC30EA2A11E5A0) |
+
+**起始API Level**
+
+11
+
+**变更的接口/组件**
+
+blendMode
+
+**适配指导**
+
+如果开发者希望在同时使用blendMode离屏模式和opacity接口时保持组件的不透明度不变，则需要手动调整原本设定的不透明度。例如，在下方示例代码中，在 Stack()上额外设置.opacity(0.5)，以确保实际的透明度为 0.5 \* 0.5。
+
+```
+@Entry
+@Component
+struct Index {
+  build() {
+    Column() {
+       Stack() {
+       }
+       .height('50%')
+       .width('50%')
+       .backgroundColor(0x0A59F7)
+       .blendMode(BlendMode.SRC_OVER, BlendApplyType.OFFSCREEN)
+       .opacity(0.5)  // 变更后需要额外设置0.5的不透明度保证实际透明度为 0.5*0.5
+    }
+    .height('100%')
+    .width('100%')
+    .backgroundColor(0xFFFFFF)
+    .opacity(0.5)
+  }
+}
+```
+
+### XComponent设置为Texture模式使用blendMode接口的行为由不生效变更为正常生效
+
+**变更原因**
+
+用户使用XComponent组件并设置为Texture模式时，使用blendMode接口没有效果，不符合接口正常规格，需要变更为blendMode接口正常生效。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+变更前：XComponent组件设置为Texture模式，使用blendMode接口不生效。
+
+变更后：XComponent组件设置为Texture模式，使用blendMode接口正常生效。
+
+**起始API Level**
+
+11
+
+**变更的接口/组件**
+
+common.d.ts文件的blendMode接口。
+
+**适配指导**
+
+需适配场景：
+
+当应用使用XComponent组件并设置为Texture模式（type设置为XComponentType.TEXTURE）时，使用blendMode接口，可能会出现显示效果变更前后不一致的情况，以下是使用场景示意：
+
+```
+@Entry
+@Component
+struct Index {
+  private contextOne: Record<string, () => void> = {};
+  private contextTwo: Record<string, () => void> = {};
+
+  build() {
+    Column() {
+      Stack() {
+        XComponent({
+          id: 'circle',
+          type: XComponentType.TEXTURE,
+          libraryname: 'nativerender'
+        }).height(50)
+          .backgroundColor(Color.Transparent)
+          .onLoad((contextOne?: object | Record<string, () => void>) => {
+            if (contextOne) {
+              this.contextOne = contextOne as Record<string, () => void>;
+            }
+          })
+
+        XComponent({
+          id: 'rect',
+          type: XComponentType.TEXTURE,
+          libraryname: 'nativerender'
+        }).height(50)
+          .backgroundColor(Color.Transparent)
+          .onLoad((contextTwo?: object | Record<string, () => void>) => {
+            if (contextTwo) {
+              this.contextTwo = contextTwo as Record<string, () => void>;
+            }
+          })
+          .blendMode(BlendMode.XOR) // 变更后生效，若需保持变更前行为，可使用BlendMode.None入参
+      }
+      .height(50)
+      .onClick(() => {
+        if (this.contextOne) {
+          this.contextOne.drawCircle();
+        }
+        if (this.contextTwo) {
+          this.contextTwo.drawRectangle();
+        }
+      })
+    }
+    .blendMode(BlendMode.SRC_OVER, BlendApplyType.OFFSCREEN)
+    .width('100%')
+    .height('100%')
+  }
+}
+```
+
+| 混合类型 | 变更前 | 变更后 |
+| --- | --- | --- |
+| BlendMode.XOR | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4f/v3/x3fM_tQDR3CfidJmO1d6bQ/zh-cn_image_0000002260714468.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=0866BE48D470F4AEF1D7FFC6B6EB9164F277F048E7BCEE0FAD0C681F1835B2F3) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9a/v3/HkgN9dEsSP20k5bhdbd87Q/zh-cn_image_0000002260817546.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=BBB193EDBD348ABC5FEDEB64BE90516A4955E49688A626DD59CC4FB8CFB7EA60) |
+| BlendMode.NONE | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3a/v3/GmU6lRCrQrmw-zyTQeZ8Ng/zh-cn_image_0000002260714468.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=CFEA4160F17EB4AA5AFC44EB0AAD72B908BD7896FAFA3B2150DA1EAAB6BE489C) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d8/v3/l_b56j7_TwaqtjneQGIQYQ/zh-cn_image_0000002260714468.png?HW-CC-KV=V1&HW-CC-Date=20260903T083915Z&HW-CC-Expire=86400&HW-CC-Sign=B9F4BA90517FF894FFA2FEC13F118858802EF1E147BB4CF0994E5C302BA4B72C) |
+
+应用若需保持变更前行为，XComponent组件上的blendMode接口使用BlendMode.None入参即可。
+
+### setSpecificSystemBarEnabled接口在横屏的行为变更
+
+**变更原因**
+
+修正接口规格，保证接口调用在不同场景下均可正常控制状态栏显隐。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：应用窗口处于横屏状态时，应用使用该接口设置状态栏显隐不生效，状态栏始终处于隐藏状态。
+
+变更后：应用启动之后，若使用该接口设置过状态栏的显隐，状态栏的显隐状态则以应用的设置（多次设置，以最后一次设置状态为准）为准来生效。
+
+**起始API Level**
+
+12
+
+**变更的接口/组件**
+
+Window#setSpecificSystemBarEnabled(name: SpecificSystemBar, enable: boolean, enableAnimation?: boolean): Promise<void>
+
+**适配指导**
+
+针对应用预期在横屏时隐藏状态栏的场景，需确认应用自启动之后是否使用该接口主动设置过状态栏显示，若应用设置过状态栏显示，需再次设置状态栏隐藏，才能实现应用横屏时隐藏状态栏。
+
+### 滚动组件通用接口backToTop属性默认值变更
+
+**变更原因**
+
+List、Grid、Scroll和WaterFlow组件默认不支持点击状态栏回到顶部，为了推广点击状态栏回到顶部特性，提升应用体验，List、Grid、Scroll和WaterFlow组件修改为默认支持点击状态栏回到顶部。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+-   变更前：List、Grid、Scroll和WaterFlow组件backToTop属性默认值为false，默认不支持点击状态栏回到顶部。
+    
+-   变更后：API 18及以后版本，List、Grid、Scroll和WaterFlow组件滚动方向为垂直方向时，backToTop属性默认值为true，默认支持点击状态栏回到顶部。
+    
+
+**起始API Level**
+
+15
+
+**变更的接口/组件**
+
+涉及接口：backToTop属性。
+
+涉及组件：List、Grid、Scroll和WaterFlow组件。
+
+**适配指导**
+
+默认行为变更，涉及List、Grid、Scroll和WaterFlow组件的应用需进行适配，若期望不支持点击状态栏回到顶部功能，则需要设置backToTop属性为false。
+
+### 页面退出场景自定义组件删除前移
+
+**变更原因**
+
+在页面退出动画的过程中，UI处于空闲状态。动画结束后，由于释放大量组件导致页面卡顿。可以将页面中自定义组件的释放提前，显著减轻卡顿并优化性能。
+
+**变更影响**
+
+此变更涉及应用适配（仅针对Router和Navigation页面默认的退出动画场景）。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+-   变更前：页面退出动画结束后，依次执行自定义组件生命周期aboutToDisappear、onDisappear。
+    
+-   变更后：页面退出动画过程中，执行自定义组件生命周期aboutToDisappear。退出动画执行结束后，执行生命周期onDisappear。
+    
+
+**起始API Level**
+
+7
+
+**变更的接口/组件**
+
+自定义组件的onDisappear生命周期回调。
+
+**适配指导**
+
+在全局复用场景中，当复用的自定义组件的aboutToDisappear生命周期回调中涉及节点移除操作时，应将节点移除操作安排在页面退出完成后，例如onDetach生命周期。
+
+### V1和V2组件冻结能力增强
+
+**变更原因**
+
+开发者使用组件冻结功能后，以下场景冻结功能实际未生效：支持冻结的组件嵌套使用的解冻场景、V2自定义组件的解冻场景、Repeat VirtualScroll的复用场景。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+变更前：启用组件冻结，组件冻结实际功能未生效，因此在组件嵌套使用的解冻场景、V2自定义组件的冻结场景、Repeat VirtualScroll的复用场景，其相关的状态变量能够刷新、@Watch/@Monitor方法会执行。
+
+变更后：启用组件冻结，组件冻结实际功能会生效，在组件嵌套使用的解冻场景、V2自定义组件的冻结场景、Repeat VirtualScroll的复用场景，其相关的状态变量不再刷新、@Watch/@Monitor方法不会执行。
+
+举例说明，执行以下用例：
+
+```
+@Entry
+@ComponentV2
+struct RepeatVirtualScrollDemo {
+  @Local simpleList: Array<string> = [];
+  @Local bgColor: Color = Color.Pink;
+
+  aboutToAppear(): void {
+    for (let i = 0; i < 7; i++) {
+      this.simpleList.push(`item${i}`);
+    }
+  }
+
+  build() {
+    Column() {
+      Row() {
+        Button(`Reduce length to 5`)
+          .onClick(() => {
+            this.simpleList = this.simpleList.slice(0, 5);
+          })
+        Button(`Change bgColor`)
+          .onClick(() => {
+            this.bgColor = this.bgColor == Color.Pink ? Color.Blue : Color.Pink;
+          })
+      }
+
+      List() {
+        Repeat(this.simpleList)
+          .each((obj: RepeatItem<string>) => {
+          })
+          .key((item: string, index: number) => item)
+          .virtualScroll({ totalCount: this.simpleList.length })
+          .templateId(() => `a`)
+          .template(`a`, (ri) => {
+            ChildComponent({
+              message: ri.item,
+              bgColor: this.bgColor
+            })
+          }, { cachedCount: 2 })
+      }
+      .cachedCount(0)
+      .height(500)
+    }
+    .height(`100%`)
+  }
+}
+
+@ComponentV2({ freezeWhenInactive: true })
+struct ChildComponent {
+  @Param @Require message: string;
+  @Param @Require bgColor: Color;
+  // 支持后二级缓存中的组件不刷新，不会打印相应日志
+  @Monitor(`bgColor`)
+  onMessageChange(monitor: IMonitor) {
+    monitor.dirty.forEach((path: string) => {
+      console.log(`repeat---${path} change from ${monitor.value(path)?.before} to ${monitor.value(path)?.now}`)
+    })
+  }
+
+  build() {
+    Text(`[a]: ${this.message}`)
+      .fontSize(50)
+      .backgroundColor(this.bgColor)
+  }
+}
+```
+
+**起始API Level**
+
+12
+
+**变更的接口/组件**
+
+freezeWhenInactive。
+
+**适配指导**
+
+展示效果不变，组件冻结生效后，@Monitor/@Watch将不再执行。如果需要刷新缓存中的数据，可以关闭组件冻结。
+
+```
+// 关闭组件冻结，freezeWhenInactive设置为false
+@ComponentV2({ freezeWhenInactive: false })
+struct ChildComponent {
+  @Param @Require message: string;
+  @Param @Require bgColor: Color;
+  // 关闭冻结后，二级缓存中的组件会刷新，并打印相应日志
+  @Monitor(`bgColor`)
+  onMessageChange(monitor: IMonitor) {
+    monitor.dirty.forEach((path: string) => {
+      console.log(`repeat---${path} change from ${monitor.value(path)?.before} to ${monitor.value(path)?.now}`)
+    })
+  }
+
+  build() {
+    Text(`[a]: ${this.message}`)
+      .fontSize(50)
+      .backgroundColor(this.bgColor)
+  }
+}
+```
+
+示例中仅展示了Repeat VirtualScroll的复用场景，其他场景如下：
+
+-   组件嵌套使用的解冻场景：在组件冻结开启之后，明确了节点解冻的范围，子组件的非屏上节点不会再被父组件解冻，例子可见[Navigation和TabContent的混用](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-custom-components-freeze#组件混用)。
+    
+-   V2自定义组件的冻结场景：在状态管理V2组件冻结从父组件激活冻结状态的场景中，如果仅子组件开启了冻结，父组件未开启冻结，子组件也能冻结。例子可见[仅子组件开启组件冻结](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-custom-components-freezev2#仅子组件开启组件冻结)。
+    
+
+### ArkUI双指长按行为变更
+
+**变更原因**
+
+在手机、平板设备上，优先响应系统双指操作，默认禁用应用内双指长按。
+
+**变更影响**
+
+此变更涉及应用适配。变更后双指长按手势事件默认为系统事件。如果应用需使用双指长按，可通过[IssueReporter平台](https://issuereporter.developer.huawei.com/my-created)向华为申请白名单例外处理。
+
+变更前：应用可通过LongPressGesture长按手势的fingers参数指定触发长按的最少手指数，手指数大于等于1时，即可触发长按手势事件。不指定触发长按的最小手指数时，默认为1。
+
+变更后：使用两根手指长按组件时，不会触发长按手势。使用一根及多根手指长按组件时，长按手势事件触发不受影响。
+
+**起始API Level**
+
+7
+
+**变更的接口/组件**
+
+长按手势 LongPressGesture
+
+## Audio Kit
+
+### 音频框架识别USB音频设备类型行为变更
+
+**变更原因**
+
+原有的USB音频设备在系统侧均识别为耳机输入/输出设备。为了提高识别的准确度，满足应用的UX显示需求，系统侧区分USB耳机和普通的USB音频设备(如音箱)。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+ArkTS API
+
+| 平台 | 变更前 | 变更后 |
+| --- | --- | --- |
+| 通用 | 同USB地址下只有输入设备，识别为USB_HEADSET。 | 同USB地址下只有输入设备，识别为USB_DEVICE。 |
+| PC/2in1 | 同USB地址下只有输出设备，识别为USB_HEADSET。 | 同USB地址下只有输出设备，识别为USB_DEVICE。 |
+
+C API
+
+| 平台 | 变更前 | 变更后 |
+| --- | --- | --- |
+| 通用 | 同USB地址下只有输入设备，识别为AUDIO_DEVICE_USB_HEADSET。 | 同USB地址下只有输入设备，识别为AUDIO_DEVICE_USB_DEVICE。 |
+| PC/2in1 | 同USB地址下只有输出设备，识别为AUDIO_DEVICE_USB_HEADSET。 | 同USB地址下只有输出设备，识别为AUDIO_DEVICE_USB_DEVICE。 |
+
+**起始API Level**
+
+9
+
+**变更的接口/组件**
+
+ArkTS：@ohos.multimedia.audio.d.ts中DeviceType的USB\_HEADSET接口。
+
+C API: native\_audio\_device\_base.h中OH\_AudioDevice\_Type的AUDIO\_DEVICE\_USB\_HEADSET接口。
+
+**适配指导**
+
+ArkTS API
+
+如应用对USB音频设备有特殊处理需求，现在不仅需要处理USB\_HEADSET类型的音频设备，还需将USB\_DEVICE类型也纳入到处理范围内。
+
+```
+// 针对usb音频设备做特殊处理
+if (devicetype == DeviceType.USB_HEADSET) {
+  // do sth
+}
+```
+
+变更后：如应用对USB音频设备有特殊处理需求，不仅要考虑USB\_HEADSET类型，也要考虑USB\_DEVICE类型的音频设备。
+
+```
+// 针对usb音频设备做特殊处理
+if (devicetype == DeviceType.USB_HEADSET || devicetype == DeviceType.USB_DEVICE) {
+  // do sth
+}
+```
+
+C API
+
+如应用对USB音频设备有特殊处理需求，现在不仅需要处理AUDIO\_DEVICE\_USB\_HEADSET类型的音频设备，还需将AUDIO\_DEVICE\_USB\_DEVICE类型也纳入到处理范围内。
+
+变更前：如应用对USB音频设备有特殊处理需求，仅处理AUDIO\_DEVICE\_USB\_HEADSET类型的音频设备即可。
+
+```
+// 针对usb音频设备做特殊处理
+if (devicetype == OH_AudioDevice_Type.AUDIO_DEVICE_USB_HEADSET) {
+  // do sth
+}
+```
+
+变更后：如应用对USB音频设备有特殊处理需求，不仅要考虑AUDIO\_DEVICE\_USB\_HEADSET类型，也要考虑AUDIO\_DEVICE\_USB\_DEVICE类型的音频设备。
+
+```
+// 针对usb音频设备做特殊处理
+if (devicetype == OH_AudioDevice_Type.AUDIO_DEVICE_USB_HEADSET || devicetype == OH_AudioDevice_Type.AUDIO_DEVICE_USB_DEVICE) {
+  // do sth
+}
+```
+
+## Basic Services Kit
+
+### osAccount.distributedAccount.DistributedAccountAbility.getOsAccountDistributedInfo接口返回值生成规则变更
+
+**变更原因**
+
+原接口返回值生成规则与设计不符。
+
+**变更影响**
+
+此变更不涉及应用适配。
+
+变更前：接口返回值中name、id、nickname、avatar 和 scalableData 生成规则与设计不符。
+
+变更后：修正相关属性的生成规则，较变更前，同一分布式账号信息查询结果有差异。
+
+**起始API Level**
+
+9
+
+**变更的接口/组件**
+
+@ohos.account.distributedAccount.d.ts中如下接口:
+
+-   getOsAccountDistributedInfo(callback: AsyncCallback<DistributedInfo>): <void>
+-   getOsAccountDistributedInfo(): Promise<DistributedInfo>
+
+**适配指导**
+
+默认行为变更，无需适配。
+
+## CANN Kit（原HiAI Foundation Kit）
+
+### 原hiai\_foundation目录下的头文件废弃，替换为CANNKit下的头文件
+
+**变更原因**
+
+命名优化。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+在应用导入依赖时，强烈建议使用更名后的kit，即CANNKit目录下的文件。原hiai\_foundation目录将在短暂保留若干版本提供过度之后删除，建议应用择机完成适配。
+
+| C API头文件变更前 | C API头文件变更后 |
+| --- | --- |
+| hiai_foundation/hiai_aipp_param.h | CANNKit/hiai_aipp_param.h |
+| hiai_foundation/hiai_helper.h | CANNKit/hiai_helper.h |
+| hiai_foundation/hiai_options.h | CANNKit/hiai_options.h |
+| hiai_foundation/hiai_tensor.h | CANNKit/hiai_tensor.h |
+| hiai_foundation/hiai_single_op.h | CANNKit/hiai_single_op.h |
+
+**起始API Level**
+
+4.1.0(11)
+
+**变更的接口/组件**
+
+不涉及
+
+**适配指导**
+
+C API：以导入hiai\_aipp\_param.h为例
+
+导入hiai\_aipp\_param.h时，需要使用新的kit路径，其他代码不需要修改：
+
+变更前：#include "hiai\_foundation/hiai\_aipp\_param.h"
+
+变更后：#include "CANNKit/hiai\_aipp\_param.h"
+
+## Device Security Kit
+
+### Device Security Kit优化错误码上报
+
+**变更原因**
+
+Device Security Kit优化错误码类型，新增更明细的错误码。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+| 变更前 | 变更后 |
+| --- | --- |
+| 已有错误码：201 权限校验失败401 参数检查失败1010800001 内部异常1010800002 设备网络异常1010800003 访问云端服务器异常 | 新增错误码：801 API不支持1010800005 调用数量超过并行阈值1010800006 调用频率超过阈值1010800007 操作超时1010800008 云服务流量超过阈值 |
+
+**起始API Level**
+
+12
+
+**变更的接口/组件**
+
+-   checkUrlThreat
+-   checkSysIntegrity
+
+**适配指导**
+
+调用接口需要try...catch捕获异常，获取到异常时可以判断对应错误码信息，做对应的处理。
+
+```
+const TAG = "SafetyDetectJsTest";
+try {
+   // 调用URL检测接口或者系统完整性检测接口
+} catch (err) {
+  let e: BusinessError = err as BusinessError;
+  hilog.error(0x0000, TAG, 'CheckSysIntegrity failed: %{public}d %{public}s', e.code, e.message);
+  // 对不同错误码做处理：
+  // 如果返回801，则该设备不支持当前API，不应再次调用该接口。
+  // 如果返回401，则检查参数规格是否与资料规格一致。
+  // 如果返回1010800005，则当前请求超出请求次数，过一天可恢复使用，此时不应重试。
+  // 如果返回1010800006 ，则可延迟1秒后重试
+  // 如果返回1010800008 ，则延迟5秒重试，如果重试再次失败，则每次以指数递增间隔重试。
+  // 如果返回1010800007，则可重试处理。
+}
+```
+
+## Form Kit
+
+### 卡片支持的接口能力增加校验
+
+**变更原因**
+
+针对支持卡片能力的接口，增加校验。
+
+**变更影响**
+
+此变更不涉及应用适配。
+
+变更后针对未标识卡片能力的接口或模块，卡片UI侧代码会调用失败导致卡片加载显示失败。
+
+**起始API Level**
+
+不涉及
+
+**变更的接口/组件**
+
+不涉及
+
+**适配指导**
+
+默认行为变更，无需适配。
+
+## Media Kit
+
+### 应用创建SoundPool时调用media.createSoundPool接口变更
+
+**变更原因**
+
+原来的应用创建SoundPool实例，一个应用进程只能够创建一个SoundPool实例，为单实例模式，无法满足应用的使用场景。例如很多应用在使用SoundPool的能力的同时，还需要使用TimePicker组件(该组件中封装了SoundPool的能力)，单实例模式会使得SoundPool对象之间互相干扰，影响应用的使用体验。
+
+**变更影响**
+
+此变更不涉及应用适配。
+
+变更前：创建的SoundPool对象底层为单实例模式，一个应用进程只能够创建1个SoundPool实例。
+
+变更后：创建的SoundPool对象底层为多实例模式，一个应用进程最多能够创建128个SoundPool实例。
+
+**起始API Level**
+
+18
+
+**变更的接口/组件**
+
+无变更接口
+
+**适配指导**
+
+默认行为变更，无需适配。
+
+## Performance Analysis Kit
+
+### 用户态trace打点格式变更
+
+**变更原因**
+
+优化调整原有用户态trace打点格式，提高用户态trace打点格式的前向兼容性。
+
+**变更影响**
+
+此变更不涉及应用适配。
+
+此变更涉及自研Trace解析工具适配，具体变更内容如表中所示。
+
+变更前：taskId和count字段前的分隔符为空格。
+
+变更后：各字段均使用竖线作为分隔符。
+
+| 打点类型 | API_C接口 | API_JS接口 | 变更前打点格式 | 变更后打点格式 |
+| --- | --- | --- | --- | --- |
+| 开启异步Trace打点 | OH_HiTrace_StartAsyncTrace | startTrace | S|PID|H:name taskId | S|PID|H:name|taskId |
+| 结束异步Trace打点 | OH_HiTrace_FinshAsyncTrace | finishTrace | F|PID|H:name taskId | F|PID|H:name|taskId |
+| 整数Trace打点 | OH_HiTrace_CountTrace | traceByValue | C|PID|H:name count | C|PID|H:name|count |
+
+**用户态trace格式拓展规则**
+
+对后续新增字段，将以**竖线+字段**的方式，追加在当前打点格式的末尾。
+
+假设 S|PID|H:name|taskId 新增字段args1和args2，用户态trace格式变化如下所示：
+
+-   原格式
+    
+    ```
+    S|PID|H:name|taskId
+    ```
+    
+-   新增args1和args2字段后格式
+    
+    ```
+    S|PID|H:name|taskId|args1|args2
+    ```
+    
+    **特殊场景说明** ：因为后续新增字段并不是所有场景都会使用，所以实际字段值可能为空字符串，当有字段为空字符串时，trace格式变化如下所示：
+    
+    -   args1为空字符串，args2不为空字符串
+        
+        ```
+        S|PID|H:name|taskId||args2
+        ```
+        
+    -   args1不为空字符串，args2为空字符串
+        
+        ```
+        S|PID|H:name|taskId|args1
+        ```
+        
+    -   args1和args2均为空字符串
+        
+        ```
+        S|PID|H:name|taskId
+        ```
+        
+
+详细的用户态trace格式说明参考文档[hitracemeter-view](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hitracemeter-view)。
+
+**起始API Level**
+
+-   OH\_HiTrace\_StartAsyncTrace：10
+-   OH\_HiTrace\_FinshAsyncTrace：10
+-   OH\_HiTrace\_CountTrace：10
+-   startTrace：12
+-   finishTrace
+-   traceByValue
+
+**变更的接口/组件**
+
+-   OH\_HiTrace\_StartAsyncTrace
+-   OH\_HiTrace\_FinshAsyncTrace
+-   OH\_HiTrace\_CountTrace
+-   startTrace
+-   finishTrace
+-   traceByValue
+
+**适配指导**
+
+默认行为变更，无需适配。
+
+自研Trace解析工具可根据前述**变更影响**中对打点格式变更的介绍自行适配。
+
+## Remote Communication Kit
+
+### fetch接口新增错误码返回
+
+**变更原因**
+
+系统决策使用蜂窝网络发送网络请求时，如果不满足拉起蜂窝网络的条件，返回1007900986错误码。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.1.0(18)时生效。
+
+API version 18以下不满足拉起蜂窝条件不会抛出1007900986错误码。
+
+API version 18不满足拉起蜂窝条件抛出1007900986错误码。
+
+**起始API Level**
+
+4.1.0(11)
+
+**变更的接口/组件**
+
+fetch接口
+
+**适配指导**
+
+调用接口需要try ctach异常，获取到异常时可以判断对应错误码信息，如果是1007900986错误码，代表当前不满足拉起蜂窝条件（比如用户开启飞行模式、去激活SIM卡等场景）。
+
+```
+const session = rcp.createSession();
+let request = new rcp.Request("http://example.com/fetch"); // 请在使用中将其替换为实际的网址。
+request.configuration = {
+  transfer: {
+    pathPreference: 'cellular', // 系统自动决策是否使用蜂窝网络发送网络请求。
+  }
+}
+
+try {
+  let response = await session.fetch(request);
+  session.close();
+} catch (err) {
+  let e: BusinessError = err as BusinessError;
+  console.error("testRcpCellular err: " + JSON.stringify(e));
+  session.close();
+  // 对不同错误码做处理：
+  // 如果返回201，可能是没有申请ohos.permission.GET_NETWORK_INFO权限。
+  // 如果返回1007900986，代表该请求适合使用蜂窝网络，但未正确打开或配置蜂窝网络，可以提示用户进行检查。
+  // 其他可能的网络错误。
+}
+```
+
+## NDK开发
+
+### JIT功能默认关闭，需申请权限证书并通过审核后启用
+
+**变更原因**
+
+JIT（Just In Time）即时编译功能可能带来任意代码注入的风险。为了保护应用安全并维护鸿蒙系统的纯净生态，系统默认关闭JSVM的JIT功能，采用解释执行方式执行JS代码。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：
+
+API 18以下版本，默认开启JIT。
+
+变更后：
+
+API 18及以上版本，默认关闭JIT，需申请权限证书后启用。关闭后，依赖JIT的wasm接口将无法执行，且JIT与解释执行在特定场景下存在些许性能差异。
+
+**起始API Level**
+
+11
+
+**变更的接口/组件**
+
+OH\_JSVM\_CompileWasmModule：无JIT权限会返回JIT\_MODE\_EXPECTED状态码
+
+OH\_JSVM\_CompileWasmFunction：无JIT权限会返回JIT\_MODE\_EXPECTED状态码
+
+OH\_JSVM\_CreateWasmCache：无JIT权限会返回JIT\_MODE\_EXPECTED状态码
+
+OH\_JSVM\_RunScript：无JIT权限执行wasm相关脚本会失败，在特定场景下存在些许性能差异
+
+**适配指导**
+
+新上架应用若期望使用JIT权限，需向应用市场（AppGallery Connect，简称AGC）提交ohos.permission.kernel.ALLOW\_EXECUTABLE\_FORT\_MEMORY受限ACL权限的申请， 并在附带材料中说明使用JSVM引擎JIT功能的具体场景。在权限审批通过后， 开发者可从AGC网站上更新profile证书， 并对应用重新打包上架。权限申请及适配流程可参考《[申请使用受限权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/declare-permissions-in-acl)》指导完成。
+
+**说明**
+
+适配注意事项：
+
+1.  如果应用未申请相应的权限证书，却试图在配置文件中声明此权限，将会导致应用安装失败。
+2.  若在编译时报以下错误日志The ohos.permission.kernel.ALLOW\_EXECUTABLE\_FORT\_MEMORY permission under requestPermissions must be a value that is predefined within the SDK or a custom one that you have included under definePermissions.， 请将SDK更新到最新版本(大于等于5.0.3.130版本)。
+
+## 调试工具
+
+### hiperf命令行调试工具使用权限缩小
+
+**变更原因**
+
+基于对应用的安全隐私保护，调试能力遵循以下原则进行调整：
+
+1.在开发者模式下，开发者只能调试自己的应用，无法调试其他三方APP。
+
+2.调试信息不包含开发者无权读取的信息。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更后仅支持对debug应用进行调试。
+
+**起始API Level**
+
+不涉及
+
+**变更的接口/组件**
+
+hiperf命令行工具。
+
+**适配指导**
+
+将release应用修改为debug应用，重新编译调试。