鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.pluginComponent (PluginComponentManager)

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:PluginComponent) ArkTS声明式开发(基础手势:PluginComponent) 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


@ohos.pluginComponent (PluginComponentManager)

用于给插件组件的使用者请求组件与数据,使用者发送组件模板和数据。

说明

  • 本模块首批接口从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

导入模块

import { pluginComponentManager } from '@kit.ArkUI'

PluginComponentTemplate

Plugin组件模板参数。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数类型必填描述
sourcestring是组件模板名。
abilitystring是提供者Ability的bundleName。

PluginComponentManager

插件组件管理器。

KVObject

type KVObject = { [key: string]: number | string | boolean | [] | KVObject }

以键值对形式存储信息,符合json格式。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

取值范围说明
[key: string]关键字,数据类型为字符串,可取空字符串。
number键值,表示值类型为数字。
string键值,表示值类型为字符串,可取空字符串。
boolean键值,表示值类型为布尔值。
[]键值,可取值为[]。
KVObject键值,表示值类型为KVObject。

PushParameters

用于设置FA模型下使用PluginManager.Push方法时候的需要传递的参数。

模型约束: 此接口仅适用于FA模型。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
wantWant是组件使用者Ability信息。
namestring是组件名称。
dataKVObject是组件数据值。
extraDataKVObject是附加数据值。
jsonPathstring否存放模板路径的external.json件的路径。

RequestParameters

用于设置FA模型下使用PluginManager.Request方法时候的需要传递的参数。

模型约束: 此接口仅适用于FA模型。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
wantWant是组件提供者Ability信息。
namestring是请求组件名称。
dataKVObject是附加数据。
jsonPathstring否存放模板路径的external.json文件的路径。jsonPath字段不为空或者未设置的时候不触发Request通信。

RequestCallbackParameters

PluginManager.Request方法时候接收到的回调结果。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
componentTemplatePluginComponentTemplate是组件模板。
dataKVObject是组件数据。
extraDataKVObject是附加数据。

RequestEventResult

注册Request监听方法后,接受到的请求事件时候回应请求的数据类型。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型必填说明
templatestring否组件模板。
dataKVObject否组件数据。
extraDataKVObject否附加数据。

OnPushEventCallback

type OnPushEventCallback = (source: Want, template: PluginComponentTemplate, data: KVObject,

extraData: KVObject) => void

对应Push事件的监听回调函数。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

参数:

参数类型必填说明
sourceWant是Push请求发送方相关信息。
templatePluginComponentTemplate是Push请求发送方相关信息请求组件模板名称。
dataKVObject是数据。
extraDataKVObject是附加数据。

示例:

import { pluginComponentManager, PluginComponentTemplate } from '@kit.ArkUI'
import { Want } from '@kit.AbilityKit';

function onPushListener(source: Want, template: PluginComponentTemplate, data: pluginComponentManager.KVObject, extraData: pluginComponentManager.KVObject) {
console.log("onPushListener template.source=" + template.source)
console.log("onPushListener source=" + JSON.stringify(source))
console.log("onPushListener template=" + JSON.stringify(template))
console.log("onPushListener data=" + JSON.stringify(data))
console.log("onPushListener extraData=" + JSON.stringify(extraData))
}

OnRequestEventCallback

type OnRequestEventCallback = (source: Want, name: string, data: KVObject) => RequestEventResult

对应request事件的监听回调函数。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

参数:

参数类型必填说明
sourceWant是request请求发送方相关信息。
namestring是模板名称。
extraDataKVObject是附加数据。

示例:

import { pluginComponentManager } from '@kit.ArkUI'
import { Want } from '@kit.AbilityKit';

function onRequestListener(source: Want, name: string, data: pluginComponentManager.KVObject) {
console.error("onRequestListener");
console.log("onRequestListener source=" + JSON.stringify(source));
console.log("onRequestListener name=" + name);
console.log("onRequestListener data=" + JSON.stringify(data));
let RtnData: Record<string, string | pluginComponentManager.KVObject> = {
'template': "ets/pages/plugin.js",
'data': data
}
return RtnData;
}

push

push(param: PushParameters , callback: AsyncCallback<void>): void

组件提供者向组件使用者主动发送组件与数据。

模型约束: 此接口仅适用于FA模型。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
paramPushParameters是组件使用者的详细信息。
callbackAsyncCallback<void>是此次接口调用的异步回调。

示例:

