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

package/node_modules/@hmos-library-adapter/executer/shared/skills/harmonyos-api-upgrade-adapter/references/changelogs/6.0.0(20)/beta2-ux-style-and-effect-changes.md

@@ -0,0 +1,78 @@
+---
+title: UX样式或效果的变更
+source: https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-ux-6002
+category: harmonyos-releases
+downloaded_at: 2026-09-03
+---
+
+# UX样式或效果的变更
+
+## selectDynamicIcon接口新增错误码
+
+**变更原因**
+
+开发者可以通过selectDynamicIcon接口切换应用图标为自定义图标，但是用户设置了主题且主题对该应用有在线图标时，会存在自定义图标与主题风格不一致的体验。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前selectDynamicIcon有如下错误码：
+
+| 错误码ID | 错误信息 |
+| --- | --- |
+| 401 | Parameter error. |
+| 1006800009 | System internal error. |
+| 1006800011 | Select dynamic icon failed. |
+
+变更后：
+
+| 错误码ID | 错误信息 |
+| --- | --- |
+| 401 | Parameter error. |
+| 1006800009 | System internal error. |
+| 1006800011 | Select dynamic icon failed. |
+| 1006800013 | Failed to switch to the custom icon because a custom theme icon is currently in use. |
+
+**起始API Level**
+
+6.0.0(20)
+
+**变更的接口/组件**
+
+AppGalleryKit提供的selectDynamicIcon接口
+
+**适配指导**
+
+如果应用调用appInfoManager.selectDynamicIcon接口是由用户触发，可以在catch中判断错误码是否是1006800013。如果是1006800013则根据自身业务场景，选择合适的UI样式提醒用户：当前应用存在主题在线图标，所以设置自定义图标失败。需要先在“设置 -> 桌面与个性化”，或“主题 -> 官方主题”，切换至官方主题后，再尝试重新设置图标。
+
+```typescript
+import { appInfoManager } from "@kit.AppGalleryKit";
+import { BusinessError } from "@kit.BasicServicesKit";
+import { hilog } from "@kit.PerformanceAnalysisKit";
+import promptAction from '@ohos.promptAction';
+
+export class DynamicIcon {
+    private readonly SHORT_TOAST_DURATION: number = 2000;
+
+    private selectDynamicIcon(iconId: string) {
+        appInfoManager.selectDynamicIcon(iconId).then(() => {
+            this.showToast('图标设置成功');
+        }).catch((error: BusinessError) => {
+            if (error?.code === 1006800013) {
+                this.showToast('图标暂时未生效，当前应用存在主题在线图标，请先切换至官方主题后再尝试设置图标');
+            } else {
+                hilog.error(0, 'DynamicIcon',
+                    `selectDynamicIcon failed, code: ${error.code}, exception message: ${error.message}`);
+            }
+        });
+    }
+
+    private showToast(toastMessage: string): void {
+        promptAction.openToast({
+            message: toastMessage,
+            duration: this.SHORT_TOAST_DURATION
+        });
+    }
+}
+```

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

