From 9f788af875bc7dd5253d97a7f9a2a828cf669df7 Mon Sep 17 00:00:00 2001 From: z00797030 Date: Sat, 15 Jul 2023 16:25:04 +0800 Subject: [PATCH 1/5] =?UTF-8?q?readme=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: z00797030 --- README.md | 68 ++++++++++++++++++++++++++++++------------------------- 1 file changed, 37 insertions(+), 31 deletions(-) diff --git a/README.md b/README.md index 750df00..0708af1 100644 --- a/README.md +++ b/README.md @@ -1,77 +1,83 @@ # CalendarData -## 1. Introduction +## Introduction -The calendardata application is a preset application in OpenHarmony that provides the function of adding, deleting, modifying, and checking the schedule +CalendarData is a preset application in OpenHarmony. It allows users to add, delete, modify, and query calendars. -## 2. Directory Structure +## Directory Structure ``` ├─AppScope │ │ -│ └─resources # resource file +│ └─resources # Resource files ├─common │ │ │ └─src │ └─main -│ └─ets # basic methods +│ └─ets # Common methods ├─datamanager │ └─src │ └─main -│ └─ets # data manager +│ └─ets # Data manager ├─dataprovider │ └─src │ └─main -│ └─ets # the proxy of data manager +│ └─ets # Data manager proxy ├─datastructure │ └─src │ └─main -│ └─ets # data structure +│ └─ets # Data structure ├─entry │ └─src -│ └─main # the entry of project +│ └─main # Application entry ├─rrule │ └─src │ └─main -│ └─ets # recurrence rule -└─signature # certificate file +│ └─ets # Recurrence rule +└─signature # Certificate file ``` -### Architecture +## Architecture ![](./figures/architecture.png) - **product** - Business form layer: Distinguish various forms of applications for different products and screens, including personalized business, component configuration, and personalized resource packages。 + + Business form layer: distinguishes applications for different products and screens, including personalized services, component configurations, and personalized resource packages. - **feature** - Common feature layer: An abstract collection of common feature components that can be referenced by various application forms。 + + Common feature layer: abstract collection of common feature components, which can be referenced by various application forms. - **common** - Common capability layer: Basic capability set, modules that each application form must rely on, including tool classes and common resource packages。 + + Common capability layer: basic capability set, which is a module that each application form must depend on, including utility classes and common resource packages. +## Packing -## 3. Packaging - -Open project engineering by DevEco Studio, choose: Build → Build Haps(s)/APP(s) → Build Hap(s) +Open a project in DevEco Studio and choose **Build > Build Haps(s)/APP(s) > Build Hap(s)**. ![](./figures/build_haps.png) -After compilation, the HAP package will be generated in the `\build\outputs` path in the project directory (if no signature is configured, only unsigned HAP packages will be generated) +After the build is complete, a HAP file is generated in **\build\outputs** in the project directory. (If no signature is configured, an unsigned HAP file is generated.) ![](./figures/build_output_dir_release.png) -### Install +## Installation -Install the compiled hap package using the command: hdc_std install "HAP packet address" +Run the **hdc_std install "*hap package address*"** command to install the compiled HAP file. ![](./figures/calendar_install.png) -## Constraint -- Development Environment - - **DevEco Studio for OpenHarmony**: Version number greater than 3.1.1.101, Download and Install OpenHarmony SDK API Version 10(The initial IDE configuration can refer to the IDE usage documentation) -- Language - - ArkTS -- Limitation - - This example only supports running on standard systems - - - +## Constraints +- Development environments + + - DevEco Studio for OpenHarmony: version later than 3.1.1.101 + + - OpenHarmony SDK: API version 10 + + For details about the initial DevEco Studio configuration, see the DevEco Studio usage document. +- Programming language + + ArkTS +- Limitations + + This application can only be run on standard-system devices. -- Gitee From bed343c95807e794005997b8c8f864ce266da6a4 Mon Sep 17 00:00:00 2001 From: z00797030 Date: Sat, 15 Jul 2023 17:33:12 +0800 Subject: [PATCH 2/5] =?UTF-8?q?readme=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: z00797030 --- README_zh.md | 25 ++++++++----------------- 1 file changed, 8 insertions(+), 17 deletions(-) diff --git a/README_zh.md b/README_zh.md index 0ba3b1b..8140b6f 100644 --- a/README_zh.md +++ b/README_zh.md @@ -1,10 +1,10 @@ # 日历存储应用 -## 1. 项目介绍 +## 项目介绍 -日历存储应用是OpenHarmony中预置的应用，提供日程的增删改查功能 +日历存储应用是OpenHarmony中预置的应用，提供日程的增删改查功能。 -## 2. 目录结构 +## 目录结构 ``` ├─AppScope │ │ @@ -40,28 +40,19 @@ ![](./figures/architecture.png) -- **product** - 业务形态层：区分不同产品、不同屏幕的各形态应用，含有个性化业务，组件的配置，以及个性化资源包。 - -- **feature** - 公共特性层：抽象的公共特性组件集合，可以被各应用形态引用。 - -- **common** - 公共能力层：基础能力集，每个应用形态都必须依赖的模块，包含工具类和通用的资源包 +对外提供免SQL的对象化API，供日历、三方应用实现日历账户、日程数据的增删改查功能，以及提醒管理功能 -## 3. 打包 +## 使用说明 -在DevEco Studio打开项目工程，选择Build → Build Haps(s)/APP(s) → Build Hap(s) +在DevEco Studio打开项目工程，选择Build → Build Haps(s)/APP(s) → Build Hap(s)。 ![](./figures/build_haps.png) -编译完成后，hap包会生成在工程目录下的 `\build\outputs`路径下（如果没有配置签名，则只会生成未签名的hap包） +编译完成后，hap包会生成在工程目录下的 `\build\outputs`路径下。（如果没有配置签名，则只会生成未签名的hap包） ![](./figures/build_output_dir_release.png) -### 安装 - -使用hdc_std install "hap包地址" 命令进行安装编译后的hap包 +使用hdc_std install "hap包地址" 命令进行安装编译后的hap包。 ![](./figures/calendar_install.png) -- Gitee From 282d2a7d7c555af9f6ddcf641ec0bd2ca8bfea74 Mon Sep 17 00:00:00 2001 From: z00797030 Date: Sat, 15 Jul 2023 17:38:46 +0800 Subject: [PATCH 3/5] =?UTF-8?q?readme=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: z00797030 --- README_zh.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_zh.md b/README_zh.md index 8140b6f..5307c74 100644 --- a/README_zh.md +++ b/README_zh.md @@ -40,7 +40,7 @@ ![](./figures/architecture.png) -对外提供免SQL的对象化API，供日历、三方应用实现日历账户、日程数据的增删改查功能，以及提醒管理功能 +对外提供免SQL的对象化API，供日历、三方应用实现日历账户、日程数据的增删改查功能，以及提醒管理功能。 ## 使用说明 -- Gitee From 2369f59c280eb674885189a0c2e285e9cc23ff2b Mon Sep 17 00:00:00 2001 From: z00797030 Date: Mon, 17 Jul 2023 14:28:58 +0800 Subject: [PATCH 4/5] =?UTF-8?q?readme=20=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: z00797030 --- README_zh.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README_zh.md b/README_zh.md index 5307c74..2b4796f 100644 --- a/README_zh.md +++ b/README_zh.md @@ -40,7 +40,7 @@ ![](./figures/architecture.png) -对外提供免SQL的对象化API，供日历、三方应用实现日历账户、日程数据的增删改查功能，以及提醒管理功能。 +Calendar作为内建基础应用，实现日月视图查看、日程创建查看等与用户交互相关的基础操作；Calendar API提供免SQL的对象化数据读写访问能力；CalendarData负责日程管理、提醒管理以及数据管理等功能。 ## 使用说明 -- Gitee From 910c7a8a69b206474e6250f924dfbe5a2a4ca878 Mon Sep 17 00:00:00 2001 From: z00797030 Date: Mon, 17 Jul 2023 16:48:47 +0800 Subject: [PATCH 5/5] =?UTF-8?q?readme=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: z00797030 --- README.md | 26 ++++++++------------------ 1 file changed, 8 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 0708af1..493df21 100644 --- a/README.md +++ b/README.md @@ -36,22 +36,13 @@ CalendarData is a preset application in OpenHarmony. It allows users to add, del └─signature # Certificate file ``` -## Architecture +### Architecture ![](./figures/architecture.png) -- **product** - - Business form layer: distinguishes applications for different products and screens, including personalized services, component configurations, and personalized resource packages. +As a built-in basic application, Calendar implements basic user operations such as querying daily and monthly views and creating and querying calendars. The Calendar APIs provide SQL-free, object-based data read and write capabilities. CalendarData manages calendars, reminders, and data. -- **feature** - - Common feature layer: abstract collection of common feature components, which can be referenced by various application forms. - -- **common** - - Common capability layer: basic capability set, which is a module that each application form must depend on, including utility classes and common resource packages. -## Packing +## How to Use Open a project in DevEco Studio and choose **Build > Build Haps(s)/APP(s) > Build Hap(s)**. @@ -61,23 +52,22 @@ After the build is complete, a HAP file is generated in **\build\outputs** in th ![](./figures/build_output_dir_release.png) -## Installation - Run the **hdc_std install "*hap package address*"** command to install the compiled HAP file. ![](./figures/calendar_install.png) ## Constraints - Development environments - - DevEco Studio for OpenHarmony: version later than 3.1.1.101 - OpenHarmony SDK: API version 10 - For details about the initial DevEco Studio configuration, see the DevEco Studio usage document. + For details about the initial DevEco Studio configuration, see the DevEco Studio usage document. + - Programming language - + ArkTS + - Limitations - + This application can only be run on standard-system devices. -- Gitee