@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.0.1(13)/beta3-ux-style-and-effect-changes.md

@@ -0,0 +1,222 @@
+---
+title: UX样式或效果的变更
+source: https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-ux-b106
+category: harmonyos-releases
+downloaded_at: 2026-09-03
+---
+
+# UX样式或效果的变更
+
+## QRCode深浅色适配修改
+
+**变更原因**
+
+QRCode在深色模式下使用默认颜色生成的二维码无法被正常识别。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前:在深色模式下，QRCode生成的二维码背景颜色为黑色，图案颜色为白色。
+
+变更后:在深色模式下，QRCode生成的二维码背景颜色为白色，图案颜色为黑色，与浅色模式相同。
+
+**起始API Level**
+
+12
+
+**变更的接口/组件**
+
+QRcode组件
+
+**适配指导**
+
+默认效果变更，按需适配。若需反色二维码（背景颜色为黑色，图案颜色为白色），请自定义设置color、backgroundColor实现。
+
+## 属性动画onFinish结束回调在UIAbility退后台时因有限循环动画被终止而提前触发
+
+**变更原因**
+
+属性动画在UIAbility退后台时不会停止而是继续步进，此时动画不显示但持续请求Vsync，造成了不必要的功耗浪费，故而需要变更动画行为。变更为，在UIAbility退后台时，其包含的有限循环动画会立即结束，无限循环动画依旧不结束。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：onFinish接口在相应属性动画结束时触发回调。动画不感知UIAbility的前后台状态，UIAbility退后台后，动画仍按照所设时长和循环次数步进至完成，并触发结束回调。
+
+变更后：onFinish接口在相应属性动画结束时触发回调。动画感知UIAbility的前后台状态，UIAbility退后台时，如果此时有限循环动画还未结束，该动画会被停止至终点态并触发onFinish结束回调。无限循环动画不受退后台影响，不会停止。
+
+**起始API Level**
+
+7
+
+**变更的接口/组件**
+
+AnimateParam和KeyframeAnimateParam的onFinish接口。
+
+**适配指导**
+
+默认行为变更，应注意变更后的行为是否对整体应用逻辑产生影响。
+
+## TextInput组件在非标准字体场景下showCounter接口布局变更
+
+**变更原因**
+
+在大字体时，showCounter所属的TextInput组件的下侧Margin空间不足。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：在设置showCounter后，TextInput组件的下侧Margin大小为固定的22vp，showCounter的垂直偏移量为字体高度。
+
+变更后：在设置showCounter后，标准字体下，TextInput组件的下侧Margin以及垂直偏移量和变更前保持一致。非标准字体设置下，TextInput组件的下侧Margin大小为16vp加上showCounter的字体高度，垂直偏移量为8vp。
+
+设置非标准字体时，变更前后对比效果如下图所示：
+
+| 变更前 | 变更后 |
+| --- | --- |
+| ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/90/v3/ehAqssKSTFOw1RGJ8xaudg/zh-cn_image_0000002117643785.png?HW-CC-KV=V1&HW-CC-Date=20260903T083919Z&HW-CC-Expire=86400&HW-CC-Sign=2210D97434955E348954434D211608631A965108675D8BC45F13EC29F3A53DE4) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d4/v3/xoKYO-w1QcurHcg9z2KvOg/zh-cn_image_0000002117728853.png?HW-CC-KV=V1&HW-CC-Date=20260903T083919Z&HW-CC-Expire=86400&HW-CC-Sign=7316CC284336D153BD0D0DEBA932FCBEE699D5E85BA35471AAF4217D2A9BB160) |
+
+示例：
+
+```
+@Entry
+@Component
+struct Index {
+  @State message: string = 'Hello World';
+
+  build() {
+    Column() {
+      TextInput({text: "输入文字1"})
+        .showCounter(true)
+        .maxLength(10)
+      TextInput({text: "输入文字2"})
+    }
+    .height('100%')
+    .width('100%')
+  }
+}
+```
+
+**起始API Level**
+
+11
+
+**变更的接口/组件**
+
+TextInput组件showCounter接口。
+
+**适配指导**
+
+默认效果变更，无需适配，但应注意变更后的默认效果是否符合开发者预期，如不符合则应自定义修改效果控制变量以达到预期。
+
+## MenuItem组件在非PC/2in1设备上超长文本布局由缩略显示变更为换行显示
+
+**变更原因**
+
+对于使用超长文本的MenuItem组件场景，默认布局效果优化，UX体验更佳。
+
+**变更影响**
+
+此变更不涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.0.1(13)时生效。
+
+变更前：MenuItem组件含有超长文本时，文本缩略显示。
+
+变更后：API13开始，MenuItem组件含有超长文本时，在PC/2in1设备上不换行，其余设备无限换行。
+
+| 变更前长文本缩略 | 变更后非PC/2in1设备长文本换行 |
+| --- | --- |
+| ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/41/v3/T87jTC-VQOqkJ39htd7Ftw/zh-cn_image_0000002082049838.png?HW-CC-KV=V1&HW-CC-Date=20260903T083919Z&HW-CC-Expire=86400&HW-CC-Sign=B334BC1F26726981415E905A8BCB9EDB2D1C9BEF6945CF826FC5A700578B093C) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ab/v3/3UpnAuo6TFeKpeLZ2RZG9A/zh-cn_image_0000002082204590.png?HW-CC-KV=V1&HW-CC-Date=20260903T083919Z&HW-CC-Expire=86400&HW-CC-Sign=E9D5C5442BDC2CE7A50BB924B426145CE3E8DB681C699D0ABBD5F035C6A7C49F) |
+
+**起始API Level**
+
+11
+
+**变更的接口/组件**
+
+MenuItem组件。
+
+**适配指导**
+
+MenuItem UX默认布局效果变更，应用无需适配。
+
+## Tabs组件barOverlap接口默认效果变更
+
+**变更原因**
+
+优化Tabs组件barOverlap属性设置为true时，TabBar的模糊效果和渲染性能。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：设置barOverlap属性为true时，TabBar默认背景色修改为'#F2F1F3F5'并添加模糊效果。
+
+变更后：设置barOverlap属性为true时，TabBar默认模糊材质的BlurStyle值修改为'BlurStyle.COMPONENT\_THICK'。
+
+| 变更前 | 变更后 |
+| --- | --- |
+| ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/98/v3/yuATTkGOSNiUymNP0HyKNQ/zh-cn_image_0000002117643789.jpg?HW-CC-KV=V1&HW-CC-Date=20260903T083919Z&HW-CC-Expire=86400&HW-CC-Sign=DAB8587FB35B6B18377C3D0B47AA3B9A9BEA8409C7D07AA8BE2C3603EDA064B1) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8d/v3/J_5aKd_2TLiSTgUcdLsraw/zh-cn_image_0000002117728857.jpg?HW-CC-KV=V1&HW-CC-Date=20260903T083919Z&HW-CC-Expire=86400&HW-CC-Sign=6A4EB6846242E2DDCDC2BEB70CF9939F9415A6FC6DFB050A2E7ABB85B8279ED0) |
+
+**起始API Level**
+
+10
+
+**变更的接口/组件**
+
+barOverlap接口
+
+**适配指导**
+
+当barOverlap设置为true时，开发者若期望无模糊效果，设置barBackgroundBlurStyle为BlurStyle.NONE。示例如下：
+
+```
+@Entry
+@Component
+struct barHeightTest {
+  @State arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]
+  build() {
+    Column() {
+      Tabs({ barPosition: BarPosition.End }) {
+        TabContent() {
+          Column() {
+            List({ space: 10 }) {
+              ForEach(this.arr, (item: number) => {
+                ListItem() {
+                  Text("item" + item).width('80%').height(200).fontSize(16).textAlign(TextAlign.Center).backgroundColor('#fff8b81e')
+                }
+              }, (item: string) => item)
+            }.width('100%').height('100%')
+            .lanes(2).alignListItem(ListItemAlign.Center)
+          }.width('100%').height('100%')
+          .backgroundColor(Color.Pink)
+        }
+        .tabBar(new BottomTabBarStyle($r('sys.media.ohos_icon_mask_svg'), "测试0"))
+
+        TabContent() {
+          Column() {
+            List({ space: 10 }) {
+              ForEach(this.arr, (item: number) => {
+                ListItem() {
+                  Text("item" + item).width('80%').height(200).fontSize(16).textAlign(TextAlign.Center).backgroundColor('#fff8b81e')
+                }
+              }, (item: string) => item)
+            }.width('100%').height('100%')
+            .lanes(2).alignListItem(ListItemAlign.Center)
+          }.width('100%').height('100%')
+          .backgroundColor(Color.Blue)
+        }
+        .tabBar(new BottomTabBarStyle($r('sys.media.ohos_icon_mask_svg'), "测试1"))
+      }
+      .barOverlap(true)
+      .barBackgroundBlurStyle(BlurStyle.NONE) // 关闭TabBar模糊效果
+    }
+  }
+}
+```

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

