applications_applications_cangjie_wrapper/README_zh.md

应用仓颉封装（beta特性）

简介

应用仓颉封装是 OpenHarmony 上面向开发者提供使用仓颉语言进行应用开发时的应用相关能力。应用仓颉封装提供给开发者访问系统设置项的能力。例如：获取屏幕亮度、获取日期时间格式等系统设置信息。仅支持 standard 设备。

系统架构

图 1 应用仓颉架构图

接口层说明:

• Settings功能接口：
  • 向开发者提供查询时间和日期能力: 开发者可以指定时间和日期的显示格式，例如：12小时格式/24小时格式。
  • 提供获取显示效果设置项的能力。例如：开发者可以获取屏幕亮度设置项的值。
  • 获取指定域名数据项的能力，其中域名数据项包含设备属性共享域和用户属性域。

框架层说明:

• Settings功能封装：提供访问系统相关属性的能力。该封装层是基于Settings提供的功能进行的仓颉封装实现。

架构图中的依赖部件引入说明:

• Settings：负责提供设置应用基础功能。
• cangjie_ark_interop：负责提供仓颉注解类定义，用于对API进行标注，以及提供抛向用户的BusinessException异常类定义。
• ability_cangjie_wrapper：负责提供Ability或Application的上下文的基础能力，包括访问特定应用程序的资源等。
• hiviewdfx_cangjie_wrapper：负责提供日志接口，提供可被文件管理仓颉接口调用的在关键路径处打印日志能力的仓颉接口。

目录

applications/standard/applications_cangjie_wrapper
├── figures                 # 存放README中的架构图
├── kit
│   └── BasicServicesKit    # 仓颉设置应用kit化接口
├── ohos
│   └── settings            # 仓颉设置应用接口实现
└── test
    └── settings            # 仓颉设置应用接口测试代码

使用说明

提供以下功能：

• 查询时间和日期
• 查询显示效果
• 查询指定的相关域名

设置应用相关API请参见设置应用API参考，相关指南请参见设置应用指南。

约束

与ArkTS提供的API能力相比，暂不支持以下功能：

• 设置时间和日期
• 设置显示效果
• 注册/注销 域名指定数据项观察者
• 打开网络管理设置页面
• 启用/禁用飞行模式
• 检查应用是否能够以悬浮窗形式显示

参与贡献

欢迎广大开发者贡献代码、文档等，具体的贡献流程和方式请参见参与贡献。

相关仓

applications_settings

cangjie_ark_interop

ability_cangjie_wrapper

hiviewdfx_hiviewdfx_cangjie_wrapper