@@ -0,0 +1,167 @@
+---
+title: OS平台API行为的变更
+source: https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-6003
+category: harmonyos-releases
+downloaded_at: 2026-09-03
+---
+
+# OS平台API行为的变更
+
+## Car Kit
+
+### Car Kit接口新增801、1003810001、1003810002错误码
+
+**变更原因**
+
+当传入无效入参或在不支持的设备调用接口时，通过相关错误码告知开发者接口调用失败的原因，方便开发者定位问题。
+
+**变更影响**
+
+公共接口新增错误码，此变更涉及应用适配。
+
+变更前：应用调用本次涉及修改的接口时，未使用try-catch捕获接口抛出的异常，应用运行正常。
+
+变更后：应用调用本次涉及修改的接口时，未使用try-catch捕获接口抛出的异常，所调用的接口在传入非法参数会抛出1003810001或者1003810002错误码，在不支持的设备上调用会抛出801错误码，会导致应用运行时发生崩溃。
+
+**起始API Level**
+
+-   4.1.0(11)：getNavigationController、updateNavigationStatus、updateNavigationMetadata、registerSystemNavigationListener、unregisterSystemNavigationListener
+-   5.0.0(12)：getSmartMobilityAwareness、on(type: 'smartMobilityEvent')、off(type: 'smartMobilityEvent')、getSmartMobilityEvent、on(type: 'smartMobilityStatus')、off(type: 'smartMobilityStatus')、getSmartMobilityStatus
+
+**变更的接口/组件**
+
+Car Kit 提供的公共接口在变更后新增 801、1003810001、1003810002 错误码：
+
+-   801：涉及getNavigationController、updateNavigationStatus、updateNavigationMetadata、registerSystemNavigationListener、unregisterSystemNavigationListener、getSmartMobilityAwareness、on(type: 'smartMobilityEvent')、off(type: 'smartMobilityEvent')、getSmartMobilityEvent、on(type: 'smartMobilityStatus')、off(type: 'smartMobilityStatus')、getSmartMobilityStatus
+-   1003810001：涉及updateNavigationStatus、updateNavigationMetadata、registerSystemNavigationListener
+-   1003810002：涉及updateNavigationStatus、updateNavigationMetadata
+
+| 错误码ID | 错误信息 |
+| --- | --- |
+| 801 | Capability not supported. |
+| 1003810001 | Invalid parameter value. |
+| 1003810002 | The total size of all parameters exceeds the limit. |
+
+**适配指导**
+
+目前已接入的应用调用接口时可能未捕获异常，或已捕获异常但未对新增的错误码进行处理。应用调用上述接口时需捕获异常，并且按需处理错误码。
+
+以调用导航类接口updateNavigationStatus为例：
+
+```typescript
+import { navigationInfoMgr } from '@kit.CarKit';
+import { hilog } from '@kit.PerformanceAnalysisKit';
+
+// 定义导航状态属性
+let navigationStatus: navigationInfoMgr.NavigationStatus = {/* 按需设置导航数据*/};
+
+**try** **{**
+  // 获取 NavigationController
+  let naviInfoController: navigationInfoMgr.NavigationController = navigationInfoMgr.getNavigationController();
+  naviInfoController.updateNavigationStatus(navigationStatus);
+**} catch (e) {**
+  **hilog.error(0x0000, 'testTag', `update navigation status error, error code: ${e.code}`);**
+  **// 捕获接口调用异常时的错误码并做相应处理**
+  **if (e.code === 801) {**
+   **// 按需处理801错误码**
+ **} else if (e.code === 1003810001) {**
+   **// 按需处理1003810001错误码**
+ **} else if (e.code === 1003810002) {**
+   **// 按需处理1003810002错误码**
+ **}**
+**}**
+```
+
+## Data Augmentation Kit
+
+### rag.streamRun接口思考过程输出变更
+
+**变更原因**
+
+思考中输出内容优化。
+
+**变更影响**
+
+此变更在部分场景涉及应用适配，详见**适配指导**的情况说明。
+
+1.  思考内容扩充：
+    
+    变更前：思考内容输出固定语句“正在思考中，请稍后...”。
+    
+    变更后：输出正式思考过程数据，根据问题动态变化。
+    
+2.  输出思考内容时间提前：
+    
+    变更前：提问后，使用模型预处理问题的模型首token返回后，输出思考内容。
+    
+    变更后：提问后立即开始输出思考内容。
+    
+
+**起始API Level**
+
+6.0.0(20)
+
+**变更的接口/组件**
+
+rag.streamRun接口回调函数输出。
+
+**适配指导**
+
+前提：开发者调用该接口时，rag.streamRun第二个参数config配置中，配置了THOUGHT。
+
+情况1、如果开发者未在config中配置THOUGHT：不需要适配。
+
+情况2、如果开发者在config中配置了THOUGHT，未解析思考内容，且未使用固定时间进行界面等待效果：不需要适配。
+
+情况3、如果开发者在config中配置了THOUGHT，解析了思考中的具体内容，或者使用固定时间进行界面等待效果：推荐如下修改进行适配：
+
+```
+const answerTypes: Array<rag.StreamType> = [rag.StreamType.THOUGHT, rag.StreamType.REFERENCE, rag.StreamType.ANSWER];
+await session.streamRun('question', { answerTypes }, (err: BusinessError, stream: rag.Stream) => {
+  if (err) {
+    hilog.error(0, TAG, 'errCode: ' + err.code + ', errMessage: ' + err.message);
+    return;
+  }
+  hilog.debug(0, TAG, `stream: ${JSON.stringify(stream)}`);
+  // 根据stream.type判断当前输出的数据类型，界面变化根据当前拿到的stream.type来刷新，不推荐解析固定输出内容以及等待固定时间处理界面变化。
+  if (stream.type == rag.StreamType.THOUGHT) {
+    // 输出的思考内容，自行选择处理方式
+  } else if (stream.type == rag.StreamType.REFERENCE) {
+    // 检索到的原始数据，自行选择处理方式
+  } else if (stream.type == rag.StreamType.ANSWER) {
+    // 输出的最终答案，自行选择处理方式
+  } else {
+    // 其他异常场景，自行选择处理方式
+  }
+});
+```
+
+## Device Security Kit
+
+### SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE\_INTERCEPTED、FILE\_INTERCEPTED枚举值变更
+
+**变更原因**
+
+为了帮助开发者更直观的识别安全审计事件ID，并能使开发者依据事件ID的规划原则准确识别该事件提供的数据类别，需要将原本规划偏移的文件拦截事件对应ArkTS、C的枚举值进行调整，按事件类别、行为等重新规划。
+
+**变更影响**
+
+此变更不涉及应用适配。
+
+变更前：如果应用需要订阅文件拦截事件，ArkTS语言环境使用FILE\_INTERCEPTED枚举进行订阅，C语言环境使用SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE\_INTERCEPTED枚举进行订阅。
+
+变更后：如果应用需要订阅文件拦截事件，ArkTS语言环境使用FILE\_INTERCEPTED枚举进行订阅，C语言环境使用SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE\_INTERCEPTED枚举进行订阅。
+
+**起始 API Level**
+
+6.0.0(20)
+
+**变更的接口/组件**
+
+变更文件：hmscore\_sdk\_c/DeviceSecurityKit/security\_audit.h
+
+变更接口：“SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE\_INTERCEPTED = 0x2700003C”变更为“SECURITY\_AUDIT\_NOTIFY\_EVENT\_FILE\_INTERCEPTED = 0x1C001100”。
+
+变更文件：hmscore\_sdk\_js/api/@hms.security.securityAudit.d.ts
+
+变更接口：“FILE\_INTERCEPTED = 0x2700003C”变更为“FILE\_INTERCEPTED = 0x1C001100”。

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