@@ -0,0 +1,444 @@
+---
+title: OS平台API行为的变更
+source: https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-b112
+category: harmonyos-releases
+downloaded_at: 2026-09-03
+---
+
+# OS平台API行为的变更
+
+## ArkUI
+
+### 鼠标按键处理行为变更
+
+**变更原因**
+
+在开发者为组件配置鼠标事件后，若在组件区域内按下鼠标非左键并拖拽至组件区域外释放，此时将无法接收到按键释放事件，这可能导致事件配对失败，进而引发应用程序行为异常。此变更确保开发者能够接收到匹配的按键按下与释放事件。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+**说明**
+
+此变更已做版本隔离，变更仅在应用的targetSdkVersion设置为大于等于5.0.1(13)时生效。
+
+变更前：在开发者为组件配置了鼠标事件后，如果在组件区域内按下鼠标非左键，并将鼠标移动至组件区域外再释放按键，此时将无法接收到按键释放事件。
+
+变更后：在开发者为组件配置了鼠标事件后，如果在组件区域内按下鼠标非左键，并将鼠标移动至组件区域外再释放按键，此时可以接收到按键释放事件。
+
+**起始API Level**
+
+8
+
+**变更的接口/组件**
+
+ArkTS的onMouse接口，Native的OH\_NativeXComponent\_GetMouseEvent接口和registerNodeEvent接口的NODE\_ON\_MOUSE。
+
+**适配指导**
+
+默认行为变更，应注意变更后的行为是否对整体应用逻辑产生影响。
+
+### 动画接口在播放次数为无限循环时的行为变更
+
+**变更原因**
+
+非动画的闭包函数修改状态变量，存在被带入无限循环动画的风险，产生预期外的无限循环动画且无法停止。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：在调用无限循环动画接口（例如：无限循环的animateTo）时，首次布局过程中触发的同步回调里所做的修改，会被纳入无限循环动画中，从而产生多余的动画。
+
+变更后：在调用无限循环动画接口（例如：无限循环的animateTo）时，首次布局过程中触发的同步回调里所做的修改，系统至多做2次额外刷新保护，避免动画前的同步回调被纳入无限循环动画中，对于2次额外刷新仍不能保护住的同步回调，和原行为一致也会产生无限循环动画。
+
+**起始API Level**
+
+-   animateTo：7
+-   animateToImmediately：12
+-   UIContext.keyframeAnimateTo：11
+-   UIContext.animateTo：11
+-   UIContext.animateToImmediately：12
+
+**变更的接口/组件**
+
+1、animateTo；
+
+2、animateToImmediately；
+
+3、UIContext.keyframeAnimateTo；
+
+4、UIContext.animateTo；
+
+5、UIContext.animateToImmediately；
+
+**适配指导**
+
+为了创建无限循环的动画，必须明确地将修改操作置于动画接口（例如：无限循环的animateTo）的闭包函数内。
+
+animateTo适配前：
+
+```
+@Entry
+@Component
+struct Example {
+  @State rotateAngle: number = 0
+  @State wid: number = 100
+  @State color: Color = Color.Red
+
+  build() {
+    Column() {
+      Column()
+        .size({width: 100, height: 100})
+        .backgroundColor(this.color)
+      Button('animate')
+        .margin(50)
+        .rotate({ x: 0, y: 0, z: 1, angle: this.rotateAngle })
+        .onSizeChange((oldValue: SizeOptions, newValue: SizeOptions)=>{
+          // animateTo前修改wid时的布局同步的触发了onSizeChange事件，也会被带入无限循环动画中
+          // 产生背景色的无限循环动画
+          if (Number(newValue.width) >= 150) {
+            this.color = Color.Blue;
+          } else {
+            this.color = Color.Red;
+          }
+        })
+        .onClick(()=>{
+          this.wid = 200;
+          animateTo({
+            iterations: -1, // 设置-1表示动画无限循环
+            playMode: PlayMode.Alternate,
+          }, () => {
+            this.rotateAngle = 90
+          })
+        })
+    }.width('100%').margin({ top: 5 })
+  }
+}
+```
+
+animateTo适配后：
+
+```
+@Entry
+@Component
+struct Example {
+  @State rotateAngle: number = 0
+  @State wid: number = 100
+  @State color: Color = Color.Red
+
+  build() {
+    Column() {
+      Column()
+        .size({width: 100, height: 100})
+        .backgroundColor(this.color)
+      Button('animate')
+        .margin(50)
+        .rotate({ x: 0, y: 0, z: 1, angle: this.rotateAngle })
+        .onSizeChange((oldValue: SizeOptions, newValue: SizeOptions)=>{
+          // onSizeChange为同步回调，最好不在同步回调中直接修改状态变量。  
+        })
+        .onClick(()=>{
+          this.wid = 200;
+          // 如果不需要产生color的动画则在动画外直接修改color，this.color = Color.Blue，而不是在同步回调中
+          animateTo({
+            iterations: -1, // 设置-1表示动画无限循环
+            playMode: PlayMode.Alternate,
+          }, () => {
+            this.rotateAngle = 90
+            // 如果需要产生color的动画则在此处加上this.color = Color.Blue，将color的改变放在动画闭包中
+          })
+        })
+    }.width('100%').margin({ top: 5 })
+  }
+}
+```
+
+### 系统对单应用最大创建UIAbility数量限制变更
+
+**变更原因**
+
+系统防护机制增强，系统会针对设备上单应用最大创建UIAbility数量进行限制，如果数量超过限制，系统可能会将最早未使用的任务删除。
+
+**变更影响**
+
+此变更需要适配。
+
+变更前：单应用最大创建UIAbility数量限制为128。
+
+变更后：手机及平板单应用最大创建UIAbility数量限制默认为10，具体限制数由产品配置。
+
+当单个应用创建UIAbility数量超过限制时，再次启动新的任务系统可能会将最早未使用的任务删除。
+
+**起始API Level**
+
+不涉及
+
+**变更的接口/组件**
+
+任务管理规格
+
+**适配指导**
+
+系统针对单应用有最大UIAbility数量限制机制，应用开发需保证正常使用情况下任务数量不超过系统限制；如果超过，再次启动新的UIAbility任务时系统会将最早未使用的任务删除，该情况下需保证删除最早的任务不影响应用正常功能。
+
+### Video组件不再默认解析并自动播放拖拽信息中的视频资源
+
+**变更原因**
+
+Video组件默认允许拖入任意视频并自动播放的行为不符合终端用户预期，故需调整该默认规格。
+
+**说明**
+
+该变更在2025年1月8日更新的ROM版本引入，ROM版本号为5.0.0.123。
+
+**变更影响**
+
+变更前：Video组件默认解析并自动播放拖拽信息中的视频资源。
+
+变更后：Video组件不会默认解析并自动播放拖拽信息中的视频资源。
+
+**起始API Level**
+
+10
+
+**变更的接口/组件**
+
+Video组件。
+
+**适配指导**
+
+应用若需要使Video组件支持解析拖入的视频信息并自动播放，可通过如下代码实现：
+
+```typescript
+import { unifiedDataChannel, uniformTypeDescriptor } from '@kit.ArkData';
+
+@Entry
+@Component
+struct Index {
+  @State videoSrc: Resource | string = $rawfile('video1.mp4');
+  private controller: VideoController = new VideoController();
+
+  build() {
+    Column() {
+      Video({
+        src: this.videoSrc,
+        controller: this.controller
+      })
+        .width('100%')
+        .height(600)
+        .onPrepared(() => {
+          // 在onPrepared回调中执行controller的start方法，确保视频源更换后直接开始播放。
+          this.controller.start();
+        })
+        .onDrop((e: DragEvent) => {
+          // 外部视频拖入应用Video组件范围，松手后触发通过onDrop注册的回调。
+          // 在DragEvent中会包含拖入的视频源信息，取出后赋值给状态变量videoSrc即可改变Video的视频源。
+          let record = e.getData().getRecords()[0];
+          if (record.getType() == uniformTypeDescriptor.UniformDataType.VIDEO) {
+            let videoInfo = record as unifiedDataChannel.Video;
+            this.videoSrc = videoInfo.videoUri;
+          }
+        })
+    }
+  }
+}
+```
+
+## ArkWeb
+
+### onErrorReceive接口在首次加载woff等在线字体资源不再触发的行为变更
+
+**变更原因**
+
+woff等在线字体资源首次加载时不再指定仅从缓存中读取。
+
+**变更影响**
+
+该变更为兼容性变更。
+
+变更前：首次加载woff等在线字体资源时，会触发错误码为-400（ERR\_CACHE\_MISS）的onErrorReceive回调。
+
+变更后：首次加载woff等在线字体资源时，不再触发错误码为-400（ERR\_CACHE\_MISS）的onErrorReceive回调。
+
+**起始API Level**
+
+8
+
+**变更的接口/组件**
+
+web.d.ts的onErrorReceive接口
+
+**适配指导**
+
+默认行为变更，应注意变更后的行为是否对整体应用逻辑产生影响。
+
+## Form Kit
+
+### PostCardAction的router事件允许拉起Ability类型范围变更
+
+**变更原因**
+
+PostCardAction的router事件当前未对被拉起的Ability类型进行校验，但实际此事件应只允许拉起UIAbility，针对使用router事件拉起非UIAbility的场景，需要做安全加固。
+
+**说明**
+
+该变更在2025年1月8日更新的ROM版本引入，ROM版本号为5.0.0.123。
+
+**变更影响**
+
+该变更为不兼容变更。
+
+变更前：通过PostCardAction接口的router事件，可以拉起所有类型的Ability。
+
+变更后：通过PostCardAction接口的router事件，仅允许拉起UIAbility。
+
+**起始API Level**
+
+9
+
+**变更的接口/组件**
+
+PostCardAction
+
+**适配指导**
+
+应用侧使用PostCardAction接口的router事件拉起Ability时，需确保拉起的目标Ability属于UIAbility。若需要拉起其他类型的Ability，建议通过其他类型的事件，例如message事件， 跳转到FormExtensionAbility内处理。
+
+## 公共能力
+
+### app.json中bundleName字段正则匹配规则修改
+
+**变更原因**
+
+app.json中对bundleName的正则匹配规则较简单，不符合应用包名规范，进行整改。
+
+**说明**
+
+该变更在2024年12月8日发布的patch版本引入，对应开发工具DevEco Studio版本为5.0.5.306。
+
+**变更影响**
+
+变更前，规则如下：
+
+-   由字母、数字、下划线（\_）和符号“.”组成，且必须以字母开头。
+
+变更后，规则如下：
+
+-   由字母、数字、下划线和符号“.”组成。
+-   必须为以点号（.）分隔的字符串，且至少包含三段。
+-   首段以英文字母开头，非首段以数字或英文字母开头，每一段以数字或者英文字母结尾。
+-   不允许多个点号（.）连续出现。
+
+**起始API Level**
+
+8
+
+**变更的接口/组件**
+
+Openharmony SDK目录下toolchains/modulecheck/app.json scheme文件。
+
+**适配指导**
+
+升级SDK版本后，如果DevEco Studio编辑器中提示如下报错，请按照新规则修改应用的bundleName。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a2/v3/8atJBLGiRcGZNT30AlUCzQ/zh-cn_image_0000002143569014.png?HW-CC-KV=V1&HW-CC-Date=20260903T083919Z&HW-CC-Expire=86400&HW-CC-Sign=2265ECEF12C73A7CAE21D02015C660ADF77466A235DAA057010FE25C762F8DC7)
+
+## 工具
+
+### 应用发生OOM时Heapdump产物文件格式变更
+
+**变更原因**
+
+为了提升应用发生OOM时Heapdump生成dump文件的概率和效率，支撑开发者定位内存泄漏问题：
+
+1.  移除Heapdump在线解析逻辑，产物格式由.heapsnapshot变为.rawheap。
+    
+2.  rawheap文件解析生成heapsnapshot文件的功能由SDK中集成的rawheap\_translator工具提供。
+    
+
+**说明**
+
+该变更在2024年12月8日发布的patch版本引入，对应开发工具DevEco Studio版本为5.0.5.306。
+
+**变更影响**
+
+该变更为不兼容变更。
+
+变更前：应用OOM时Heapdump生成dump文件的格式为.heapsnapshot。
+
+变更后：应用OOM时Heapdump生成dump文件的格式为.rawheap，需要通过调用rawheap\_translator工具将rawheap文件解析转换为heapsnapshot文件。
+
+**起始API Level**
+
+11
+
+**变更的接口/组件**
+
+OpenHarmony的SDK在toolchains目录下新增rawheap\_translator工具。
+
+**适配指导**
+
+将当前应用OOM时Heapdump生成的rawheap文件转换成之前的heapsnapshot文件，需要使用设备或SDK中的rawheap\_translator工具
+
+工具获取：
+
+当前rawheap\_translator工具适配了OHOS、Windows、Linux、MacOS平台：
+
+OHOS平台工具所在路径：/bin/rawheap\_translator, 可直接在设备中调用。
+
+Windows、Linux、MacOS平台工具在SDK中获取，所在路径：/toolchains/rawheap\_translator。
+
+环境变量设置：
+
+Windows环境变量设置：
+
+在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量 > Path > 编辑中，将rawheap\_translator.exe的所在路径添加到Path中，配置完成后重启电脑。
+
+MacOS环境变量设置：
+
+打开终端工具，输入以下命令并执行：
+
+```
+echo $SHELL
+```
+
+上述命令执行结果可能为/bin/bash或者/bin/zsh，下面以/bin/bash为例，/bin/zsh同理。执行以下命令，打开.bash\_profile文件：
+
+```
+vi ~/.bash_profile
+```
+
+单击键盘上字母“i”，进入编辑模式，输入以下命令：
+
+```typescript
+export PATH=$PATH:<rawheap_translator路径>
+```
+
+编辑完成后，单击键盘Esc键退出编辑模式，然后输入“:wq”，单击键盘Enter键保存修改。
+
+执行以下命令，使配置的环境变量生效：
+
+```
+source ~/.bash_profile
+```
+
+配置完成后重新启动电脑。
+
+使用方法：
+
+工具调用命令：
+
+```
+rawheap_translator <rawheap_file>
+
+rawheap_translator <rawheap_file> <heapsnapshot_file>
+```
+
+参数列表：
+
+| 选项 | 描述 | 举例 |
+| --- | --- | --- |
+| <rawheap_file> | 应用OOM时Heapdump生成的rawheap文件路径，例如：/data/log/reliability/resource_leak/memory_leak | 解析目录D:\temp\rawheap下的example.rawheap文件：rawheap_translator D:\temp\example.rawheap |
+| <heapsnapshot_file> | 指定解析生成文件的路径和名称，文件后缀必须为heapsnapshot；若不指定则默认为当前路径，文件名自动生成 | 解析目录D:\temp\rawheap下的example.rawheap文件，并在D:\temp\result下生成结果文件result.heapsnapshot：rawheap_translator D:\temp\example.rawheap D:\temp\result\result.heapsnapshot |