import { pluginComponentManager } from '@kit.ArkUI'
pluginComponentManager.push(
{
want: {
bundleName: "com.example.provider",
abilityName: "com.example.provider.MainAbility",
},
name: "plugintemplate",
data: {
"key_1": "plugin component test",
"key_2": 34234
},
extraData: {
"extra_str": "this is push event"
},
jsonPath: "",
},
(err, data) => {
console.log("push_callback: push ok!");
}
)

request

request(param: RequestParameters, callback: AsyncCallback<RequestCallbackParameters>): void

组件使用者向组件提供者主动请求组件。

模型约束: 此接口仅适用于FA模型。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
paramRequestParameters是组件模板的详细请求信息。
callbackAsyncCallback<RequestCallbackParameters>是此次请求的异步回调, 通过回调接口的参数返回接受请求的数据。

示例:

import { pluginComponentManager } from '@kit.ArkUI'
pluginComponentManager.request(
{
want: {
bundleName: "com.example.provider",
abilityName: "com.example.provider.MainAbility",
},
name: "plugintemplate",
data: {
"key_1": "plugin component test",
"key_2": 1111111
},
jsonPath: "",
},
(err, data) => {
console.log("request_callback: componentTemplate.ability=" + data.componentTemplate.ability)
console.log("request_callback: componentTemplate.source=" + data.componentTemplate.source)
console.log("request_callback: data=" + JSON.stringify(data.data))
console.log("request_callback: extraData=" + JSON.stringify(data.extraData))
}
)

on

on(eventType: string, callback: OnPushEventCallback | OnRequestEventCallback ): void

提供者监听"request"类型的事件,给使用者返回通过request接口主动请求的数据;使用者监听"push"类型的事件,接收提供者通过push接口主动推送的数据。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
eventTypestring是

监听的事件类型, 可选值为:"push" 、"request"。

"push”:指组件提供者向使用者主动推送数据。

"request”:指组件使用者向提供者主动请求数据。

callbackOnPushEventCallback | OnRequestEventCallback是对应监听回调,push事件对应回调类型为OnPushEventCallback,request事件对应回调类型为OnRequestEventCallback 。

示例:

import { pluginComponentManager, PluginComponentTemplate } from '@kit.ArkUI'
import { Want } from '@kit.AbilityKit';
function onPushListener(source:Want, template:PluginComponentTemplate, data:pluginComponentManager.KVObject, extraData:pluginComponentManager.KVObject) {
console.log("onPushListener template.source=" + template.source)
console.log("onPushListener source=" + JSON.stringify(source))
console.log("onPushListener template=" + JSON.stringify(template))
console.log("onPushListener data=" + JSON.stringify(data))
console.log("onPushListener extraData=" + JSON.stringify(extraData))
}
function onRequestListener(source:Want, name:string, data:pluginComponentManager.KVObject) {
console.error("onRequestListener");
console.log("onRequestListener source=" + JSON.stringify(source));
console.log("onRequestListener name=" + name);
console.log("onRequestListener data=" + JSON.stringify(data));
let RtnData:Record<string,string|pluginComponentManager.KVObject> = { 'template': "ets/pages/plugin.js", 'data': data }
return RtnData;
}
pluginComponentManager.on("push", onPushListener)
pluginComponentManager.on("request", onRequestListener)

external.json文件说明

external.json文件由开发者创建。external.json中以键值对形式存放组件名称以及对应模板路径。以组件名称name作为关键字,对应模板路径作为值。

示例


{
"PluginProviderExample": "ets/pages/PluginProviderExample.js",
"plugintemplate2": "ets/pages/plugintemplate2.js"
}
 

鸿蒙开发实战:06-使用ArkTs开发鸿蒙插件 鸿蒙操作系统(HarmonyOS)的插件化架构采用分层设计模式,核心包含三个层级:插件接口层(Plugin Interface Layer)、插件实现层(Plugin Implementation Layer)和插件管理服务(Plugin Management Service)。- **声明式UI**:通过@Entry和@Component装饰器实现组件化开发。- **高性能渲染**:采用精简的VDOM(Virtual DOM)实现机制。2. **线程优化**:合理使用Worker线程减少主线程阻塞。 阅读详情

相关推荐

鸿蒙ArkTS实战开发-Native XComponent组件的使用

本篇Codelab主要介绍如何使用XComponent组件调用NAPI来创建EGL/GLES环境,实现在主页面绘制一个正方形,并可以改变正方形的颜色。本篇CodeLab使用Native C++模板创建。

