SuperAPI AI 工具集

kuikly-expand-view

前端与建站

查看项目

更新于 10-15 23:46

技能介绍

用途:用于在 Kuikly 框架中开发自定义扩展 UI 组件。Kuikly 已封装 Text、Image、List 等常用 View,自定义 View 用于复用已有原生 UI 组件或满足特殊需求。

主要能力与机制:自定义 View 需双端实现。Kuikly 侧用 Kotlin 定义组件结构,包括 viewName、Attr、Event 和方法;Native 侧实现具体渲染逻辑,通过 viewName 关联,组件名必须全端一致。Native 侧通过 setProp(propKey, propValue) 接收属性和事件,通过 call 响应方法调用。

Kuikly 侧开发步骤:新建 View 类继承 DeclarativeBaseView<XxxAttr, XxxEvent>,实现 viewName()、createAttr()、createEvent();定义 Attr 类继承 Attr 并添加属性方法;定义 Event 类继承 Event 并添加事件注册方法;可选定义组件方法;编写声明式 API 扩展函数并在业务代码使用。可用 ViewRef 获取组件引用并在其他位置调用方法。

Native 侧开发:只需在业务需要支持的平台实现,包括 Android、iOS、鸿蒙 ArkTS、H5、小程序,需实现 setProp 处理属性和事件、call 处理方法调用,并注册到 Kuikly 框架。

限制:View 方法支持异步回调,不支持同步返回结果;不支持传递二进制数据,图片等二进制内容需 Base64 编码后以 JSON 传递或使用 Module 方法;自定义 View 跨端使用时必须显式设置宽高;iOS 类名必须与 viewName 一致,Swift 实现需 @objc 修饰;鸿蒙需实现 createArkUIView();方法须在 performTaskWhenRenderViewDidLoad 回调中调用。各平台详细实现与注册方式见 VIEW_IMPLEMENT.md,未在资料中展开。