diff --git a/Ability/PagesRouter/README.md b/Ability/PagesRouter/README.md index 41cd41f15bd9e8bd5c9363796e7dad4342557b8f..545978236b792937f4aa064e1dcbfc3cd107a94c 100644 --- a/Ability/PagesRouter/README.md +++ b/Ability/PagesRouter/README.md @@ -1,9 +1,7 @@ -# Ability内页面间的跳转（ArkTS） +# UIAbility内页面间的跳转（ArkTS） ## 介绍 -本篇Codelab基于Stage模型下的Ability开发，实现Ability内页面间的跳转和数据传递。 - -最终效果图如下： +本篇Codelab基于Stage模型下的UIAbility开发，实现UIAbility内页面间的跳转和数据传递。最终效果图如图所示： ![](figures/pageRouter.gif) @@ -15,7 +13,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -42,7 +40,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 @@ -154,6 +152,6 @@ Button($r('app.string.back')) 您已经完成了本次Codelab的学习，并了解到以下知识点： -1. 使用页面路由实现应用内页面跳转。 +1. 使用页面路由实现UIAbility内页面间的跳转。 ![](figures/summarize.gif) \ No newline at end of file diff --git a/Ability/StageAbility/README.md b/Ability/StageAbility/README.md index 86141caf25902f11e46c271f094796e1f6dfb801..2cb6407a6b3dc32618c7dc2e281bc6e960e5c355 100644 --- a/Ability/StageAbility/README.md +++ b/Ability/StageAbility/README.md @@ -17,7 +17,6 @@ - [UIAbility组件概述](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/application-models/uiability-overview.md)：UIAbility组件是一种包含UI界面的应用组件，主要用于和用户交互。UIAbility组件是系统调度的基本单元，为应用提供绘制界面的窗口。一个应用可以包含一个或多个UIAbility组件。 - [UIAbilityContext](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md)：UIAbilityContext是[UIAbility](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md)的上下文环境，继承自[Context](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-inner-application-context.md)，提供UIAbility的相关配置信息以及操作UIAbility和ServiceExtensionAbility的方法。 - [页面路由](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-router.md)：提供通过不同的url访问不同的页面，包括跳转到应用内的指定页面、用应用内的某个页面替换当前页面、返回上一页面或指定的页面等。 - - [Text](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-text.md)：文本组件，用于呈现一段文本信息。 - [Button](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-button.md)：按钮组件，可快速创建不同样式的按钮。 @@ -25,7 +24,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -54,7 +53,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──device/src/main/ets // device模块的代码区 diff --git a/Ability/StageAbilityDemo/README.md b/Ability/StageAbilityDemo/README.md index b1d4ac2a116340983267f4460fcd7770633cc99c..ba3133b0c27cdf4368ea43050e39276982ef9271 100644 --- a/Ability/StageAbilityDemo/README.md +++ b/Ability/StageAbilityDemo/README.md @@ -8,7 +8,6 @@ ### 相关概念 - [UIAbility](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-uiAbility.md)：UIAbility组件是系统调度的基本单元，为应用提供绘制界面的窗口；一个UIAbility组件中可以通过多个页面来实现一个功能模块。每一个UIAbility组件实例，都对应于一个最近任务列表中的任务。 - - [UIAbilityContext](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-inner-application-uiAbilityContext.md)：UIAbilityContext是UIAbility的上下文环境，继承自Context，提供UIAbility的相关配置信息以及操作UIAbility和ServiceExtensionAbility的方法，如启动UIAbility，停止当前UIAbilityContext所属的UIAbility，启动、停止、连接、断开连接ServiceExtensionAbility等。 - [Want](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-app-ability-want.md)：Want是对象间信息传递的载体, 可以用于应用组件间的信息传递。 Want的使用场景之一是作为startAbility的参数, 其包含了指定的启动目标, 以及启动时需携带的相关数据。 - [HiLog](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-hilog.md)：HiLog日志系统，让应用可以按照指定类型、指定级别、指定格式字符串输出日志内容，帮助开发者了解应用的运行状态，更好地调试程序。 @@ -17,7 +16,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -44,7 +43,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 │ ├──common // 公共资源目录 diff --git a/Data/FirstStartDemo/README.md b/Data/FirstStartDemo/README.md index 04b3a6ed4310329aa9ed7130f142045dd958252f..897bbc290a642ef790a164a6065d06aaffd00e5a 100644 --- a/Data/FirstStartDemo/README.md +++ b/Data/FirstStartDemo/README.md @@ -8,16 +8,12 @@ 3. 实现自定义隐私协议弹窗，点击协议可查看隐私协议具体内容。 4. 隐私协议状态持久化存储，再次启动时，如果没有保存状态会再次弹出，否则不弹出。 -效果如图所示： - ![](figures/FirstStartDemo.gif) ### 相关概念 - [首选项](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-data-preferences.md) ：首选项为应用提供Key-Value键值型的数据处理能力，支持应用持久化轻量级数据，并对其修改和查询。数据存储形式为键值对，键的类型为字符串型，值的存储数据类型包括数字型、字符型、布尔型以及这3种类型的数组类型。 - - [自定义弹窗](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-methods-custom-dialog-box.md) ： 通过CustomDialogController类显示自定义弹窗。 - - [页面路由](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-router.md) ：提供通过不同的url访问不同的页面，包括跳转到应用内的指定页面、用应用内的某个页面替换当前页面、返回上一页面或指定的页面等。 @@ -25,7 +21,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87) 版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87) 版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -54,7 +50,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/Data/Preferences/README.md b/Data/Preferences/README.md index f477ab20064316d6dda5c4e33b126f319a88c09a..c37ba8c06fc7267d026585004e1cb675c0044386 100644 --- a/Data/Preferences/README.md +++ b/Data/Preferences/README.md @@ -9,8 +9,6 @@ 3. 读取首选项数据库中的数据。 4. 删除首选项数据文件。 -最终效果图如下： - ![](figures/zh-cn_image_0000001459130725.gif) ### 相关概念 @@ -23,7 +21,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -52,7 +50,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/Data/Rdb/README.md b/Data/Rdb/README.md index daac82284a7a356391a8f43e8ae78254ee296034..ccf77a19bbd958b03fc740e4f55c97e4203d6acc 100644 --- a/Data/Rdb/README.md +++ b/Data/Rdb/README.md @@ -14,7 +14,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -41,7 +41,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/Data/SetAppFontSize/README.md b/Data/SetAppFontSize/README.md index c6f270697882f6b879b772ecf235515a2868985d..e4e7b3d1f268fd1dfc0f2708af82b3fb1efc7a54 100644 --- a/Data/SetAppFontSize/README.md +++ b/Data/SetAppFontSize/README.md @@ -18,7 +18,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -45,7 +45,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ETSUI/AnimateRefresh/README.md b/ETSUI/AnimateRefresh/README.md index a09734fe62e4d1137212a2e6aac07810962a2a74..ee56091d9282ccad717a61797188faab67b41ffc 100644 --- a/ETSUI/AnimateRefresh/README.md +++ b/ETSUI/AnimateRefresh/README.md @@ -17,7 +17,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -46,7 +46,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ETSUI/Animation/README.md b/ETSUI/Animation/README.md index ceef7d3be48be78e1b8fb254be965c7ec3021cd5..263108b9dd0a59d4ec0923475eb309d6142bf17b 100644 --- a/ETSUI/Animation/README.md +++ b/ETSUI/Animation/README.md @@ -8,17 +8,15 @@ ### 相关概念 -- [显式动画](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md)：提供全局animateTo显式动画接口来指定有闭包代码导致的状态变化插入过渡动画效果。 - -- [属性动画](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-animatorproperty.md)：组件的通用属性发生变化时，可以创建属性动画进行渐变，提升用户体验。 - -- [Slider](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-slider.md)：滑动条组件，用来快速调节设置值，如音量、亮度等。 +- [显式动画](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md)：提供全局animateTo显式动画接口来指定有闭包代码导致的状态变化插入过渡动画效果。 +- [属性动画](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-animatorproperty.md)：组件的通用属性发生变化时，可以创建属性动画进行渐变，提升用户体验。 +- [Slider](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-slider.md)：滑动条组件，用来快速调节设置值，如音量、亮度等。 ## 环境搭建 ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -46,7 +44,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ETSUI/ArkTSComponents/README.md b/ETSUI/ArkTSComponents/README.md index db2ed4b82ba91bf2a4161b71425391be5af001ea..c59c0e4eef90f083003e6eaa348769cc4217ff7a 100644 --- a/ETSUI/ArkTSComponents/README.md +++ b/ETSUI/ArkTSComponents/README.md @@ -26,7 +26,7 @@ HarmonyOS ArkUI提供了丰富多样的UI组件，您可以使用这些组件轻 ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -55,7 +55,7 @@ HarmonyOS ArkUI提供了丰富多样的UI组件，您可以使用这些组件轻 ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在附件下载和gitee源码中提供下载方式。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ETSUI/List/README.md b/ETSUI/List/README.md index ab3518f872f58ffe789d1c0c1c4626fe3a4f7fa7..b9f8125f5db6c62d46f578b83687193ff587dd8a 100644 --- a/ETSUI/List/README.md +++ b/ETSUI/List/README.md @@ -17,7 +17,7 @@ OpenHarmony ArkTS提供了丰富的接口和组件，开发者可以根据实际 ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -44,7 +44,7 @@ OpenHarmony ArkTS提供了丰富的接口和组件，开发者可以根据实际 ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ETSUI/List_HDC/README.md b/ETSUI/List_HDC/README.md index 4ca23553d896c2b3e1fa95e83fd907cf40af9935..ffdc6b817cad0621210915487720acebaf0dab68 100644 --- a/ETSUI/List_HDC/README.md +++ b/ETSUI/List_HDC/README.md @@ -19,7 +19,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -46,7 +46,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ETSUI/OHLayoutAlign/README.md b/ETSUI/OHLayoutAlign/README.md index e2308c7c8cb05f08aee6667653ce66c9f3eba617..43b43c2389a9f5276ab4f94643ddf6176e523a6b 100644 --- a/ETSUI/OHLayoutAlign/README.md +++ b/ETSUI/OHLayoutAlign/README.md @@ -4,8 +4,6 @@ 基于ArkTS扩展的声明式开发范式，实现Flex、Column、Row和Stack四种常用布局容器对齐方式。 -效果图如下： - ![](figures/zh-cn_image_0000001409408710.gif) ### 相关概念 @@ -21,7 +19,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -50,7 +48,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ETSUI/RankingDemo/README.md b/ETSUI/RankingDemo/README.md index 371cbd6912c596e477531548e6997a19da86e826..17375f1cf8811e89c82622404fbaa1d92c259ad5 100644 --- a/ETSUI/RankingDemo/README.md +++ b/ETSUI/RankingDemo/README.md @@ -54,7 +54,7 @@ ForEach( ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -79,7 +79,8 @@ ForEach( 2. 开发环境配置完成后，请参考[使用工程向导](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-with-ets-stage.md#创建ets工程)创建工程（模板选择“Empty Ability”）。 3. 工程创建完成后，选择使用[真机进行调测](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-with-ets-stage.md#使用真机运行应用)。 ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 + ``` ├──entry/src/main/ets // 代码区 │ ├──common // 公共文件目录 diff --git a/ETSUI/SliderExample/README.md b/ETSUI/SliderExample/README.md index f8c3c5b44439caf1cae8f394ea5f68c4a4e813ba..a430d2252a048bec1b136a473aa65cc3b60ed9ff 100644 --- a/ETSUI/SliderExample/README.md +++ b/ETSUI/SliderExample/README.md @@ -16,7 +16,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -41,7 +41,8 @@ 2. 开发环境配置完成后，请参考[使用工程向导](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-with-ets-stage.md#创建ets工程)创建工程（模板选择“Empty Ability”）。 3. 工程创建完成后，选择使用[真机进行调测](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-with-ets-stage.md#使用真机运行应用)。 ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 + ``` ├──entry/src/main/ets // 代码区 │ ├──common diff --git a/ETSUI/TransitionAnimation/README.md b/ETSUI/TransitionAnimation/README.md index 54915a5024d36a7bf9e3f2b4ed9bbec376e9cc4b..cb4a5f22b7721491f57012a882619732b83d71c6 100644 --- a/ETSUI/TransitionAnimation/README.md +++ b/ETSUI/TransitionAnimation/README.md @@ -12,16 +12,14 @@ ### 相关概念 - [页面间转场](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md)：页面转场通过在全局pageTransition方法内配置页面入场组件和页面退场组件来自定义页面转场动效。 - - [组件内转场](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md)：组件转场主要通过transition属性进行配置转场参数，在组件插入和删除时进行过渡动效，主要用于容器组件子组件插入删除时提升用户体验（需要配合animateTo才能生效，动效时长、曲线、延时跟随animateTo中的配置）。 - - [共享元素转场](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md)：通过修改共享元素的sharedTransition属性设置元素在不同页面之间过渡动效。例如，如果两个页面使用相同的图片（但位置和大小不同），图片就会在这两个页面之间流畅地平移和缩放。 ## 环境搭建 ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -50,7 +48,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ETSUI/WebComponent/README.md b/ETSUI/WebComponent/README.md index 374498b80202b595da01b7f31cee773da4b94162..1f48688d665d1a1845dc7c1a8065d016f6aeee76 100644 --- a/ETSUI/WebComponent/README.md +++ b/ETSUI/WebComponent/README.md @@ -14,7 +14,6 @@ ### 相关概念 - [Web](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md)：提供具有网页显示能力的Web组件。 - - [runJavaScript](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md#runjavascript)：异步执行JavaScript脚本，并通过回调方式返回脚本执行的结果。 ### 相关权限 @@ -38,7 +37,7 @@ ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -65,6 +64,8 @@ ## 代码结构解读 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 + ``` ├──entry/src/main/ets // 代码区 │ ├──common diff --git a/ETSUI/WebCookie/README.md b/ETSUI/WebCookie/README.md index d77d91778336b5f40874b91705f80fdd53ccd77d..20cb02d6f28d607628abc2bb298aa12e7ecb5b2f 100644 --- a/ETSUI/WebCookie/README.md +++ b/ETSUI/WebCookie/README.md @@ -1,6 +1,6 @@ # Web组件的使用（ArkTS） -# 介绍 +# 介绍 本篇Codelab使用ArkTS语言实现一个简单的免登录过程，向大家介绍基本的cookie管理操作。主要包含以下功能： @@ -11,7 +11,7 @@ ![](figures/Web.gif) -## 原理说明 +## 原理说明 本应用旨在说明Web组件中cookie的管理操作。结合应用弹框和免登录两种方式进行讲解。 @@ -28,12 +28,12 @@ ![](figures/process.png) -## 相关概念 +## 相关概念 - [Web](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md)：提供网页显示能力的组件。 - [WebCookie](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md#webcookie)：WebCookie可以控制Web组件中的cookie的各种行为，其中每个应用中的所有Web组件共享一个WebCookie。通过controller方法中的getCookieManager方法可以获取WebCookie对象，进行后续的cookie管理操作。 -## 相关权限 +## 相关权限 本篇Codelab使用的是在线网页，需添加网络权限：ohos.permission.INTERNET。在配置文件module.json5中添加对应信息： @@ -51,19 +51,19 @@ } ``` -# 环境搭建 +# 环境搭建 -## 软件要求 +## 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 -## 硬件要求 +## 硬件要求 - 开发板类型：[润和RK3568开发板](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-appendix-rk3568.md)。 - OpenHarmony系统：3.2 Release及以上版本。 -## 环境搭建 +## 环境搭建 完成本篇Codelab我们首先要完成开发环境的搭建，本示例以**RK3568**开发板为例，参照以下步骤进行： @@ -82,9 +82,9 @@ 2. 开发环境配置完成后，请参考[使用工程向导](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-with-ets-stage.md#创建ets工程)创建工程（模板选择“Empty Ability”）。 3. 工程创建完成后，选择使用[真机进行调测](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-with-ets-stage.md#使用真机运行应用)。 -# 代码结构解读 +# 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 @@ -104,12 +104,9 @@ └──entry/src/main/resources // 应用资源目录 ``` -# 实现步骤 +# 实现步骤 -- [应用首页](#section9665192317430) -- [免登录验证页](#section194311353144311) - -## 应用首页 +## 应用首页 首次打开应用时，应用首页的Web组件内呈现的是登录界面。用户完成登录操作后，会跳转至账号中心界面。在用户不点击“删除cookies”按钮的情况下，用户关闭并再次打开应用，首页仍会跳转至账号中心界面。Web组件会自动存储所加载界面的cookie信息，包括登录的cookie信息。用户可以通过点击“删除cookies”按钮，清除所有cookie信息。首页呈现效果如图： @@ -195,7 +192,7 @@ operationMethod() { } ``` -## 免登录验证页 +## 免登录验证页 当用户在应用内已完成登录操作，在应用的其他位置使用Web组件访问需要相同授权的页面时，可免去多余的登录操作。一个应用中的所有Web组件共享一个WebCookie，因此一个应用中Web组件存储的cookie信息，也是可以共享的。界面呈现效果如图： diff --git a/EfficiencyEnhancementKit/SuperVisualSample/README.md b/EfficiencyEnhancementKit/SuperVisualSample/README.md index 1fc6a14a76b5cb7502bbfb4c49d428a15821eb93..9cb646dec4f6f8209936133c65ff1fcb47de5a09 100644 --- a/EfficiencyEnhancementKit/SuperVisualSample/README.md +++ b/EfficiencyEnhancementKit/SuperVisualSample/README.md @@ -17,16 +17,14 @@ 低代码开发方式具有丰富的UI界面编辑功能，通过可视化界面开发方式快速构建布局，可有效降低开发者的上手成本并提升开发者构建UI界面的效率。 - [List](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md)：List 是很常用的滚动类容器组件之一，它按照水平或者竖直方向线性排列子组件， List 的子组件必须是 ListItem ，它的宽度默认充满 List 的宽度。 - - [循环渲染](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/arkts-rendering-control-foreach.md)：开发框架提供循环渲染（ForEach组件）来迭代数组，并为每个数组项创建相应的组件。 - - [警告弹窗](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-methods-alert-dialog-box.md)：显示警告弹窗组件，可设置文本内容与响应回调。 ## 环境搭建 ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -53,6 +51,8 @@ ## 代码结构解读 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 + ``` └──entry/src/main/ets // 代码区 │ ├──common diff --git a/ExcellentCase/Healthy_life/README.md b/ExcellentCase/Healthy_life/README.md index 8a3522089048a550c5140054165b87b1cb8eb19a..d6ed1570772d9d0b83e19d6134a5e0e9de0b9946 100644 --- a/ExcellentCase/Healthy_life/README.md +++ b/ExcellentCase/Healthy_life/README.md @@ -6,40 +6,29 @@ 1. 用户可以创建最多6个健康生活任务（早起，喝水，吃苹果，每日微笑，刷牙，早睡），并设置任务目标、是否开启提醒、提醒时间、每周任务频率。 2. 用户可以在主页面对设置的健康生活任务进行打卡，其中早起、每日微笑、刷牙和早睡只需打卡一次即可完成任务，喝水、吃苹果需要根据任务目标量多次打卡完成。 - 3. 主页可显示当天的健康生活任务完成进度，当天所有任务都打卡完成后，进度为100%，并且用户的连续打卡天数加一。 - 4. 当用户连续打卡天数达到3、7、30、50、73、99天时，可以获得相应的成就。成就在获得时会以动画形式弹出，并可以在“成就”页面查看。 - 5. 用户可以查看以前的健康生活任务完成情况。 本应用的运行效果如下图所示： - ![](figures/健康生活.gif) ### 相关概念 -- [@AppStorage](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/arkts-appstorage.md)：应用程序中的单例对象，为应用程序范围内的可变状态属性提供中央存储。 - -- [@Observed 和 @ObjectLink](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/arkts-observed-and-objectlink.md)：@Observed适用于类，表示类中的数据变化由UI页面管理；@ObjectLink应用于被@Observed装饰类的对象。 - -- [@Consume 和 @Provide](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/arkts-provide-and-consume.md)：@Provide作为数据提供者，可以更新子节点的数据，触发页面渲染。@Consume检测到@Provide数据更新后，会发起当前视图的重新渲染。 - -- [Flex](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md)：一个功能强大的容器组件，支持横向布局，竖向布局，子组件均分和流式换行布局。 - -- [List](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md)：List是很常用的滚动类容器组件之一，它按照水平或者竖直方向线性排列子组件， List的子组件必须是ListItem，它的宽度默认充满List的宽度。 - -- [TimePicker](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-timepicker.md)：TimePicker是选择时间的滑动选择器组件，默认以00:00至23:59的时间区创建滑动选择器。 - -- [Toggle](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-toggle.md)：组件提供勾选框样式、状态按钮样式及开关样式。 - -- [关系型数据库（Relational Database，RDB）](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md)：一种基于关系模型来管理数据的数据库。 +- [@AppStorage](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/arkts-appstorage.md)：应用程序中的单例对象，为应用程序范围内的可变状态属性提供中央存储。 +- [@Observed 和 @ObjectLink](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/arkts-observed-and-objectlink.md)：@Observed适用于类，表示类中的数据变化由UI页面管理；@ObjectLink应用于被@Observed装饰类的对象。 +- [@Consume 和 @Provide](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/arkts-provide-and-consume.md)：@Provide作为数据提供者，可以更新子节点的数据，触发页面渲染。@Consume检测到@Provide数据更新后，会发起当前视图的重新渲染。 +- [Flex](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md)：一个功能强大的容器组件，支持横向布局，竖向布局，子组件均分和流式换行布局。 +- [List](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md)：List是很常用的滚动类容器组件之一，它按照水平或者竖直方向线性排列子组件， List的子组件必须是ListItem，它的宽度默认充满List的宽度。 +- [TimePicker](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-timepicker.md)：TimePicker是选择时间的滑动选择器组件，默认以00:00至23:59的时间区创建滑动选择器。 +- [Toggle](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-toggle.md)：组件提供勾选框样式、状态按钮样式及开关样式。 +- [关系型数据库（Relational Database，RDB）](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/apis/js-apis-data-rdb.md)：一种基于关系模型来管理数据的数据库。 ## 环境搭建 ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -66,7 +55,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 @@ -1701,15 +1690,10 @@ public emit(event, args?: any[]) { 您已经完成了本次Codelab的学习，并了解到以下知识点： 1. ArkUI基础组件、容器组件的使用。 - 2. 使用页面路由跳转到指定页面并传递所需参数。 - 3. 基于基础组件封装自定义组件，如日历、弹窗等。 - 4. 数据驱动UI组件刷新。 - 5. 使用首选项接口实现应用权限管理。 - 6. 使用关系型数据库读写关系型数据。 ![](figures/彩带动效.gif) diff --git a/NetworkManagement/NewsDataArkTS/README.md b/NetworkManagement/NewsDataArkTS/README.md index 311f079fece57742048379edfc4aa9f0d0df168f..599952e7aa004b3786ea7e4f00d133b79ebca45a 100644 --- a/NetworkManagement/NewsDataArkTS/README.md +++ b/NetworkManagement/NewsDataArkTS/README.md @@ -20,13 +20,27 @@ ### 相关权限 -网络数据请求需要权限：ohos.permission.INTERNET +本Codelab使用了网络数据请求，需要在配置文件module.json5文件里添加网络权限：ohos.permission.INTERNET。 + +```typescript +{ + "module": { + "name": "entry", + ... + "requestPermissions": [ + { + "name": "ohos.permission.INTERNET" + } + ] + } +} +``` ## 环境搭建 ### 软件要求 -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 ### 硬件要求 @@ -53,7 +67,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 diff --git a/ThirdPartyComponents/ThirdPartyLibrary/README.md b/ThirdPartyComponents/ThirdPartyLibrary/README.md index a1665257a9e0037c7f4141538baea30d9b503e0c..d279b97db0d55f006e593de1142cd19e6e59c7b0 100644 --- a/ThirdPartyComponents/ThirdPartyLibrary/README.md +++ b/ThirdPartyComponents/ThirdPartyLibrary/README.md @@ -8,27 +8,24 @@ ### 相关概念 -- [Navigation](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md)：一般作为Page页面的根容器，通过属性设置来展示页面的标题、工具栏、菜单。 +- [Navigation](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md)：一般作为Page页面的根容器，通过属性设置来展示页面的标题、工具栏、菜单。 +- [Tabs](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md)：一种可以通过页签进行内容视图切换的容器组件，每个页签对应一个内容视图。 +- [Canvas](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-canvas.md)：画布组件，用于自定义绘制图形。 +- [OpenHarmony 共享包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_npm_usage.md)：OpenHarmony 共享包定义了特定的工程结构和配置文件，支持OpenHarmony页面组件相关API、资源的调用。 -- [Tabs](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md)：一种可以通过页签进行内容视图切换的容器组件，每个页签对应一个内容视图。 +# 环境搭建 -- [Canvas](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/reference/arkui-ts/ts-components-canvas-canvas.md)：画布组件，用于自定义绘制图形。 +## 软件要求 -- [OpenHarmony 共享包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_npm_usage.md)：OpenHarmony 共享包定义了特定的工程结构和配置文件，支持OpenHarmony页面组件相关API、资源的调用。 - -# 环境搭建 - -## 软件要求 - -- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Beta2及以上版本。 +- [DevEco Studio](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/start-overview.md#%E5%B7%A5%E5%85%B7%E5%87%86%E5%A4%87)版本：DevEco Studio 3.1 Release及以上版本。 - OpenHarmony SDK版本：API version 9及以上版本。 -## 硬件要求 +## 硬件要求 - 开发板类型：[润和RK3568开发板](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/quick-start/quickstart-appendix-rk3568.md)。 - OpenHarmony系统：3.2 Release及以上版本。 -## 环境搭建 +## 环境搭建 完成本篇Codelab我们首先要完成开发环境的搭建，本示例以**RK3568**开发板为例，参照以下步骤进行： @@ -47,7 +44,7 @@ ## 代码结构解读 -本篇Codelab只对核心代码进行讲解，完整代码可以直接从gitee获取。 +本篇Codelab只对核心代码进行讲解，对于完整代码，我们会在gitee中提供。 ``` ├──entry/src/main/ets // 代码区 @@ -77,11 +74,11 @@ └──Buttons.ets // 本地库代码实现 ``` -# 整体框架搭建 +# 整体框架搭建 本篇Codelab由主页面、本地库组件页面、社区库组件页面三个页面组成，主页面由Navigation作为根组件实现全局标题，由Tabs组件实现本地库和社区库页面的切换，代码如下： -``` +```typescript import { Outer } from '../view/OuterComponent'; import { Inner } from '../view/InnerComponent'; import { CommonConstants } from '../common/constants/CommonConst'; @@ -123,7 +120,7 @@ struct Index { 在pages文件夹下新建components文件并在此文件夹下创建两个ArkTS文件，分别命名为inner和outer，至此整体框架搭建完毕。 -# 本地库实现 +# 本地库实现 本地库主要是指未上架到ohpm中心且在项目组内共享使用的库文件，这类库需要开发者在项目中创建并开发新的Library模块，创建步骤如下： @@ -142,7 +139,7 @@ struct Index { 本Codelab在本地库中实现了对Button组件的简单封装，主要代码实现如下： -``` +```typescript @Component export struct Buttons { @Prop buttonText: string; @@ -178,13 +175,13 @@ export struct Buttons { 方式一：在Terminal窗口中，执行如下命令进行安装，并会在package.json中自动添加依赖。 -``` +```typescript ohpm install ../library --save ``` 方式二：在工程的oh\_package.json5中设置OpenHarmony ohpm三方包依赖，配置示例如下： -``` +```typescript "dependencies": { "@ohos/library": "file:../library" } @@ -192,13 +189,13 @@ ohpm install ../library --save 依赖设置完成后，需要执行ohpm install命令安装依赖包，依赖包会存储在工程的oh\_modules目录下。 -``` +```typescript ohpm install ``` 在完成上述步骤后，我们继续完成inner页面的开发，在inner页面中我们通过import的方式引入开发的本地库，并通过循环传入不同的参数展示不同的button，代码实现如下： -``` +```typescript import { Buttons } from '@ohos/library'; import { BUTTON_LIST, SPACE_12, FONT_WEIGHT_400, OPACITY_6, ASPECT_RATIO_175 } from '../../common/Const'; @@ -275,7 +272,7 @@ export struct Inner { -# 社区库调用 +# 社区库调用 社区库是指已经由贡献者上架到ohpm中心供其他开发者下载使用的库，调用这类库的方法如下： @@ -283,13 +280,13 @@ export struct Inner { - 方式一：在Terminal窗口中，执行如下命令安装OpenHarmony ohpm三方包，DevEco Studio会自动在工程的oh\_package.json中自动添加三方包依赖。 - ``` + ```typescript ohpm install @ohos/lottie --save ``` - 方式二：在工程的oh\_package.json5中设置OpenHarmony ohpm三方包依赖，配置示例如下： - ``` + ```typescript "dependencies": { "@ohos/lottie": "^2.0.0" } @@ -297,14 +294,14 @@ export struct Inner { 依赖设置完成后，需要执行ohpm install命令安装依赖包，依赖包会存储在工程的oh\_modules目录下。 - ``` + ```typescript ohpm install ``` 在完成上述步骤后，我们继续完成outer页面的开发，在outer页面中我们通过import的方式引入配置的社区库，并实现对社区库动画的调用，关键代码如下： -``` +```typescript import lottie from '@ohos/lottie'; import { Logger } from '../common/utils/log/logger'; import { CommonConstants } from '../common/constants/CommonConst';