2401_82546228的博客 2490

HarmonyOS实战开发:@ohos.pluginComponent (插件组件管理器)

用于给插件组件的使用者请求组件与数据,使用者发送组件模板和数据.........

2401_84194030的博客 1428

使用TypeScript开发鸿蒙自定义插件的完整流程

在鸿蒙操作系统中,使用TypeScript开发自定义插件是一个涉及多个步骤的过程。

qq_14863717的博客 679

OpenHarmony 项目实战-基于ArkUI(TS)声明式开发,2024年最新HarmonyOS鸿蒙插件化开发打包

onTouch((event) => this.listTouchEvent(event)) // 父容器设置touch事件,当列表无数据也可以下拉刷新。2、touch触摸事件:1—>手指移动下拉改变偏移量,2—>手指抬起根据是否可以刷新:显示刷新状态,3—>请求数据成功后,关闭刷新状态。到达条件:如果一直下拉,下拉偏移量缓慢增加(阻力效果),手指抬起偏移量回到下拉刷新布局高度,等待主动关闭刷新。未达到条件:动画收回。// 偏移量大于下拉刷新布局高度,达到刷新条件。// 偏移量为下拉刷新布局高度。

m0_60147147的博客 1120

鸿蒙开发进阶之鸿蒙组件化项目搭建

鸿蒙战略胜利,目前鸿蒙开发是一个急需要人才的缺口,在未来几年势必会有大量的鸿蒙岗位出现,目前所存在的鸿蒙岗位也是给出了相当高的薪资。事实证明,鸿蒙开发确实是一块香饽饽。作为华为自家的操作系统,正在逐步扩张市场份额。想要转行或者入行的朋友可以下手了。在这里,为大家提供一份我整理的鸿蒙开发学习资料,涵盖了UI开发、web、应用模型多个知识点,有需要的朋友可以扫描下方二维码,免费获取更多相关资料。

weixin_48091641的博客 1370

Adams软件安装与配置全攻略:从入门到机器人仿真

机械系统动力学仿真软件Adams是工业机器人开发的重要工具,其安装过程涉及许可证配置、环境变量设置等关键技术环节。专业仿真软件安装通常需要处理系统兼容性、组件依赖和授权验证等工程问题,特别是在机器人控制仿真等场景中,还需集成MATLAB/Simulink等第三方工具。本文以Windows平台为例,详解Adams安装的核心步骤,包括系统环境检查、许可证服务器配置、工业机器人专项模块安装等实践要点,并针对NVIDIA Quadro显卡优化、27500端口通信等常见问题提供解决方案,帮助用户快速搭建可靠的仿真环境

weixin_28523493的博客 206

OpenHarmony应用开发—ArkUI组件集合

使用全局组件ShowToast,TitleBar,IntroductionTitle实现按钮,时间选择器,单选按钮,选择菜单,滑动条,切换按钮,勾选框,文本选择器,时间选择器,计数器,评分条组件功能。使用全局组件TitleBar,AttributeModificationTool实现二维码,进度条,跑马灯,文字计时器,文字时钟,仪表盘,数据面板组件功能。若不存在三级导航,则跳转至详情页面。使用全局组件TitleBar实现标记,滚动条,下拉刷新,弹出面板,字母索引条组件功能。

OpenHarmony_dev的博客 1121

QSPI Flash的原理与QSPI时序的Verilog实现

本节主要是讨论QSPI(Quad SPI,四线SPI总线)的相关内容。我的开发板上有一片型号是W25Q128BV的Quad SPI Flash存储器,本文将以它为例子来说明QSPI操作的一些内容。

Go Forward Forever! 4167

基于hvigor插件定制构建

hongxiaomeng的博客 1541

PaddleOCR在医疗票据识别中的实战:从部署到业务字段提取

本文详细介绍了PaddleOCR在医疗票据识别中的实战应用,重点阐述了其离线部署方案与PP-OCRv3模型选型优势。针对医疗票据敏感数据不出本地的合规要求,文章提供了从环境搭建、模型配置到核心字段提取策略的完整流程,并分享了性能优化与系统集成的实践经验,有效解决了医疗票据自动化录入的难题。

weixin_29271053的博客 238

【processing】创意编程

