跟着鸿蒙生态的开展，鸿蒙开发已成为年代新风口，学习鸿蒙开发势在必行。鸿蒙开发可参阅学习文档：https://qr21.cn/FV7h05

介绍

本示例展现了Stage模型卡片提供方的创立与运用。

用到了卡片扩展模块接口，@ohos.app.form.FormExtensionAbility。

卡片信息和状况等相关类型和枚举接口，@ohos.app.form.formInfo 。

卡片提供方相关接口的才能接口，@ohos.app.form.formProvider。

运用组件间的信息传递接口，@ohos.app.ability.Want。

效果预览

卡片运用主页面 卡片运用修正订阅条件页面 卡片运用发布数据页面 卡片运用卡片预览图页面
OpenHarmony开发之Stage模型卡片服务详解~
OpenHarmony开发之Stage模型卡片服务详解~
OpenHarmony开发之Stage模型卡片服务详解~
OpenHarmony开发之Stage模型卡片服务详解~
formProvider运用主界面 formProvider运用修正订阅条件 formProvider运用发布数据 formProvider运用卡片款式
OpenHarmony开发之Stage模型卡片服务详解~
OpenHarmony开发之Stage模型卡片服务详解~
OpenHarmony开发之Stage模型卡片服务详解~
OpenHarmony开发之Stage模型卡片服务详解~
增加卡片
OpenHarmony开发之Stage模型卡片服务详解~

运用说明

1.部分设备的桌面不支撑卡片，能够经过自己的开发卡片运用方，进行卡片的创立、更新和删去等操作。

2.卡片的款式如”增加卡片”所示。当卡片更新时，卡片上的温度和时刻会发生变化。

3.装置 卡片运用 或formProvider运用，长按卡片运用图标或formProvider运用图标弹出菜单，点击”服务卡片”选项能够增加服务卡片至桌面（第3张，第4张卡片为formProvider运用卡片；第5张，第6张为卡片运用卡片）；

4.长按数据卡片弹出菜单，点击”移除”能够将已增加至桌面的数据卡片从桌面上移除；

5.点击翻开卡片运用图标或formProvider运用图标，点击”修正订阅条件”按键，界面将跳转至修正订阅条件界面，对应挑选想要发布的数据完结对订阅条件的修正，脱离页面或退出运用后再次翻开修正订阅条件页面，页面单选框会显现当时订阅的城市；

6.在卡片运用或formProvider运用运用中点击”发布数据”按键，界面将跳转至数据发布界面，对应挑选想要发布的数据并点击”发布数据”完结数据发布(若挑选发布的城市与当时订阅城市不一致，则不能将数据更新至卡片)；

工程目录

entry/src/main
|---module.json5                           // 增加卡片拓宽才能
|---/ets/pages
|   |---index.ets                          // 首页
|   |---second.ets                         // 第二跳转页
|---/ets/FormAbility 
|   |---FormAbility.ts                     // 界说卡片目标首次被创立时需求做的操作
|---js/widget/index                        // 界说卡片内容 
|   |---index.hml 
|   |---index.css 
|   |---index.json 
|---resources/base/profile 
|   |---form_config.json                   // 装备卡片（卡片称号，引入js卡片，卡片窗口大小等） 
persistentProxyForm/src/main/
|---common
|  |---StatePersistence.ts                // 订阅条件数据耐久化
|  └---Logger.ts
|---ets
|  └---dataShare
|  | └---DataShare.ts
|  |---entryability
|  |  └---PersistentEntryAbility.ts
|  |---entryformability
|  |  └---EntryFormAbility.ts
|  |---pages
|  |  |---Index.ets                        // PersistentEntryAbility页面
|  |  |---ModifyConditionIndex.ets         // 修正订阅条件页面
|  |  └---PublishIndex.ets                 // 发布数据页面
|  └---widget
|     └---pages
|        └---WidgetCard.ets                // ArkTS卡片
|---js
|  |---common
|  |---i18n
|  └---widgetJS
|     └---pages
|        └---index
|           |---index.css                  // JS卡片款式
|           |---index.hml                  // JS卡片
|           └---index.json                 // JS卡片默认值
└---resources 
processProxyForm/src/main/
|---common
|  |---StatePersistence.ts                 // 订阅条件数据耐久化
|  └---Logger.ts
|---ets
|  |---entryability
|  |  └---ProcessEntryAbility.ts
|  |---entryformability
|  |  └---ProcessEntryFormAbility.ts
|  |---pages
|  |  |---Index.ets                         // ProcessEntryAbility页面
|  |  |---ModifyConditionIndex.ets          // 修正订阅条件页面
|  |  └---PushIndex.ets                     // 发布数据页面
|  └---widget
|     └---pages
|        └---WidgetCard.ets                 // ArkTS卡片
|---js
|  |---common
|  |---i18n
|  └---jsWidget
|     └---pages
|        └---index
|           |---index.css                    // JS卡片款式
|           |---index.hml                    // JS卡片
|           └---index.json                   // JS卡片默认值
└---resources                                // 资源信息