@@ -0,0 +1,52 @@
+---
+title: OS平台API行为的变更
+source: https://developer.huawei.com/consumer/cn/doc/harmonyos-releases/changelogs-for-all-apps-6004
+category: harmonyos-releases
+downloaded_at: 2026-09-03
+---
+
+# OS平台API行为的变更
+
+## ArkTS
+
+### 禁止在编译产物为JS的HAR包中使用注解
+
+**变更原因**
+
+应用开发中，在[release模式下构建](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-har#section19788284410)源码HAR，并同时[开启混淆](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/source-obfuscation)时，由于编译产物为JS文件，而在JS中没有注解的实现机制，因此会在编译过程中被移除，导致无法通过注解实现AOP插桩。
+
+为避免因此引起的功能异常，禁止在JS HAR(编译产物中存在JS的HAR包)中使用注解。
+
+**变更影响**
+
+此变更涉及应用适配。
+
+变更前：构建JS HAR时，若代码中存在注解，编译不会报错。
+
+如下代码在JS形态的HAR包中编译时不会报错。
+
+```typescript
+// test.ets
+@interface ClassAuthor {
+  authorName: string
+}
+
+@ClassAuthor({authorName: "Bob"})
+class MyClass {
+  /* body */
+}
+```
+
+变更后：构建JS HAR时，若代码中存在注解，编译会报错。
+
+**起始API Level**
+
+不涉及
+
+**变更的接口/组件**
+
+不涉及
+
+**适配指导**
+
+删除JS HAR中的注解声明和调用，或者重新编译成其他形态的HAR包，例如[字节码HAR](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hvigor-build-har#section16598338112415)。