首先接到这个作业的时候,我是很崩溃的,我是真的不会画画QAQ,还画自己,这也太难了,于是我决定!还是祸害我爱豆吧!于是我从微博太太那里找了个图临摹 下面是太太的图 先给太太道歉!都是为了作业! 然后我画出来是这样子的 还可以!!!没有特别丑!(虽然也不是特别像吧) 但是画这个真是画死我了,下面贴上代码吧,没啥特殊的就是各种贝塞尔曲线各种圆各种线 //face stroke(70,27,11...

qq_25700571的博客 1267

鸿蒙应用开发 | 最牛逼的 自定义 布局

大家好,我是你们的朋友 朋哥,今天聊聊自定义布局,自定义布局就是当前系统布局不满足时的布局方式。 上一篇原创文章解读了鸿蒙开发布局的 自适应盒子布局(AdaptiveBoxLayout),通过设置布局规则来调整布局,到目前,布局开发基本完成了。 有点激动接下来的组件,目录已经准备好,大家跟进步伐。 布局完成肯定要总结一下,其实布局是开发ui的关键,需要开发者做到,看到界面就能明白需要用上面布局做开发。 为了更好的理解布局的作用,今天来开发一下自定义布局。 简介: 来看看官方对自定义的说...

897

【32】OpenCV——图像含义关系?RGGB , BGGR , GRBG , GBRG呢?raw8,raw10,raw12,raw14呢? YUV422; RAW16呢?YCbYCr/RG_GB;

‌如前所述,定义原始数据的位深精度。‌* ‌一种压缩色彩编码方式,通过色度抽样(亮度Y全分辨率,色度U/V半分辨率)减少数据量,常用于视频传输。‌* ‌可能指每个像素分量占16位存储(如高位填充的RAW10/12/14),或未明确量化的高精度原始数据。‌ ‌分类‌核心定义‌关联性及典型应用传感器原始色彩排列(RGGB/BGGR等)决定RAW数据的色彩分布规则RAW位深每个分量的数据精度(8/10/12/14位)影响动态范围和存储空间‌YUV422。

程序员,他们想的是什么?他们想的永远都是技术,他们崇尚的也永远都是技术。 794

鸿蒙App开发,史上最强组件父类Component!

一、先介绍Component,为什么? Componen是UI组件的基类,它定义了组件许多通用功能和属性,其他组件(Text、Image、Button、ListContainer等)都是继承自该类,类似安卓中的View。 根据OOP面向对象思想,其他组件都是Component的子类,自然就继承了这些功能和属性,无需重复介绍,也更方便没有接触过安卓开发的朋友理解。 ...

gx506578835的专栏 2719

Unity内存优化:从崩溃到流畅的终极指南

Emscripten 为 WebAssembly 设定的内存布局(Static、Stack 和 Heap)为开发者提供了一个清晰的内存管理框架。理解这些内存区域的特性和用途,有助于开发者在 WebGL 项目中更有效地管理内存,优化性能,减少内存使用峰值。在 Unity WebGL 中,Dynamic Memory 是 UnityHeap 的主要组成部分,负责存储游戏运行时所需的各种数据。Dynamic Memory 主要分为两类:Managed Memory 和 Native Memory。

本博客聚焦游戏开发技巧、创业实战心得及大学热门课程干货。这里既有技术深度,也有思维广度,无论你是开发者、创业者还是高校学子,都能在这里找到适合自己的成长之路! 358

基于YOLOv8/YOLOv7/YOLOv6/YOLOv5的农作物害虫检测系统(深度学习模型+UI界面+训练数据集)

随着人工智能技术在农业领域的深入应用,基于深度学习的害虫检测系统已成为智慧农业的重要组成部分。本文详细介绍了一种基于YOLOv8/YOLOv7/YOLOv6/YOLOv5的农作物害虫检测系统,涵盖算法原理、数据集构建、模型训练、系统实现及完整代码。该系统能够实时检测并识别多种农作物害虫,为农业生产提供精准的病虫害监测解决方案。

YOLO 274

HarmonyOS鸿蒙学习笔记(28)@entry和@Component的生命周期

@entry和@Component的生命周期

菜鸟博客 6286

OPENSSL使用方法

预备知识KEY 通常指私钥。CSR 是 Certificate Signing Request 的缩写,即证书签名请求,这不是证书,只是包含申请证书的基本信息。生成证书时要把这个提交给权威的证书颁发机构,颁发机构审核通过之后,再根据这些申请信息生成相应的证书。CRT 即 certificate的缩写,即证书。 X.509 是一种证书格式。对X.509证书来说,认证者总是CA或由CA指定的人,一份...