相关概念

Ability：Ability是运用所具备才能的抽象，也是运用程序的重要组成部分。Ability是体系调度运用的最小单元，是能够完结一个独立功用的组件。

具体完成

1、在module.json5文件增加拓宽才能，类型为卡片，并设置卡片入口srcEntrance和卡片元数据metadata。源码参阅 例如：”metadata”: [ { “name”: “ohos.extension.form”, “resource”: “$profile:form_config” }。
2、初始化卡片：经过完成@ohos.app.form.FormExtensionAbility卡片操作类，在卡片目标首次被创立时，初始化卡片绑定数据为空，并将卡片状况设置为就绪状况READY。 例如：onCreate(){ formBindingData.createFormBindingData({}) onAcquireFormState(want) { return formInfo.FormState.READY }。
3、装备卡片：用js编写相应的卡片，将卡片装备到resources/base/profile/form_config, 源码参阅 。

  • 修正数据卡片的订阅条件的功用封装在ModifyConditionIndex.ets中，源码参阅：ModifyConditionIndex.ets 及ModifyConditionIndex.ets。
    • 运用modifyCondition来获取一切现已树立出的卡片目标。
    • 修正订阅条件：运用updateCardDisplayContent遍历一切卡片目标，并依据界面获取的订阅条件数据修正订阅条件。
    • 退出页面或运用后再次翻开修正订阅条件页面，能够保存上次订阅的城市挑选，源码参阅：StatePersistence.ts。
  • 发布数据的功用封装在PublishIndex.ets及PushIndex.ets中，源码参阅：PublishIndex.ets及PushIndex.ets。
    • PublishIndex.ets运用updateRDB来修正rdb数据库中的对应数据。
    • PushIndex.ets运用getRunningFormInfosByFilter获取现已树立出的卡片目标，并运用updateCardDisplayContent遍历一切卡片目标，运用createDataShareHelper创立DataShareHelper目标，并依据界面获取的数据信息运用publish进行数据的发布以完成发布数据的功用
  • 在dataShare模块中，树立rdb数据库，并提供对应update方法。
    • 在onCreate中初始化数据库中的数据。
    • 在update中完成对应的数据更新方法。

依赖

1.本运用中Form.test.ets 需求装置在仿桌面运用上进行测验。launcher运用地址：Launcher

2.本运用中Form.test.ets需求装置卡片运用以及formProvider运用进行测验。（以上两个运用为本工程的feature module）

约束与约束

1.本示例仅支撑规范体系上运转，支撑设备：RK3568。

2.本示例为Stage模型，支撑API10版别SDK，SDK版别号(API Version 10 Release),镜像版别号(4.0 Release)。

3.本示例需求运用DevEco Studio 版别号(4.0 Release)及以上版别才可编译运转。

4.本示需求运用Full SDK编译。运用Full SDK时需求手动从镜像站点获取，并在DevEco Studio中替换，具体操作可参阅替换攻略。

5.本示例所装备的权限为system_core等级(相关权限等级可经过权限界说列表检查)，需求手动装备对应等级的权限签名(具体操作可检查[自动化签名方案]。

6.本示例类型为体系运用，需求手动装备对应等级的运用类型(“app-feature”: “hos_system_app”)。具体可参阅profile装备文件bundle-info目标内部结构

7.本示例运用了ServiceExtensionAbility，需求手动装备特权运用才能申请”app-privilege-capabilities”: `”AllowAppUsePrivilegeExtension”`，不然装置失利。具体操作攻略可参阅运用特权装备攻略。在文件最终增加内容：
“app-privilege-capabilities” : [ “AllowAppUsePrivilegeExtension” ]

8.本示例中运用到DataShareExtensionAbility，需求将本示例加入到白名单中再进行装置。详细内容如下 { “bundleName”: “ohos.samples.formextability”, “app_signature” : [], “associatedWakeUp”: true, “allowAppUsePrivilegeExtension”: true }

下载

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

git init
git config core.sparsecheckout true
echo code/SuperFeature/Widget/FormExtAbility/ > .git/info/sparse-checkout
git remote add origin https://gitee.com/openharmony/applications_app_samples.git
git pull origin master

跟着鸿蒙生态的开展，鸿蒙开发已成为年代新风口，学习鸿蒙开发势在必行。鸿蒙开发可参阅学习文档：https://qr21.cn/FV7h05

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。