|
+
+### 使用说明
+1. 点击获取通用文件路径获取el2文件路径。
+2. 点击获取EL1文件路径获取el1文件路径。
+3. 点击加密会执行加密算法，可通过日志查看加密结果。
+4. 点击解密对加密的数据进行解密，可通过日志查看解密结果。
+
### 工程目录
```
├──entry/src/main/ets/
@@ -27,8 +38,19 @@
1. 本示例仅支持标准系统上运行，支持设备：华为手机。
-2. HarmonyOS系统：HarmonyOS NEXT Release及以上。
+2. HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
+
+3. DevEco Studio版本：DevEco Studio 5.0.5 Release及以上。
-3. DevEco Studio版本：DevEco Studio NEXT Release及以上。
+4. HarmonyOS SDK版本：HarmonyOS 5.0.5 Release SDK及以上。
-4. HarmonyOS SDK版本：HarmonyOS NEXT Release SDK及以上。
\ No newline at end of file
+### 下载
+
+如需单独下载本工程，执行如下命令：
+```
+git clone --filter=blob:none --no-checkout https://gitee.com/harmonyos_samples/BestPracticeSnippets.git
+cd BestPracticeSnippets
+git sparse-checkout init --cone
+git sparse-checkout set AppDataSecurity
+git checkout
+```
\ No newline at end of file
diff --git a/AppDataSecurity/README_EN.md b/AppDataSecurity/README_EN.md
index 65d2d7ccdd092b4f11acbc14d12c510339068001..d4e1e5d587088ed9e2093093b9c9f5eb6553e3d6 100644
--- a/AppDataSecurity/README_EN.md
+++ b/AppDataSecurity/README_EN.md
@@ -3,6 +3,11 @@
### Overview
This sample implements file paths and HUKS encryption/decryption algorithm.
+### Effect
+| Home Page |
+|-------------------------------------------------------|
+| 
|
+
### Project Directory
```
├──entry/src/main/ets/
@@ -32,3 +37,14 @@ N/A
3. The DevEco Studio version must be DevEco Studio NEXT Release or later.
4. The HarmonyOS SDK version must be HarmonyOS NEXT Release SDK or later.
+
+### Download
+
+To download this project separately, execute the following command:
+```
+git clone --filter=blob:none --no-checkout https://gitee.com/harmonyos_samples/BestPracticeSnippets.git
+cd BestPracticeSnippets
+git sparse-checkout init --cone
+git sparse-checkout set AppDataSecurity
+git checkout
+```
diff --git a/AppDataSecurity/build-profile.json5 b/AppDataSecurity/build-profile.json5
index 1e69556b3411622cb2e87a87389653bb34f1b148..9e87e7e6f19020fe21192844709f192cec80fd44 100644
--- a/AppDataSecurity/build-profile.json5
+++ b/AppDataSecurity/build-profile.json5
@@ -5,7 +5,8 @@
{
"name": "default",
"signingConfig": "default",
- "compatibleSdkVersion": "5.0.0(12)",
+ "targetSdkVersion": "5.0.5(17)",
+ "compatibleSdkVersion": "5.0.5(17)",
"runtimeOS": "HarmonyOS",
"buildOption": {
"strictMode": {
diff --git a/AppDataSecurity/entry/src/main/ets/pages/Index.ets b/AppDataSecurity/entry/src/main/ets/pages/Index.ets
index 3574ed8a8f6ac64de5ecd52c7ccca64bc73814fa..2baf55383cc4e367ea0f6de1dd430508bdbce339 100644
--- a/AppDataSecurity/entry/src/main/ets/pages/Index.ets
+++ b/AppDataSecurity/entry/src/main/ets/pages/Index.ets
@@ -65,7 +65,7 @@ struct Index {
}
// [Start get_el2_path]
- getEl2Path() {
+ getEl2Path(): void {
let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
context.area = contextConstant.AreaMode.EL2;
let filePath = context.filesDir + '/health_data.txt';
@@ -74,7 +74,7 @@ struct Index {
// [End get_el2_path]
// [Start get_el1_path]
- getEl1Path() {
+ getEl1Path(): void {
let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
context.area = contextConstant.AreaMode.EL1;
let filePath = context.filesDir + '/health_data.txt';
@@ -83,51 +83,60 @@ struct Index {
// [End get_el1_path]
}
-let aesKeyAlias = 'test_aesKeyAlias';
+let aesKeyAlias: string = 'test_aesKeyAlias';
let handle: number;
-let plainText = '123456';
-let IV = '001122334455';
+let plainText: string = '123456';
+let IV: string = '001122334455';
let cipherData: Uint8Array;
// [Start write_file]
-function writeFile(filePath: string, data: string) {
- let file = fileIo.openSync(filePath, fileIo.OpenMode.READ_WRITE | fileIo.OpenMode.CREATE);
- let writeLen = fileIo.writeSync(file.fd, data);
- hilog.info(0x0000, 'AppDataSecurity', 'The length of str is: ' + writeLen);
- fileIo.closeSync(file);
+function writeFile(filePath: string, data: string): void {
+ try {
+ let file = fileIo.openSync(filePath, fileIo.OpenMode.READ_WRITE | fileIo.OpenMode.CREATE);
+ let writeLen = fileIo.writeSync(file.fd, data);
+ hilog.info(0x0000, 'AppDataSecurity', 'The length of str is: ' + writeLen);
+ fileIo.closeSync(file);
+ } catch (error) {
+ hilog.error(0x0000, 'AppDataSecurity', `writeFile error ${JSON.stringify(error)}`);
+ }
}
function readFile(filePath: string): string {
- let file = fileIo.openSync(filePath, fileIo.OpenMode.READ_WRITE | fileIo.OpenMode.CREATE);
- let arrayBuffer = new ArrayBuffer(1024);
+ try {
+ let file = fileIo.openSync(filePath, fileIo.OpenMode.READ_WRITE | fileIo.OpenMode.CREATE);
+ let arrayBuffer = new ArrayBuffer(1024);
- class Option {
- public offset: number = 0;
- public length: number = 0;
- }
+ class Option {
+ public offset: number = 0;
+ public length: number = 0;
+ }
- let option = new Option();
- option.length = arrayBuffer.byteLength;
- let readLen = fileIo.readSync(file.fd, arrayBuffer, option);
- let buf = buffer.from(arrayBuffer, 0, readLen);
- hilog.info(0x0000, 'AppDataSecurity', `The length of of file: ${readLen}`);
- fileIo.closeSync(file);
- return buf.toString();
+ let option = new Option();
+ option.length = arrayBuffer.byteLength;
+ let readLen = fileIo.readSync(file.fd, arrayBuffer, option);
+ let buf = buffer.from(arrayBuffer, 0, readLen);
+ hilog.info(0x0000, 'AppDataSecurity', `The length of of file: ${readLen}`);
+ fileIo.closeSync(file);
+ return buf.toString();
+ } catch (error) {
+ hilog.error(0x0000, 'AppDataSecurity', `readFile error ${JSON.stringify(error)}`);
+ }
+ return '';
}
// [End write_file]
-function StringToUint8Array(str: string) {
+function StringToUint8Array(str: string): Uint8Array {
let textEncoder = util.TextEncoder.create('utf-8');
return textEncoder.encodeInto(str);
}
-function Uint8ArrayToString(fileData: Uint8Array) {
+function Uint8ArrayToString(fileData: Uint8Array): string {
let textDecoder = util.TextDecoder.create('utf-8');
return textDecoder.decodeToString(fileData);
}
// [Start get_aes_generate_properties]
-function GetAesGenerateProperties() {
+function GetAesGenerateProperties(): Array
-
## 工程目录
```
├──entry/src/main/ets // 代码区
@@ -16,20 +12,35 @@
│ ├──pages
│ │ └──Index.ets // 首页
│ └──segment
-│ ├──segment1.ets
-│ ├──segment2.ets
-│ └──segment3.ets
+│ ├──segment1.ets // List列表数据
+│ ├──segment2.ets // List不设置宽高
+│ └──segment3.ets // List设置固定高度
└──entry/src/main/resources // 应用资源目录
```
+## 使用说明
+示例代码包含两个场景：
+* Scroll嵌套List，List不设置宽高。
+* Scroll嵌套List，List设置固定宽高。
## 相关权限
无
## 约束与限制
-* 本示例仅支持标准系统上运行，支持设备：华为手机。
+1. 本示例仅支持标准系统上运行，支持设备：华为手机。
+
+2. HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
-* HarmonyOS系统：HarmonyOS NEXT Release及以上。
+3. DevEco Studio版本：DevEco Studio 5.0.5 Release及以上。
-* DevEco Studio版本：DevEco Studio NEXT Release及以上。
+4. HarmonyOS SDK版本：HarmonyOS 5.0.5 Release SDK及以上。
-* HarmonyOS SDK版本：HarmonyOS NEXT Release SDK及以上。
\ No newline at end of file
+## 下载
+
+如需单独下载本工程，执行如下命令：
+```
+git clone --filter=blob:none --no-checkout https://gitee.com/harmonyos_samples/BestPracticeSnippets.git
+cd BestPracticeSnippets
+git sparse-checkout init --cone
+git sparse-checkout set ArkUI/Proper_Use_Layout
+git checkout
+```
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/README_EN.md b/ArkUI/Proper_Use_Layout/README_EN.md
index 58b21c1bb15c9b10e45c2555e9c5fb0b30ecd026..99f230393d37c542f62bdee2f9a5924b5284b3c3 100644
--- a/ArkUI/Proper_Use_Layout/README_EN.md
+++ b/ArkUI/Proper_Use_Layout/README_EN.md
@@ -25,10 +25,21 @@ This example uses Scroll to nest a List and compares the situations where the Li
N/A
## Constraints
-* This sample is supported only on Huawei phones running the standard system.
+1. This sample is supported only on Huawei phones running the standard system.
-* The HarmonyOS version must be HarmonyOS NEXT Release or later.
+2. The HarmonyOS version must be HarmonyOS 5.0.5 Release or later.
-* The DevEco Studio version must be DevEco Studio NEXT Release or later.
+3. The DevEco Studio version must be DevEco Studio 5.0.5 Release or later.
-* The HarmonyOS SDK version must be HarmonyOS NEXT Release SDK or later.
+4. The HarmonyOS SDK version must be HarmonyOS 5.0.5 Release SDK or later.
+
+## Download
+
+To download this project separately, execute the following command:
+```
+git clone --filter=blob:none --no-checkout https://gitee.com/harmonyos_samples/BestPracticeSnippets.git
+cd BestPracticeSnippets
+git sparse-checkout init --cone
+git sparse-checkout set ArkUI/Proper_Use_Layout
+git checkout
+```
diff --git a/ArkUI/Proper_Use_Layout/entry/src/main/ets/entryability/EntryAbility.ets b/ArkUI/Proper_Use_Layout/entry/src/main/ets/entryability/EntryAbility.ets
index 508880af8c33aa838016d1cd4b2c68be2f447540..5282cb6dd13ef29510ba872b3e237c9fab7732fb 100644
--- a/ArkUI/Proper_Use_Layout/entry/src/main/ets/entryability/EntryAbility.ets
+++ b/ArkUI/Proper_Use_Layout/entry/src/main/ets/entryability/EntryAbility.ets
@@ -1,4 +1,20 @@
+/*
+* Copyright (C) 2025 Huawei Device Co., Ltd.
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
+import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';
@@ -6,7 +22,12 @@ 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);
+ try {
+ this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
+ } catch (error) {
+ let err = error as BusinessError;
+ hilog.warn(0x000, 'testTag', `setColorMode failed, code=${err.code}, message=${err.message}`);
+ }
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
}
diff --git a/ArkUI/Proper_Use_Layout/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets b/ArkUI/Proper_Use_Layout/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets
index 8e4de99282050bad799ac892eb85ac5449364a51..7eb1afb81759bc5d59117077cb08b938ea66d402 100644
--- a/ArkUI/Proper_Use_Layout/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets
+++ b/ArkUI/Proper_Use_Layout/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets
@@ -1,3 +1,18 @@
+/*
+* Copyright (C) 2025 Huawei Device Co., Ltd.
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BackupExtensionAbility, BundleVersion } from '@kit.CoreFileKit';
diff --git a/ArkUI/Proper_Use_Layout/entry/src/main/ets/pages/Index.ets b/ArkUI/Proper_Use_Layout/entry/src/main/ets/pages/Index.ets
index 8e2d24ad42693fc877d51bb7820f0a9da68fa135..c149968e780eb9bac1ecb78fb539dff080631356 100644
--- a/ArkUI/Proper_Use_Layout/entry/src/main/ets/pages/Index.ets
+++ b/ArkUI/Proper_Use_Layout/entry/src/main/ets/pages/Index.ets
@@ -1,23 +1,59 @@
+/*
+* Copyright (C) 2025 Huawei Device Co., Ltd.
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+import { BusinessError } from '@kit.BasicServicesKit';
+import { hilog } from '@kit.PerformanceAnalysisKit';
+
@Entry
@Component
struct Index {
- @State message: string = 'Hello World';
-
build() {
- RelativeContainer() {
- Text(this.message)
- .id('HelloWorld')
- .fontSize($r('app.float.page_text_font_size'))
- .fontWeight(FontWeight.Bold)
- .alignRules({
- center: { anchor: '__container__', align: VerticalAlign.Center },
- middle: { anchor: '__container__', align: HorizontalAlign.Center }
+ Column({ space: 15 }) {
+ Button('to segment2')
+ .width('100%')
+ .onClick(() => {
+ this.getUIContext()
+ .getRouter()
+ .pushUrl({
+ url: 'segment/segment2'
+ })
+ .then(() => {
+ hilog.info(0x000, 'testTag', `pushUrl succeed.`);
+ })
+ .catch((err: BusinessError) => {
+ hilog.warn(0x000, 'testTag', `pushUrl failed. code=${err.code}, message=${err.message}`);
+ })
})
+ Button('to segment3')
+ .width('100%')
.onClick(() => {
- this.message = 'Welcome';
+ this.getUIContext()
+ .getRouter()
+ .pushUrl({
+ url: 'segment/segment3'
+ })
+ .then(() => {
+ hilog.info(0x000, 'testTag', `pushUrl succeed.`);
+ })
+ .catch((err: BusinessError) => {
+ hilog.warn(0x000, 'testTag', `pushUrl failed. code=${err.code}, message=${err.message}`);
+ })
})
}
.height('100%')
.width('100%')
+ .justifyContent(FlexAlign.End)
+ .padding({ left: 12, right: 12, bottom: 15 })
}
}
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment1.ets b/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment1.ets
index e638042083e9b1c6fd0590e406ea45cb80740030..78e7470d1cd9603a56bae794a705f9aaf2b0da8e 100644
--- a/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment1.ets
+++ b/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment1.ets
@@ -1,3 +1,18 @@
+/*
+* Copyright (C) 2025 Huawei Device Co., Ltd.
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
// [Start Case1]
class BasicDataSource implements IDataSource {
private listeners: DataChangeListener[] = [];
@@ -29,31 +44,31 @@ class BasicDataSource implements IDataSource {
notifyDataReload(): void {
this.listeners.forEach(listener => {
listener.onDataReloaded();
- })
+ });
}
notifyDataAdd(index: number): void {
this.listeners.forEach(listener => {
listener.onDataAdd(index);
- })
+ });
}
notifyDataChange(index: number): void {
this.listeners.forEach(listener => {
listener.onDataChange(index);
- })
+ });
}
notifyDataDelete(index: number): void {
this.listeners.forEach(listener => {
listener.onDataDelete(index);
- })
+ });
}
notifyDataMove(from: number, to: number): void {
this.listeners.forEach(listener => {
listener.onDataMove(from, to);
- })
+ });
}
}
@@ -65,22 +80,18 @@ export class MyDataSource extends BasicDataSource {
return this.dataArray.length;
}
-
public getData(index: number): string {
return this.dataArray[index];
}
-
public addData(index: number, data: string): void {
this.dataArray.splice(index, 0, data);
this.notifyDataAdd(index);
}
-
public pushData(data: string): void {
this.dataArray.push(data);
this.notifyDataAdd(this.dataArray.length - 1);
}
}
-
// [End Case1]
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment2.ets b/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment2.ets
index 8a35f830bdb7994fb799fa75247bd13ecac808da..ceba20c641185308c1a3da842bbf0dbfcb72936e 100644
--- a/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment2.ets
+++ b/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment2.ets
@@ -1,3 +1,18 @@
+/*
+* Copyright (C) 2025 Huawei Device Co., Ltd.
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
// [Start Case2]
import { MyDataSource } from './segment1';
@@ -12,7 +27,9 @@ struct NotSetHeightTestPage {
LazyForEach(this.data, (item: string, index: number) => {
ListItem() {
Row() {
- Text('item value: ' + item + (index + 1)).fontSize(20).margin(10)
+ Text('item value: ' + item + (index + 1))
+ .fontSize(20)
+ .margin(10)
}
}
})
@@ -20,5 +37,4 @@ struct NotSetHeightTestPage {
}
}
}
-
// [End Case2]
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment3.ets b/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment3.ets
index 8e402c582648152c4fbc2ee9ba9fd998df0e788d..d6af7e0482e95f6af54386d19e9e2c4596b0bbed 100644
--- a/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment3.ets
+++ b/ArkUI/Proper_Use_Layout/entry/src/main/ets/segment/segment3.ets
@@ -1,7 +1,21 @@
+/*
+* Copyright (C) 2025 Huawei Device Co., Ltd.
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
// [Start Case3]
import { MyDataSource } from './segment1';
-
@Entry
@Component
struct SetHeightTestPage {
@@ -13,13 +27,16 @@ struct SetHeightTestPage {
LazyForEach(this.data, (item: string, index: number) => {
ListItem() {
Row() {
- Text('item value: ' + item + (index + 1)).fontSize(20).margin(10)
+ Text('item value: ' + item + (index + 1))
+ .fontSize(20)
+ .margin(10)
}
}
})
- }.width('100%').height(500)
+ }
+ .width('100%')
+ .height(500)
}
}
}
-
// [End Case3]
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/entry/src/main/module.json5 b/ArkUI/Proper_Use_Layout/entry/src/main/module.json5
index a1cea8b6a4560cee7bda7a2db52f310c035ab6c8..44c5e49d8129f5d5bcc87ee6768d4a007d4877ca 100644
--- a/ArkUI/Proper_Use_Layout/entry/src/main/module.json5
+++ b/ArkUI/Proper_Use_Layout/entry/src/main/module.json5
@@ -6,8 +6,6 @@
"mainElement": "EntryAbility",
"deviceTypes": [
"phone",
- "tablet",
- "2in1"
],
"deliveryWithInstall": true,
"installationFree": false,
diff --git a/ArkUI/Proper_Use_Layout/entry/src/main/resources/base/profile/main_pages.json b/ArkUI/Proper_Use_Layout/entry/src/main/resources/base/profile/main_pages.json
index 1898d94f58d6128ab712be2c68acc7c98e9ab9ce..7230a3f2b31a1de8b2b3a36a3e4448bb571b3434 100644
--- a/ArkUI/Proper_Use_Layout/entry/src/main/resources/base/profile/main_pages.json
+++ b/ArkUI/Proper_Use_Layout/entry/src/main/resources/base/profile/main_pages.json
@@ -1,5 +1,7 @@
{
"src": [
- "pages/Index"
+ "pages/Index",
+ "segment/segment2",
+ "segment/segment3"
]
}
diff --git a/ArkUI/Proper_Use_Layout/entry/src/mock/mock-config.json5 b/ArkUI/Proper_Use_Layout/entry/src/mock/mock-config.json5
deleted file mode 100644
index 7a73a41bfdf76d6f793007240d80983a52f15f97..0000000000000000000000000000000000000000
--- a/ArkUI/Proper_Use_Layout/entry/src/mock/mock-config.json5
+++ /dev/null
@@ -1,2 +0,0 @@
-{
-}
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/entry/src/ohosTest/ets/test/Ability.test.ets b/ArkUI/Proper_Use_Layout/entry/src/ohosTest/ets/test/Ability.test.ets
deleted file mode 100644
index 85c78f67579d6e31b5f5aeea463e216b9b141048..0000000000000000000000000000000000000000
--- a/ArkUI/Proper_Use_Layout/entry/src/ohosTest/ets/test/Ability.test.ets
+++ /dev/null
@@ -1,35 +0,0 @@
-import { hilog } from '@kit.PerformanceAnalysisKit';
-import { describe, beforeAll, beforeEach, afterEach, afterAll, it, expect } from '@ohos/hypium';
-
-export default function abilityTest() {
- describe('ActsAbilityTest', () => {
- // Defines a test suite. Two parameters are supported: test suite name and test suite function.
- beforeAll(() => {
- // Presets an action, which is performed only once before all test cases of the test suite start.
- // This API supports only one parameter: preset action function.
- })
- beforeEach(() => {
- // Presets an action, which is performed before each unit test case starts.
- // The number of execution times is the same as the number of test cases defined by **it**.
- // This API supports only one parameter: preset action function.
- })
- afterEach(() => {
- // Presets a clear action, which is performed after each unit test case ends.
- // The number of execution times is the same as the number of test cases defined by **it**.
- // This API supports only one parameter: clear action function.
- })
- afterAll(() => {
- // Presets a clear action, which is performed after all test cases of the test suite end.
- // This API supports only one parameter: clear action function.
- })
- it('assertContain', 0, () => {
- // Defines a test case. This API supports three parameters: test case name, filter parameter, and test case function.
- hilog.info(0x0000, 'testTag', '%{public}s', 'it begin');
- let a = 'abc';
- let b = 'b';
- // Defines a variety of assertion methods, which are used to declare expected boolean conditions.
- expect(a).assertContain(b);
- expect(a).assertEqual(a);
- })
- })
-}
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/entry/src/ohosTest/ets/test/List.test.ets b/ArkUI/Proper_Use_Layout/entry/src/ohosTest/ets/test/List.test.ets
deleted file mode 100644
index 794c7dc4ed66bd98fa3865e07922906e2fcef545..0000000000000000000000000000000000000000
--- a/ArkUI/Proper_Use_Layout/entry/src/ohosTest/ets/test/List.test.ets
+++ /dev/null
@@ -1,5 +0,0 @@
-import abilityTest from './Ability.test';
-
-export default function testsuite() {
- abilityTest();
-}
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/entry/src/test/List.test.ets b/ArkUI/Proper_Use_Layout/entry/src/test/List.test.ets
deleted file mode 100644
index bb5b5c3731e283dd507c847560ee59bde477bbc7..0000000000000000000000000000000000000000
--- a/ArkUI/Proper_Use_Layout/entry/src/test/List.test.ets
+++ /dev/null
@@ -1,5 +0,0 @@
-import localUnitTest from './LocalUnit.test';
-
-export default function testsuite() {
- localUnitTest();
-}
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/entry/src/test/LocalUnit.test.ets b/ArkUI/Proper_Use_Layout/entry/src/test/LocalUnit.test.ets
deleted file mode 100644
index 165fc1615ee8618b4cb6a622f144a9a707eee99f..0000000000000000000000000000000000000000
--- a/ArkUI/Proper_Use_Layout/entry/src/test/LocalUnit.test.ets
+++ /dev/null
@@ -1,33 +0,0 @@
-import { describe, beforeAll, beforeEach, afterEach, afterAll, it, expect } from '@ohos/hypium';
-
-export default function localUnitTest() {
- describe('localUnitTest', () => {
- // Defines a test suite. Two parameters are supported: test suite name and test suite function.
- beforeAll(() => {
- // Presets an action, which is performed only once before all test cases of the test suite start.
- // This API supports only one parameter: preset action function.
- });
- beforeEach(() => {
- // Presets an action, which is performed before each unit test case starts.
- // The number of execution times is the same as the number of test cases defined by **it**.
- // This API supports only one parameter: preset action function.
- });
- afterEach(() => {
- // Presets a clear action, which is performed after each unit test case ends.
- // The number of execution times is the same as the number of test cases defined by **it**.
- // This API supports only one parameter: clear action function.
- });
- afterAll(() => {
- // Presets a clear action, which is performed after all test cases of the test suite end.
- // This API supports only one parameter: clear action function.
- });
- it('assertContain', 0, () => {
- // Defines a test case. This API supports three parameters: test case name, filter parameter, and test case function.
- let a = 'abc';
- let b = 'b';
- // Defines a variety of assertion methods, which are used to declare expected boolean conditions.
- expect(a).assertContain(b);
- expect(a).assertEqual(a);
- });
- });
-}
\ No newline at end of file
diff --git a/ArkUI/Proper_Use_Layout/oh-package.json5 b/ArkUI/Proper_Use_Layout/oh-package.json5
index a8aff0c5aff22d78aa26fd19c3861f4320e951ff..f440d114b8a9d9aeadd0e891bba0d0d076e70936 100644
--- a/ArkUI/Proper_Use_Layout/oh-package.json5
+++ b/ArkUI/Proper_Use_Layout/oh-package.json5
@@ -3,8 +3,5 @@
"description": "Please describe the basic information.",
"dependencies": {
},
- "devDependencies": {
- "@ohos/hypium": "1.0.21",
- "@ohos/hamock": "1.0.0"
- }
+ "devDependencies": {}
}
diff --git a/ArkUI/Proper_Use_Layout/screenshots/Screenshot.jpeg b/ArkUI/Proper_Use_Layout/screenshots/Screenshot.jpeg
deleted file mode 100644
index 5c4d3548c337cfa452db36ff85aa23a952e0afd7..0000000000000000000000000000000000000000
Binary files a/ArkUI/Proper_Use_Layout/screenshots/Screenshot.jpeg and /dev/null differ
diff --git a/ArkUI/PureTabsExt/README.md b/ArkUI/PureTabsExt/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..fdd98fc080aae135424c3b0faef31e68194d3c2a
--- /dev/null
+++ b/ArkUI/PureTabsExt/README.md
@@ -0,0 +1,61 @@
+# Tabs开发实践案例-补充案例
+### 简介
+ 本示例主要Tabs组件常用的场景实践示例的补充内容，补充了TabsBar显示效果相关的子场景，包含TabBar背景模糊效果、页签超出TabBar区域显示、TabBar边缘渐隐、TabBar偏移、切换指定页签等场景。
+
+### 效果预览
+| TabBar背景模糊效果 | 页签超出TabBar区域显示，TabBar边缘渐隐 | TabBar偏移 | 切换指定页签 |
+|--------------------------------------------|--------------------------------------------|--------------------------------------|-------------------------------------|
+|  |  |  |  |
+### 工程目录
+```
+├──entry/src/main/ets // 代码区
+│ ├──common
+│ │ └──constant
+│ │ └──Constants.ets // 常量类
+│ ├──entryability
+│ │ └──EntryAbility.ets // 程序入口类
+│ ├──entrybackupability
+│ │ └──EntryBackupAbility.ets
+│ ├──pages
+│ │ └──Index.ets // 入口页
+│ └──view
+│ ├──InTabComponent.ets // 设置TabBar偏移量及透明度
+│ ├──OutTabComponent.ets // 页签超出TabBar区域显示
+│ ├──SearchBarComponent.ets // 搜索框
+│ └──SwitchTabComponent.ets // 切换至指定页签
+└──entry/src/main/resources // 应用资源目录
+```
+### 具体实现
+- TabBar背景模糊效果
+ 通过设置Tabs组件的barOverlap属性，可以实现TabBar变模糊并叠加在TabContent之上，并且配合barBackgroundBlurStyle属性实现毛玻璃效果。
+- 页签超出TabBar区域显示
+ 通过barModifier设置tabBar的clip属性，实现页签超出tabBar区域显示效果。
+- TabBar边缘渐隐
+ 通过配置fadingEdge(true)实现TabBar边缘渐隐。
+- TabBar偏移
+ 通过TabsController的setTabBarTranslate()、setTabBarOpacity()方法可以设置TabBar偏移量及透明度。
+- 切换指定页签
+ Tabs组件除了自带的滑动切换和点击切换功能外，还提供了两种可编程方式来切换页签。第一种是通过调用TabsController的changeIndex()方法，切换到指定的index；第二种是定义一个由@State修饰的变量currentIndex，并将其绑定到Tabs，通过修改currentIndex的值来触发页签切换。
+
+### 相关权限
+无
+
+### 约束与限制
+1. 本示例仅支持标准系统上运行，支持设备：华为手机。
+
+2. HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
+
+3. DevEco Studio版本：DevEco Studio 5.0.5 Release及以上。
+
+4. HarmonyOS SDK版本：HarmonyOS 5.0.5 Release SDK及以上。
+
+### 下载
+
+如需单独下载本工程，执行如下命令：
+```
+git clone --filter=blob:none --no-checkout https://gitee.com/harmonyos_samples/BestPracticeSnippets.git
+cd BestPracticeSnippets
+git sparse-checkout init --cone
+git sparse-checkout set ArkUI/PureTabsExt
+git checkout
+```
diff --git a/ArkUI/PureTabsExt/entry/src/main/ets/entryability/EntryAbility.ets b/ArkUI/PureTabsExt/entry/src/main/ets/entryability/EntryAbility.ets
index d3ee54d2beea61d38866762868bd056d3e39e3c9..6e8ddad71a3f9ef705cc39a675342118ec298ffd 100644
--- a/ArkUI/PureTabsExt/entry/src/main/ets/entryability/EntryAbility.ets
+++ b/ArkUI/PureTabsExt/entry/src/main/ets/entryability/EntryAbility.ets
@@ -14,6 +14,7 @@
*/
import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
+import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';
@@ -21,7 +22,12 @@ 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);
+ try {
+ this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
+ } catch (error) {
+ let err = error as BusinessError;
+ hilog.warn(0x000, 'testTag', `setColorMode failed, code=${err.code}, message=${err.message}`);
+ }
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
}
diff --git a/ArkUI/PureTabsExt/entry/src/main/ets/view/InTabComponent.ets b/ArkUI/PureTabsExt/entry/src/main/ets/view/InTabComponent.ets
index 95476169b1cf53aa29d639b0bb914a0e9189d0f4..81999269719c8423601719861109f4c5a6cc2673 100644
--- a/ArkUI/PureTabsExt/entry/src/main/ets/view/InTabComponent.ets
+++ b/ArkUI/PureTabsExt/entry/src/main/ets/view/InTabComponent.ets
@@ -12,7 +12,9 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
-import { AbilityConstant,Configuration } from "@kit.AbilityKit";
+import { AbilityConstant, common,Configuration } from "@kit.AbilityKit";
+import { BusinessError } from '@kit.BasicServicesKit';
+import { hilog } from "@kit.PerformanceAnalysisKit";
// [Start tabs_bar_translate]
@Component
@@ -38,10 +40,13 @@ export default struct InTabComponent {
}
private async updateTabItems(){
- await this.getUIContext().getHostContext()?.resourceManager.getStringArrayValue($r('app.strarray.in_tabs_items'))
+ await this.getUIContext().getHostContext()?.resourceManager.getStringArrayValue($r('app.strarray.in_tabs_items').id)
.then((strarray: string[]) => {
this.tabItems = strarray;
- });
+ })
+ .catch((err: BusinessError) => {
+ hilog.error(0x000, 'testTag', `getStringArrayValue failed, code=${err.code}, message=${err.message}`)
+ })
}
subscribeSystemLanguageUpdate() {
diff --git a/ArkUI/PureTabsExt/entry/src/main/ets/view/SwitchTabComponent.ets b/ArkUI/PureTabsExt/entry/src/main/ets/view/SwitchTabComponent.ets
index 03adf3c67f746e3df24c07e84a6b43595957b9f3..e2528a293becb424feb6926c7ecbd0dfba35af70 100644
--- a/ArkUI/PureTabsExt/entry/src/main/ets/view/SwitchTabComponent.ets
+++ b/ArkUI/PureTabsExt/entry/src/main/ets/view/SwitchTabComponent.ets
@@ -13,7 +13,8 @@
* limitations under the License.
*/
import { AbilityConstant, Configuration } from "@kit.AbilityKit";
-import { Constants } from "../common/constant/Constants";
+import { BusinessError } from '@kit.BasicServicesKit';
+import { hilog } from "@kit.PerformanceAnalysisKit";
// [Start custom_switch_tab]
@Component
@@ -32,10 +33,13 @@ export default struct SwitchTabComponent {
private async updateTabItems() {
await this.getUIContext()
- .getHostContext()?.resourceManager.getStringArrayValue($r('app.strarray.switch_tabs_items'))
+ .getHostContext()?.resourceManager.getStringArrayValue($r('app.strarray.switch_tabs_items').id)
.then((strarray: string[]) => {
this.tabItems = strarray;
- });
+ })
+ .catch((err: BusinessError) => {
+ hilog.error(0x000, 'testTag', `getStringArrayValue failed, code=${err.code}, message=${err.message}`)
+ })
}
subscribeSystemLanguageUpdate() {
diff --git a/ArkUI/PureTabsExt/entry/src/main/module.json5 b/ArkUI/PureTabsExt/entry/src/main/module.json5
index a1cea8b6a4560cee7bda7a2db52f310c035ab6c8..44c5e49d8129f5d5bcc87ee6768d4a007d4877ca 100644
--- a/ArkUI/PureTabsExt/entry/src/main/module.json5
+++ b/ArkUI/PureTabsExt/entry/src/main/module.json5
@@ -6,8 +6,6 @@
"mainElement": "EntryAbility",
"deviceTypes": [
"phone",
- "tablet",
- "2in1"
],
"deliveryWithInstall": true,
"installationFree": false,
diff --git a/ArkTS_high_performance_segment/.gitignore b/ArkUI/StateManagement/.gitignore
similarity index 100%
rename from ArkTS_high_performance_segment/.gitignore
rename to ArkUI/StateManagement/.gitignore
diff --git a/ArkUI/StateManagement/AppScope/app.json5 b/ArkUI/StateManagement/AppScope/app.json5
new file mode 100644
index 0000000000000000000000000000000000000000..555e16abacdd36eb1771ceff940174bfe7e8faf2
--- /dev/null
+++ b/ArkUI/StateManagement/AppScope/app.json5
@@ -0,0 +1,10 @@
+{
+ "app": {
+ "bundleName": "com.example.statemanagement",
+ "vendor": "example",
+ "versionCode": 1000000,
+ "versionName": "1.0.0",
+ "icon": "$media:layered_image",
+ "label": "$string:app_name"
+ }
+}
diff --git a/ArkUI/StateManagement/AppScope/resources/base/element/string.json b/ArkUI/StateManagement/AppScope/resources/base/element/string.json
new file mode 100644
index 0000000000000000000000000000000000000000..f2aaa15ddeb29f99e8453bc919d10efcf44d0361
--- /dev/null
+++ b/ArkUI/StateManagement/AppScope/resources/base/element/string.json
@@ -0,0 +1,8 @@
+{
+ "string": [
+ {
+ "name": "app_name",
+ "value": "StateManagement"
+ }
+ ]
+}
diff --git a/MultiVideoApplication/AppScope/resources/base/media/background.png b/ArkUI/StateManagement/AppScope/resources/base/media/background.png
similarity index 100%
rename from MultiVideoApplication/AppScope/resources/base/media/background.png
rename to ArkUI/StateManagement/AppScope/resources/base/media/background.png
diff --git a/MultiVideoApplication/products/phone/src/main/resources/base/media/foreground.png b/ArkUI/StateManagement/AppScope/resources/base/media/foreground.png
similarity index 100%
rename from MultiVideoApplication/products/phone/src/main/resources/base/media/foreground.png
rename to ArkUI/StateManagement/AppScope/resources/base/media/foreground.png
diff --git a/MultiCommunityApplication/AppScope/resources/base/media/layered_image.json b/ArkUI/StateManagement/AppScope/resources/base/media/layered_image.json
similarity index 100%
rename from MultiCommunityApplication/AppScope/resources/base/media/layered_image.json
rename to ArkUI/StateManagement/AppScope/resources/base/media/layered_image.json
diff --git a/ArkUI/StateManagement/LICENSE b/ArkUI/StateManagement/LICENSE
new file mode 100644
index 0000000000000000000000000000000000000000..18795a48d6b12fcdc1aa7bac9a9cb99f83815267
--- /dev/null
+++ b/ArkUI/StateManagement/LICENSE
@@ -0,0 +1,78 @@
+ Copyright (c) 2025 Huawei Device Co., Ltd. All rights reserved.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
+Apache License, Version 2.0
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License.
+
+Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License.
+
+Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution.
+
+You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+1.You must give any other recipients of the Work or Derivative Works a copy of this License; and
+2.You must cause any modified files to carry prominent notices stating that You changed the files; and
+3.You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+4.If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions.
+
+Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+
+6. Trademarks.
+
+This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty.
+
+Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability.
+
+In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability.
+
+While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
\ No newline at end of file
diff --git a/ArkUI/StateManagement/README.md b/ArkUI/StateManagement/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..58903262d186e9383751d7479108a5a2a42c258f
--- /dev/null
+++ b/ArkUI/StateManagement/README.md
@@ -0,0 +1,34 @@
+# 状态管理最佳实践
+
+### 介绍
+
+本示例通过ArkUI状态管理@State、@Prop、@Link、@Observed等装饰器，实现不同页面之间状态同步情景和应用的数据状态管理情景。帮助开发者掌握应用的数据状态同步处理。
+
+### 相关权限
+
+不涉及。
+
+### 依赖
+
+不涉及。
+
+### 约束与限制
+
+1.本示例仅支持标准系统上运行，支持设备：华为手机。
+
+2.HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
+
+3.DevEco Studio版本：DevEco Studio 5.0.5 Release及以上。
+
+4.HarmonyOS SDK版本：HarmonyOS 5.0.5 Release SDK及以上。
+
+### 下载
+
+如需单独下载本工程，执行如下命令：
+```
+git clone --filter=blob:none --no-checkout https://gitee.com/harmonyos_samples/BestPracticeSnippets.git
+cd BestPracticeSnippets
+git sparse-checkout init --cone
+git sparse-checkout set ArkUI/StateManagement
+git checkout
+```
diff --git a/ArkUI/StateManagement/build-profile.json5 b/ArkUI/StateManagement/build-profile.json5
new file mode 100644
index 0000000000000000000000000000000000000000..9e87e7e6f19020fe21192844709f192cec80fd44
--- /dev/null
+++ b/ArkUI/StateManagement/build-profile.json5
@@ -0,0 +1,42 @@
+{
+ "app": {
+ "signingConfigs": [],
+ "products": [
+ {
+ "name": "default",
+ "signingConfig": "default",
+ "targetSdkVersion": "5.0.5(17)",
+ "compatibleSdkVersion": "5.0.5(17)",
+ "runtimeOS": "HarmonyOS",
+ "buildOption": {
+ "strictMode": {
+ "caseSensitiveCheck": true,
+ "useNormalizedOHMUrl": true
+ }
+ }
+ }
+ ],
+ "buildModeSet": [
+ {
+ "name": "debug",
+ },
+ {
+ "name": "release"
+ }
+ ]
+ },
+ "modules": [
+ {
+ "name": "entry",
+ "srcPath": "./entry",
+ "targets": [
+ {
+ "name": "default",
+ "applyToProducts": [
+ "default"
+ ]
+ }
+ ]
+ }
+ ]
+}
\ No newline at end of file
diff --git a/ArkUI/orientationDevelopment/code-linter.json5 b/ArkUI/StateManagement/code-linter.json5
similarity index 100%
rename from ArkUI/orientationDevelopment/code-linter.json5
rename to ArkUI/StateManagement/code-linter.json5
diff --git a/ArkUI/Component_Nesting_Optimization/entry/.gitignore b/ArkUI/StateManagement/entry/.gitignore
similarity index 100%
rename from ArkUI/Component_Nesting_Optimization/entry/.gitignore
rename to ArkUI/StateManagement/entry/.gitignore
diff --git a/Privacy/ContactData/build-profile.json5 b/ArkUI/StateManagement/entry/build-profile.json5
similarity index 100%
rename from Privacy/ContactData/build-profile.json5
rename to ArkUI/StateManagement/entry/build-profile.json5
diff --git a/ArkUI/StateManagement/entry/hvigorfile.ts b/ArkUI/StateManagement/entry/hvigorfile.ts
new file mode 100644
index 0000000000000000000000000000000000000000..b0e3a1ab98a91bc918d6404b2413111a5011f14a
--- /dev/null
+++ b/ArkUI/StateManagement/entry/hvigorfile.ts
@@ -0,0 +1,6 @@
+import { hapTasks } from '@ohos/hvigor-ohos-plugin';
+
+export default {
+ system: hapTasks, /* Built-in plugin of Hvigor. It cannot be modified. */
+ plugins: [] /* Custom plugin to extend the functionality of Hvigor. */
+}
\ No newline at end of file
diff --git a/Privacy/ContactData/obfuscation-rules.txt b/ArkUI/StateManagement/entry/obfuscation-rules.txt
similarity index 100%
rename from Privacy/ContactData/obfuscation-rules.txt
rename to ArkUI/StateManagement/entry/obfuscation-rules.txt
diff --git a/CrossPlatformCompatibility/entry/oh-package.json5 b/ArkUI/StateManagement/entry/oh-package.json5
similarity index 100%
rename from CrossPlatformCompatibility/entry/oh-package.json5
rename to ArkUI/StateManagement/entry/oh-package.json5
diff --git a/ArkUI/StateManagement/entry/src/main/ets/entryability/EntryAbility.ets b/ArkUI/StateManagement/entry/src/main/ets/entryability/EntryAbility.ets
new file mode 100644
index 0000000000000000000000000000000000000000..508880af8c33aa838016d1cd4b2c68be2f447540
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/entryability/EntryAbility.ets
@@ -0,0 +1,44 @@
+import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { window } 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) => {
+ 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');
+ }
+}
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets b/ArkUI/StateManagement/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets
new file mode 100644
index 0000000000000000000000000000000000000000..8e4de99282050bad799ac892eb85ac5449364a51
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/entrybackupability/EntryBackupAbility.ets
@@ -0,0 +1,16 @@
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { BackupExtensionAbility, BundleVersion } from '@kit.CoreFileKit';
+
+const DOMAIN = 0x0000;
+
+export default class EntryBackupAbility extends BackupExtensionAbility {
+ async onBackup() {
+ hilog.info(DOMAIN, 'testTag', 'onBackup ok');
+ await Promise.resolve();
+ }
+
+ async onRestore(bundleVersion: BundleVersion) {
+ hilog.info(DOMAIN, 'testTag', 'onRestore ok %{public}s', JSON.stringify(bundleVersion));
+ await Promise.resolve();
+ }
+}
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/pages/Index.ets b/ArkUI/StateManagement/entry/src/main/ets/pages/Index.ets
new file mode 100644
index 0000000000000000000000000000000000000000..633adadd00282a226ff7901c1d9e32a19e85d144
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/pages/Index.ets
@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@Entry
+@Component
+struct Index {
+ private buttonList: string[] =
+ Array.from({ length: 12 }, (_: number, i: number) => `Segment${i + 1}`);
+ @Provide("appPathStack") appPathStack: NavPathStack = new NavPathStack();
+ @Provide("discoverPathStack") discoverPathStack: NavPathStack = new NavPathStack();
+
+ build() {
+ Navigation(this.appPathStack) {
+ List({ space: 12 }) {
+ ForEach(this.buttonList, (item: string) => {
+ ListItem() {
+ Button(item).onClick(() => this.appPathStack.pushPathByName(item, null));
+ }
+ }, (item: string) => item)
+ }
+ .width('100%')
+ .height('100%')
+ .alignListItem(ListItemAlign.Center)
+ }
+ .mode(NavigationMode.Stack)
+ .height('100%')
+ .width('100%')
+ }
+}
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment.ets
new file mode 100644
index 0000000000000000000000000000000000000000..90d01106be3521aba361fb5f63de6decafa920f4
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment.ets
@@ -0,0 +1,35 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+@Builder
+export function Segment01Builder() {
+ NavDestination(){
+ MyComponent()
+ }
+}
+
+// [Start Counter_example1_start]
+@Observed
+class Translate {
+ translateX: number = 20;
+}
+
+@Component
+struct MyComponent {
+ @State translateObj: Translate = new Translate(); // The variable translateObj is not associated with any UI component and should not be defined as a state variable
+ @State buttonMsg: string = 'I am button'; // The variable buttonMsg is not associated with any UI component and should not be defined as a state variable
+ build() {
+ }
+}
+// [End Counter_example1_start]
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment10.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment10.ets
new file mode 100644
index 0000000000000000000000000000000000000000..a0763e90c13a47f0817efe4ec9d4934eef9ccf9e
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment10.ets
@@ -0,0 +1,80 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@Builder
+export function Segment10Builder() {
+ NavDestination(){
+ Index()
+ }
+}
+// [Start Counter_example5]
+@Component
+struct Index {
+ @State currentIndex: number = 0; // The subscript of the currently selected list item
+ private listData: string[] = [];
+
+
+ aboutToAppear(): void {
+ for (let i = 0; i < 10; i++) {
+ this.listData.push(`${i}`);
+ }
+ }
+
+
+ build() {
+ Row() {
+ Column() {
+ List() {
+ ForEach(this.listData, (item: string, index: number) => {
+ ListItem() {
+ ListItemComponent({ item: item, index: index, currentIndex: this.currentIndex })
+ }
+ })
+ }
+ .alignListItem(ListItemAlign.Center)
+ }
+ .width('100%')
+ }
+ .height('100%')
+ }
+}
+
+
+@Component
+struct ListItemComponent {
+ @Prop item: string;
+ @Prop index: number; // The subscript of the list item
+ @Link currentIndex: number;
+ private sizeFont: number = 50;
+
+
+ isRender(): number {
+ console.info(`ListItemComponent ${this.index} Text is rendered`);
+ return this.sizeFont;
+ }
+
+
+ build() {
+ Column() {
+ Text(this.item)
+ .fontSize(this.isRender())// Dynamically set the color of the text according to the difference between the index and currentIndex of the current list item.
+ .fontColor(Math.abs(this.index - this.currentIndex) <= 1 ? Color.Red : Color.Blue)
+ .onClick(() => {
+ this.currentIndex = this.index;
+ })
+ }
+ }
+}
+// [End Counter_example5]
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment11.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment11.ets
new file mode 100644
index 0000000000000000000000000000000000000000..e611c0d9f6abcb1b87b978219a50cdd98e9935b5
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment11.ets
@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@Builder
+export function Segment11Builder() {
+ NavDestination(){
+ UseWatchListener()
+ }
+}
+// [Start Case7]
+@Entry
+@Component
+struct UseWatchListener {
+ @State currentIndex: number = 0; // The subscript of the currently selected list item
+ private listData: string[] = [];
+ aboutToAppear(): void {
+ for (let i = 0; i < 10; i++) {
+ this.listData.push(`${i}`);
+ }
+ }
+ build() {
+ Row() {
+ Column() {
+ List() {
+ ForEach(this.listData, (item: string, index: number) => {
+ ListItem() {
+ ListItemComponent({ item: item, index: index, currentIndex: this.currentIndex })
+ }
+ })
+ }
+ .height('100%')
+ .width('100%')
+ .alignListItem(ListItemAlign.Center)
+ }
+ .width('100%')
+ }
+ .height('100%')
+ }
+}
+@Component
+struct ListItemComponent {
+ @Prop item: string;
+ @Prop index: number; // The subscript of the list item
+ @Link @Watch('onCurrentIndexUpdate') currentIndex: number;
+ @State color: Color = Math.abs(this.index - this.currentIndex) <= 1 ? Color.Red : Color.Blue;
+ isRender(): number {
+ console.info(`ListItemComponent ${this.index} Text is rendered`);
+ return 50;
+ }
+ onCurrentIndexUpdate() {
+ // Dynamically modifies the value of color based on the difference between the index and currentIndex of the current list item.
+ this.color = Math.abs(this.index - this.currentIndex) <= 1 ? Color.Red : Color.Blue;
+ }
+ build() {
+ Column() {
+ Text(this.item)
+ .fontSize(this.isRender())
+ .fontColor(this.color)
+ .onClick(() => {
+ this.currentIndex = this.index;
+ })
+ }
+ }
+}
+// [End Case7]
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment12.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment12.ets
new file mode 100644
index 0000000000000000000000000000000000000000..07d106c3f27da228fb75c780475ba5e06e78a4ac
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment12.ets
@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [Start Case8]
+import { ButtonComponent } from '../segment/segment13';
+import { ListItemComponent } from '../segment/segment14';
+@Entry
+@Component
+struct UseEmitterPublish {
+ listData: string[] = ['A', 'B', 'C', 'D', 'E', 'F'];
+ build() {
+ Column() {
+ Row() {
+ Column() {
+ ButtonComponent()
+ }
+ }
+ Column() {
+ Column() {
+ List() {
+ ForEach(this.listData, (item: string, index: number) => {
+ ListItemComponent({ myItem: item, index: index })
+ })
+ }
+ .height('100%')
+ .width('100%')
+ .alignListItem(ListItemAlign.Center)
+ }
+ }
+ }
+ }
+}
+// [End Case8]
+@Builder
+export function Segment12Builder() {
+ NavDestination(){
+ UseEmitterPublish()
+ }
+}
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment13.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment13.ets
new file mode 100644
index 0000000000000000000000000000000000000000..5acd363a25e1fbe438dd152b11d2d3d55bb78434
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment13.ets
@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [Start Case9]
+import { emitter } from '@kit.BasicServicesKit';
+const CHANGE_COLOR_EVENT_ID = 1;
+@Component
+export struct ButtonComponent {
+ value: number = 2;
+ build() {
+ Button(`下标是${this.value}的倍数的组件文字变为红色`)
+ .onClick(() => {
+ let event: emitter.InnerEvent = {
+ eventId: CHANGE_COLOR_EVENT_ID,
+ priority: emitter.EventPriority.LOW
+ };
+ let eventData: emitter.EventData = {
+ data: {
+ value: this.value
+ }
+ };
+ // Sends an event with eventId of CHANGE_COLOR_EVENT_ID and event content of eventData
+ emitter.emit(event, eventData);
+ this.value++;
+ })
+ }
+}
+// [End Case9]
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment14.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment14.ets
new file mode 100644
index 0000000000000000000000000000000000000000..f82a457d79d29d2665e9baac6473a0d6de45371d
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment14.ets
@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [Start Case10]
+import { emitter } from '@kit.BasicServicesKit';
+const CHANGE_COLOR_EVENT_ID = 1;
+@Component
+export struct ListItemComponent {
+ @State color: Color = Color.Black;
+ @Prop index: number;
+ @Prop myItem: string;
+ aboutToAppear(): void {
+ let event: emitter.InnerEvent = {
+ eventId: CHANGE_COLOR_EVENT_ID
+ };
+ // Execute this callback after receiving an event with eventId of CHANGE_COLOR_EVENT_ID
+ let callback = (eventData: emitter.EventData): void => {
+ if (eventData.data?.value !== 0 && this.index % eventData.data?.value === 0) {
+ this.color = Color.Red;
+ }
+ };
+ // Subscribe to events with eventId of CHANGE_COLOR_EVENT_ID
+ emitter.on(event, callback);
+ }
+ build() {
+ Column() {
+ Text(this.myItem)
+ .fontSize(50)
+ .fontColor(this.color)
+ }
+ }
+}
+// [End Case10]
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment2.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment2.ets
new file mode 100644
index 0000000000000000000000000000000000000000..d7d88d7929bb146ed9d5bde52fa93a6d7a800992
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment2.ets
@@ -0,0 +1,37 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+@Builder
+export function Segment02Builder() {
+ NavDestination(){
+ MyComponent()
+ }
+}
+// [Start Counter_example2_start]
+@Observed
+class Translate {
+ translateX: number = 20;
+}
+
+@Component
+struct MyComponent {
+ @State translateObj: Translate = new Translate();
+ @State buttonMsg: string = 'I am button';
+ build() {
+ Column() {
+ Button(this.buttonMsg) // Here we just read the value of the variable buttonMsg, without any write operation.
+ }
+ }
+}
+// [End Counter_example2_start]
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment3.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment3.ets
new file mode 100644
index 0000000000000000000000000000000000000000..833ab40910d6fb4154911c9c20c40591c9b9b503
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment3.ets
@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@Builder
+export function Segment03Builder() {
+ NavDestination(){
+ UnnecessaryState1()
+ }
+}
+// [Start Case1_start]
+@Observed
+class Translate {
+ translateX: number = 20;
+}
+
+@Component
+struct UnnecessaryState1 {
+ @State translateObj: Translate = new Translate(); // If there are both read and write operations and a Button component is associated with it, it is recommended to use state variables.
+ buttonMsg = 'I am button'; // Only read the value of the variable buttonMsg, without any write operations, just use the general variables directly
+ build() {
+ Column() {
+ Button(this.buttonMsg)
+ .onClick(() => {
+ this.getUIContext().animateTo({
+ duration: 50
+ }, () => {
+ this.translateObj.translateX = (this.translateObj.translateX + 50) % 150; // Reassign value to variable translateObj when clicked.
+ })
+ })
+ }
+ .translate({
+ x: this.translateObj.translateX // Retrieve the value in translateObj.
+ })
+ }
+}
+// [End Case1_start]
\ No newline at end of file
diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment4.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment4.ets
new file mode 100644
index 0000000000000000000000000000000000000000..21f5a4df2ffd5e877f367455afc9c85307a896f9
--- /dev/null
+++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment4.ets
@@ -0,0 +1,48 @@
+/*
+ * Copyright (c) 2025 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+@Builder
+export function Segment04Builder() {
+ NavDestination(){
+ Index()
+ }
+}
+// [Start counter_example]
+
+@Component
+struct Index {
+ @State message: string = '';
+ // Define methods for changing state variables (multiple modifications of state variables)
+ appendMsg(newMsg: string) {
+ this.message += newMsg;
+ this.message += ';';
+ this.message += ''; + } + build() { + Column() { + Button('Click Print Log') + .onClick(() => { + this.appendMsg('Operational state variables'); // Calling encapsulated methods for changing state variables + }) + .width('90%') + .backgroundColor(Color.Blue) + .fontColor(Color.White) + .margin({ top: 10}) + } + .justifyContent(FlexAlign.Start) + .alignItems(HorizontalAlign.Center) + .margin({ top: 15 }) + } +} +// [End counter_example] \ No newline at end of file diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment5.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment5.ets new file mode 100644 index 0000000000000000000000000000000000000000..c05f303c48e006387e25e7fd6ec90aa48174cfc2 --- /dev/null +++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment5.ets @@ -0,0 +1,50 @@ +/* + * Copyright (c) 2025 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +@Builder +export function Segment05Builder() { + NavDestination(){ + UnnecessaryState2() + } +} +// [Start Case2_start] +@Entry +@Component +struct UnnecessaryState2 { + @State message: string = ''; + // Define methods for changing state variables (intermediate variables are manipulated during method execution, state variables are modified only once) + appendMsg(newMsg: string) { + let message = this.message; + message += newMsg; + message += ';'; + message += '
'; + this.message = message; + } + build() { + Column() { + Button('Click Print Log') + .onClick(() => { + this.appendMsg('Manipulating Temporary Variables'); // Calling encapsulated methods for changing state variables + }) + .width('90%') + .backgroundColor(Color.Blue) + .fontColor(Color.White) + .margin({ top: 10 }) + } + .justifyContent(FlexAlign.Start) + .alignItems(HorizontalAlign.Center) + .margin({ top: 15 }) + } +} +// [End Case2_start] \ No newline at end of file diff --git a/ArkUI/StateManagement/entry/src/main/ets/segment/segment6.ets b/ArkUI/StateManagement/entry/src/main/ets/segment/segment6.ets new file mode 100644 index 0000000000000000000000000000000000000000..42beb0647c32f1c87f156443ab02d8c01cb687d7 --- /dev/null +++ b/ArkUI/StateManagement/entry/src/main/ets/segment/segment6.ets @@ -0,0 +1,71 @@ +/* + * Copyright (c) 2025 Huawei Device Co., Ltd. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +@Builder +export function Segment06Builder() { + NavDestination(){ + UserInfoView() + } +} + +interface IUserAccountRepository { + getUserData(): Promise
+
## 工程目录
```
├──entry/src/main/ets // 代码区
@@ -16,7 +17,7 @@
│ │ └──EntryBackupAbility.ets
│ ├──pages
│ │ └──Index.ets // 首页
-│ └──views.ets
+│ └──views
│ ├──ConditionalRendering.ets // 条件渲染页
│ ├──GetStrOfId.ets // ID资源获取页
│ ├──GetStrOfResource.ets // 资源获取页
@@ -36,28 +37,40 @@
└──entry/src/main/resources // 应用资源目录
```
## 使用说明
-“避免冗余操作”的正例和反例，反例中包含release版本中冗余日志打印、Trace打点以及无业务代码的空回调，降低了性能。
-
-“高频回调场景中避免执行耗时操作”的正例和反例，以下常见高频回调场景中需要避免执行耗时操作:
-* 高频事件回调
-* 组件复用回调
-* 组件生命周期回调
-* 循环渲染
-* 组件属性
-
-反例中在高频事件中执行了上述耗时操作，降低了性能。
-
-“避免使用耗时接口”的正例和反例，反例中使用了没有指定资源id的接口，导致耗时增加，从而影响了性能。
-
-“使用多线程”是正例，开启多线程后，渲染页面速度加快，提升了性能。
+* 点击含有冗余操作按钮，进入二级页面。
+* 点击不含有冗余操作按钮，进入二级页面。
+* 点击组件复用反例按钮，进入二级页面，上下滑动，观察页面存在掉帧的现象。
+* 点击组件复用正例按钮，进入二级页面，上下滑动，页面滑动流畅。
+* 点击循环渲染反例按钮，进入二级页面，上下滑动，观察页面存在掉帧的现象。
+* 点击循环渲染正例按钮，进入二级页面，上下滑动，页面滑动流畅。
+* 点击组件属性反例按钮，进入二级页面，点击按钮，观察页面变化。
+* 点击组件属性正例按钮，进入二级页面，点击按钮，观察页面变化。
+* 点击通过资源对象按钮，进入二级页面。
+* 点击通过资源ID按钮，进入二级页面。
+* 点击使用异步按钮，进入二级页面，上下滑动，页面滑动流畅。
+* 点击使用多线程按钮，进入二级页面，上下滑动，页面滑动流畅。
+* 点击高频事件回调执行耗时操作按钮，进入二级页面。
+* 点击高频事件回调不执行耗时操作按钮，进入二级页面。
+* 点击条件渲染按钮，进入二级页面，点击按钮，观察页面变化。
## 相关权限
-无
+不涉及
## 约束与限制
* 本示例仅支持标准系统上运行，支持设备：华为手机。
-* HarmonyOS系统：HarmonyOS NEXT Release及以上。
+* HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。
+
+* DevEco Studio版本：DevEco Studio 5.0.5 Release及以上。
+
+* HarmonyOS SDK版本：HarmonyOS 5.0.5 Release SDK及以上。
-* DevEco Studio版本：DevEco Studio NEXT Release及以上。
+## 下载
-* HarmonyOS SDK版本：HarmonyOS NEXT Release SDK及以上。
\ No newline at end of file
+如需单独下载本工程，执行如下命令：
+```
+git clone --filter=blob:none --no-checkout https://gitee.com/harmonyos_samples/BestPracticeSnippets.git
+cd BestPracticeSnippets
+git sparse-checkout init --cone
+git sparse-checkout set AvoidTimeComsume
+git checkout
+```
\ No newline at end of file
diff --git a/AvoidTimeComsume/README_EN.md b/AvoidTimeComsume/README_EN.md
index 3042a16cb75fb18ec1817feec95e570aac3784fa..bae0f4ece15dbce9cc3897993711b794967341a0 100644
--- a/AvoidTimeComsume/README_EN.md
+++ b/AvoidTimeComsume/README_EN.md
@@ -3,8 +3,6 @@
In application development practices, it is important to effectively prevent the main thread from performing redundant and time-consuming operations. This can effectively reduce the load of the main thread and speed up the UI response. In scenarios where high-frequency callbacks are frequently triggered in a short period of time, time-consuming operations in the APIs need to be avoided to ensure that the main thread is not occupied for a long time. This prevents UI rendering from being blocked to avoid frame freezing or frame loss.
This sample describes common redundant operations, common high-frequency callback scenarios, and other main thread optimization methods during development.
-## Preview
-
## Project Directory
```
├──entry/src/main/ets // Code
@@ -56,8 +54,19 @@ N/A
## Constraints
* This sample is supported only on Huawei phones running the standard system.
-* The HarmonyOS version must be HarmonyOS NEXT Release or later.
+* The HarmonyOS version must be HarmonyOS 5.0.5 Release or later.
-* The DevEco Studio version must be DevEco Studio NEXT Release or later.
+* The DevEco Studio version must be DevEco Studio 5.0.5 Release or later.
-* The HarmonyOS SDK version must be HarmonyOS NEXT Release SDK or later.
+* The HarmonyOS SDK version must be HarmonyOS 5.0.5 Release SDK or later.
+
+## Download
+
+To download this project separately, execute the following command:
+```
+git clone --filter=blob:none --no-checkout https://gitee.com/harmonyos_samples/BestPracticeSnippets.git
+cd BestPracticeSnippets
+git sparse-checkout init --cone
+git sparse-checkout set AvoidTimeComsume
+git checkout
+```
diff --git a/AvoidTimeComsume/build-profile.json5 b/AvoidTimeComsume/build-profile.json5
index b2cc02977d74631a63703f33a1ae6c1f94d81219..6addf0233cf8ed875ba6574c0c91538334c17921 100644
--- a/AvoidTimeComsume/build-profile.json5
+++ b/AvoidTimeComsume/build-profile.json5
@@ -6,7 +6,8 @@
{
"name": "default",
"signingConfig": "default",
- "compatibleSdkVersion": "5.0.0(12)",
+ "compatibleSdkVersion": "5.0.5(17)",
+ "targetSdkVersion": "5.0.5(17)",
"runtimeOS": "HarmonyOS",
}
],
diff --git a/AvoidTimeComsume/entry/src/main/ets/entryability/EntryAbility.ets b/AvoidTimeComsume/entry/src/main/ets/entryability/EntryAbility.ets
index 80c495ede2460b86c56489c6c654126b77f31de6..471cad2a7dac7c186ecf07b2b15d41c2274b5370 100644
--- a/AvoidTimeComsume/entry/src/main/ets/entryability/EntryAbility.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/entryability/EntryAbility.ets
@@ -39,7 +39,11 @@ export default class EntryAbility extends UIAbility {
return;
}
hilog.info(0x0000, 'Sample', 'Succeeded in loading the content.');
- AppStorage.setOrCreate('uiContext', windowStage.getMainWindowSync().getUIContext());
+ try {
+ AppStorage.setOrCreate('uiContext', windowStage.getMainWindowSync().getUIContext());
+ } catch (error) {
+ hilog.error(0x0000, 'Sample', 'Failed to getMainWindowSync. Cause: %{public}s', JSON.stringify(error) ?? '');
+ }
});
windowStage.getMainWindow().then((windowObj) => {
diff --git a/AvoidTimeComsume/entry/src/main/ets/pages/Index.ets b/AvoidTimeComsume/entry/src/main/ets/pages/Index.ets
index e0258427c40dc9eb4b6459254820f2d07353f24e..8e2e7bf6cccd25a580d581b77918e6e3db87eb83 100644
--- a/AvoidTimeComsume/entry/src/main/ets/pages/Index.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/pages/Index.ets
@@ -12,6 +12,8 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
+import { BusinessError } from '@kit.BasicServicesKit';
+import { hilog } from '@kit.PerformanceAnalysisKit';
class DirectoryItem {
title: ResourceStr = '';
@@ -107,6 +109,8 @@ struct Index {
.onClick(() => {
this.getUIContext().getRouter().pushUrl({
url: item.uri
+ }).catch((error: BusinessError)=>{
+ hilog.error(0x0000,'',`pushUrl failed. code=${error.code}, message=${error.message}`);
});
})
}
@@ -128,6 +132,8 @@ struct Index {
.onClick(() => {
this.getUIContext().getRouter().pushUrl({
url: 'views/NegativeOfOnScroll'
+ }).catch((error: BusinessError)=>{
+ hilog.error(0x0000,'',`pushUrl failed. code=${error.code}, message=${error.message}`);
});
})
Button($r('app.string.positive_of_onScroll'))
@@ -139,6 +145,8 @@ struct Index {
.onClick(() => {
this.getUIContext().getRouter().pushUrl({
url: 'views/PositiveOfOnScroll'
+ }).catch((error: BusinessError)=>{
+ hilog.error(0x0000,'',`pushUrl failed. code=${error.code}, message=${error.message}`);
});
})
Button($r('app.string.conditional_rendering'))
@@ -150,7 +158,9 @@ struct Index {
.onClick(() => {
this.getUIContext().getRouter().pushUrl({
url: 'views/ConditionalRendering'
- });
+ }).catch((error: BusinessError)=>{
+ hilog.error(0x0000,'',`pushUrl failed. code=${error.code}, message=${error.message}`);
+ });;
})
}
.padding({ left: 16, right: 16, bottom: 44 })
diff --git a/AvoidTimeComsume/entry/src/main/ets/views/ConditionalRendering.ets b/AvoidTimeComsume/entry/src/main/ets/views/ConditionalRendering.ets
index 382f6fa052d3e715ce5b0df966e644ac85809278..ca0d90579746c63a4079ed6b7cc7d7d6d5e2d7a5 100644
--- a/AvoidTimeComsume/entry/src/main/ets/views/ConditionalRendering.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/views/ConditionalRendering.ets
@@ -13,9 +13,9 @@
* limitations under the License.
*/
+// [Start conditional_rendering]
import { hilog } from '@kit.PerformanceAnalysisKit';
-// [Start conditional_rendering]
@Entry
@Component
struct MyComponent {
@@ -26,6 +26,7 @@ struct MyComponent {
Column({ space: 10 }) {
Row({ space: 5 }) {
Column() {
+ // $r('app.media.chevron_left') It needs to be replaced with the resources required by the developers
Image($r('app.media.chevron_left'))
.width(16)
.height(16)
@@ -77,7 +78,7 @@ struct MyComponent {
@Component
struct CustomComponentA {
aboutToAppear(): void {
- let temp = 0;
+ let temp: number = 0;
for (let i = 0; i < 1000000; i++) {
temp += 1;
}
@@ -85,7 +86,7 @@ struct CustomComponentA {
}
aboutToDisappear(): void {
- let temp = 0;
+ let temp: number = 0;
for (let i = 0; i < 1000000; i++) {
temp += 1;
}
@@ -103,7 +104,7 @@ struct CustomComponentA {
@Component
struct CustomComponentB {
aboutToAppear(): void {
- let temp = 0;
+ let temp: number = 0;
for (let i = 0; i < 1000000; i++) {
temp += 1;
}
@@ -111,7 +112,7 @@ struct CustomComponentB {
}
aboutToDisappear(): void {
- let temp = 0;
+ let temp: number = 0;
for (let i = 0; i < 1000000; i++) {
temp += 1;
}
diff --git a/AvoidTimeComsume/entry/src/main/ets/views/GetStrOfId.ets b/AvoidTimeComsume/entry/src/main/ets/views/GetStrOfId.ets
index c0c91c35cc43a9500b38113de23643617d0db950..2dad628dc99368e72d05e8d046541d504c924ef8 100644
--- a/AvoidTimeComsume/entry/src/main/ets/views/GetStrOfId.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/views/GetStrOfId.ets
@@ -14,7 +14,7 @@
*/
// [Start get_str_of_id]
-import { hiTraceMeter } from '@kit.PerformanceAnalysisKit';
+import { hilog, hiTraceMeter } from '@kit.PerformanceAnalysisKit';
@Entry
@Component
@@ -23,8 +23,12 @@ struct GetStrOfId {
aboutToAppear(): void {
hiTraceMeter.startTrace('getStringSyncAfter', 1);
- // The input parameter of the getStringSync operation directly uses the resource and does use the resource ID
- this.getUIContext().getHostContext()!.resourceManager.getStringSync($r('app.string.test').id)
+ // The input parameter of the getStringSync operation directly uses the resource and resource ID
+ try {
+ this.getUIContext().getHostContext()!.resourceManager.getStringSync($r('app.string.test').id)
+ } catch (error) {
+ hilog.error(0x0000,'',`getStringSync failed. code=${error.code}, message=${error.message}`);
+ }
hiTraceMeter.finishTrace('getStringSyncAfter', 1)
}
diff --git a/AvoidTimeComsume/entry/src/main/ets/views/GetStrOfResource.ets b/AvoidTimeComsume/entry/src/main/ets/views/GetStrOfResource.ets
index db9f6697178b564713a2cf8db7b2fb03660e2099..edf6f5ec9cbc18b62ec02a500a368cc1c71bb75a 100644
--- a/AvoidTimeComsume/entry/src/main/ets/views/GetStrOfResource.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/views/GetStrOfResource.ets
@@ -14,7 +14,7 @@
*/
// [Start get_str_of_resource]
-import { hiTraceMeter } from '@kit.PerformanceAnalysisKit';
+import { hilog, hiTraceMeter } from '@kit.PerformanceAnalysisKit';
@Entry
@@ -25,7 +25,11 @@ struct GetStrOfResource {
aboutToAppear(): void {
hiTraceMeter.startTrace('getStringSync', 1);
// The input parameter of the getStringSync operation directly uses the resource and does not use the resource ID
- this.getUIContext().getHostContext()!.resourceManager.getStringSync($r('app.string.test'))
+ try {
+ this.getUIContext().getHostContext()!.resourceManager.getStringSync($r('app.string.test').id)
+ } catch (error) {
+ hilog.error(0x0000,'',`getStringSync failed. code=${error.code}, message=${error.message}`);
+ }
hiTraceMeter.finishTrace('getStringSync', 1)
}
diff --git a/AvoidTimeComsume/entry/src/main/ets/views/NegativeOfGrid.ets b/AvoidTimeComsume/entry/src/main/ets/views/NegativeOfGrid.ets
index 10dc77d32809a74dfe91536457bde5cdad3ce7a0..0390ed3f5e24336b6c158b06dbf25a10d747db25 100644
--- a/AvoidTimeComsume/entry/src/main/ets/views/NegativeOfGrid.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/views/NegativeOfGrid.ets
@@ -14,7 +14,6 @@
*/
import { hiTraceMeter } from '@kit.PerformanceAnalysisKit';
-import { router } from '@kit.ArkUI';
class MyDataSource implements IDataSource {
private dataArray: number[] = [];
diff --git a/AvoidTimeComsume/entry/src/main/ets/views/NoRedundantOperation.ets b/AvoidTimeComsume/entry/src/main/ets/views/NoRedundantOperation.ets
index 383ec3876813141be4d827ffa6ed4c47875e511e..c50fc4448d6899d581b16f746bd1ffa679a48923 100644
--- a/AvoidTimeComsume/entry/src/main/ets/views/NoRedundantOperation.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/views/NoRedundantOperation.ets
@@ -14,7 +14,6 @@
*/
import { hilog } from '@kit.PerformanceAnalysisKit';
-import { router } from '@kit.ArkUI';
// [Start no_redundant_operation]
// Redundancy operation example
diff --git a/AvoidTimeComsume/entry/src/main/ets/views/PositiveOfProperty.ets b/AvoidTimeComsume/entry/src/main/ets/views/PositiveOfProperty.ets
index 1ce7eab8ea5024ae3037b809b959c54cda4b7fb3..431f46ecfb11ee22975ae5b7ae825d5155d0f1ce 100644
--- a/AvoidTimeComsume/entry/src/main/ets/views/PositiveOfProperty.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/views/PositiveOfProperty.ets
@@ -16,6 +16,7 @@
// [Start positive_of_property]
import { taskpool } from '@kit.ArkTS'; // Task pools
import { hilog } from '@kit.PerformanceAnalysisKit';
+import { BusinessError } from '@kit.BasicServicesKit';
@Concurrent
function getHeight(): number {
@@ -31,7 +32,9 @@ function getHeight(): number {
// Execute getHeight
taskpool.execute(getHeight).then((value: Object) => {
AppStorage.setOrCreate('height', value);
-})
+}).catch((error: BusinessError)=>{
+ hilog.error(0x0000,'',`execute failed. code=${error.code}, message=${error.message}`);
+});
@Entry
@Component
diff --git a/AvoidTimeComsume/entry/src/main/ets/views/UseAsync.ets b/AvoidTimeComsume/entry/src/main/ets/views/UseAsync.ets
index cb40596a524299b49ecba14efab78bc5b5b5cbe6..76f17e27f2d49f16cc4685704ae015a49f0d7cf8 100644
--- a/AvoidTimeComsume/entry/src/main/ets/views/UseAsync.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/views/UseAsync.ets
@@ -16,7 +16,8 @@
import { Item, ResponseData, dataToItem } from '../common/Item';
import { WaterFlowDataSource } from './WaterFlowDataSource';
import { buffer } from '@kit.ArkTS';
-
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { BusinessError } from '@kit.BasicServicesKit';
@Entry
@Component
@@ -122,9 +123,15 @@ struct WaterFlowExample2 {
// data.json is the local json data, which is about 20 MB in size, and simulates getting data from the network
await this.getUIContext().getHostContext()!.resourceManager.getRawFileContent('data.json').then((data: Uint8Array) => {
// parse json
- let str = buffer.from(data).toString();
- res = JSON.parse(str);
- })
+ try {
+ let str: string = buffer.from(data).toString();
+ res = JSON.parse(str);
+ } catch (error) {
+ hilog.error(0x0000,'',`buffer.from failed. code=${error.code}, message=${error.message}`);
+ }
+ }).catch((error: BusinessError)=>{
+ hilog.error(0x0000,'',`getRawFileContent failed. code=${error.code}, message=${error.message}`);
+ });
return dataToItem(res.data)
}
diff --git a/AvoidTimeComsume/entry/src/main/ets/views/UseTaskPool.ets b/AvoidTimeComsume/entry/src/main/ets/views/UseTaskPool.ets
index cd2ecf9fa7bb45f021a9c2d7816070b1b016dd13..650c4ddec72f633a818605da180ea106ef13ef78 100644
--- a/AvoidTimeComsume/entry/src/main/ets/views/UseTaskPool.ets
+++ b/AvoidTimeComsume/entry/src/main/ets/views/UseTaskPool.ets
@@ -16,6 +16,8 @@
import { buffer, taskpool } from '@kit.ArkTS';
import { Item, ResponseData, dataToItem } from '../common/Item';
import { WaterFlowDataSource } from './WaterFlowDataSource';
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { BusinessError } from '@kit.BasicServicesKit';
@Entry
@Component
@@ -23,7 +25,7 @@ struct WaterFlowExample {
@State fontSize: number = 24;
scroller: Scroller = new Scroller();
dataSource: WaterFlowDataSource = new WaterFlowDataSource();
- UIContext = this.getUIContext()
+ UIContext: UIContext = this.getUIContext()
@Builder
itemFoot() {
@@ -123,18 +125,31 @@ struct WaterFlowExample {
// The following methods are defined outside of the component
async function taskPoolExecute(UIContext: UIContext): Promise-
+#include