zxm8513优快云博客 1216

第三一课:HarmonyOS Next 插件开发全流程解析:从开发到生态落地

HarmonyOS Next 插件体系通过三大维度构建开发生态:‌工具链革新DevEco Studio 插件模板生成效率提升50%‌2动态加载时延优化至50ms内‌1‌安全机制升级双重签名验证 + 运行时权限动态回收‌4漏洞扫描覆盖率达到100%‌4‌生态扩展能力支持第三方SDK快速插件化封装‌1企业私有插件市场对接方案‌1。

m0_71441912的博客 1220

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

鸿蒙App gradle 插件开发(篇1)

1.插件的简单介绍: 相信做过Android 开发的同学,都知道Andrioid Studio 的构建工具使用的是Gradle ,同时Android 实现一系列编译打包 都是基于Android Studio内部的引入的gradle插件 该插件内部基于gradle 框架开发了 各种构建Task,帮助实现整个项目打出完整的 apk安装包,下图是Android 内部引入的id 'com.android.application' 插件引入的构建Task: 鸿蒙也是基于O...

焱宣的博客 3122

efm32 入门.pdf

本PDF共计22页,介绍的是操作驱动API,下载与否自己斟酌。

插件开发:harmony-utils插件系统的扩展开发指南

还在为HarmonyOS开发中重复造轮子而烦恼?每次新项目都要重新封装基础工具类?harmony-utils的插件系统让你告别重复劳动,专注于业务创新! **读完本文你将获得:** - ✅ harmony-utils插件架构的深度解析 - ✅ 从零开始开发自定义插件的完整流程 - ✅ 插件发布、集成、调试的最佳实践 - ✅ 实际案例:开发一个地理位置插件 - ✅ 性能优化和错误处理的专业技巧 ...

gitblog_00316的博客 1167

鸿蒙 Flutter plugin开发详细步骤

随后在 demo 工程中对插件进行功能调用测试,仔细观察其运行状态,若一切正常,便意味着我们已成功攻克鸿蒙 Flutter plugin 开发的关键节点,可进一步深入挖掘 ios/android native 逻辑,开启更为复杂和强大的 ohos plugin 开发之旅,为鸿蒙生态的繁荣添砖加瓦。在 demo portal/module 的 pubspec.yaml 文件中,我们要严谨地对插件进行本地依赖配置,详细设定插件的路径、版本等关键信息,确保插件与项目紧密相连,为后续的开发进程保驾护航。

flfljh的专栏 1064

HarmonyOS实战开发:@ohos.arkui.componentUtils (componentUtils)

提供获取组件绘制区域坐标和大小的能力。

2401_84194030的博客 1580

HarmonyOS5 DevEco Studio 插件开发指南

通过插件扩展 DevEco Studio,开发者可深度定制工作流(如自动化表单填充、跨设备预览增强等)。遵循鸿蒙设计规范,确保插件行为与原生 IDE 体验一致,是提升生态协作效率的关键。建议参考DevEco 插件开发文档获取最新 API 细节。

qq_39431314的博客 1870

鸿蒙NEXT开发【开发hvigor插件】扩展构建

hvigor允许开发者实现自己的插件,开发者可以定义自己的构建逻辑,并与他人共享。 hvigor主要提供了两种方式来实现插件:基于hvigorfile脚本开发插件、基于typescript项目开发。 下面的章节中,将以HarmonyOS应用为示例,逐一介绍。

鸿蒙的技术博客 1646

(三七)HarmonyOS Design 的插件开发:开发发布与使用管理

插件需要定义清晰的接口,以便主应用能够与插件进行交互。以下是一个简单的插件接口示例:java// 定义插件接口HarmonyOS 的插件开发为应用的扩展和创新提供了有力支持。通过遵循插件开发与发布的流程,以及合理使用和管理插件,开发者可以为用户提供更加丰富、个性化的应用体验。在实际开发中,要注意插件接口的设计和兼容性,确保插件与主应用之间的稳定交互。同时,要重视插件的安全性和性能优化,为用户打造高质量的插件应用。

m0_71441912的博客 618
上一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.mediaquery (媒体查询)
下一篇: 鸿蒙5.0开发进阶:ArkTS API UI界面-@ohos.promptAction (弹窗)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值