ArkUI使用DrawableDescriptor指南文档示例

介绍

本示例通过使用drawable_descriptor.h中的接口，帮助开发者更好的理解并合理使用ArkUI提供的组件以及组件属性。该工程创建Image组件，入参类型为DrawableDescriptor,并可以设置duration、iteration属性。

效果预览

首页	设置属性

使用说明

1. 工程启动后，通过文本输入，设置属性值。

2. 在"设置duration"和"设置iteration"文本输入框中，分别输入属性值，其中duration为动图播放的播放时长，iteration为动图播放的次数。

3. 分别点击"设置"，查看已设置属性值的显示效果。

4. 工程启动后，会自动加载图片并触发对OH_ArkUI_DrawableDescriptor_GetStaticPixelMap、OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArray、OH_ArkUI_DrawableDescriptor_GetAnimatedPixelMapArraySize这几个接口的调用，若接口成功调用可以在DevEco Studio开发环境中的日志界面看到如下相关日志信息：

"GetStaticPixelMap success"
"GetAnimatedPixelMapArray success"
"GetAnimatedPixelMapArraySize success"

5. 退出工程后，会自动调用OH_ArkUI_DrawableDescriptor_Dispose接口，若接口成功调用可以在DevEco Studio开发环境中的日志界面看到如下相关日志信息：

"Dispose success"

工程目录

entry/src/main/cpp
|---CMakeLists.txt                     // 编译脚本
|---napi_init.cpp                      // 实现资源创建、属性设置相关功能
|---drawable_manager.cpp               // 管理DrawableDescriptor节点
|---types
    |---Index.d.ts                     // 注册napi函数到ets层，供上层调用
entry/src/main/ets/
|---entryability
|---pages
|   |---Index.ets                      // 应用主页面
entry/src/ohosTest/
|---ets
|   |---index.test.ets                 // 示例代码测试代码

具体实现

1. 在Index.ets文件中，通过文本输入框和"设置"按钮设置Image组件属性值。
2. 在Index.d.ts文件中，注册napi函数到ets层。
3. 在napi_init.cpp文件中，实现Index.d.ts中对外的接口。
4. 在drawable_manager.cpp文件中，实现对DrawableDescriptor节点的保存、获取、删除功能。

相关权限

不涉及。

依赖

不涉及。

约束与限制

1. 本示例仅支持标准系统上运行, 支持设备：华为手机。

2. HarmonyOS系统：HarmonyOS 5.0.5 Release及以上。

3. DevEco Studio版本：6.0.0 Release及以上。

4. HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。

下载

如需单独下载本工程，执行如下命令：

git init
git config core.sparsecheckout true
echo ArkUISample/DrawableDescriptorSample > .git/info/sparse-checkout
git remote add origin https://gitcode.com/harmonyos_samples/guide-snippets.git
git pull origin master