Kuikly 是腾讯开源的基于 Kotlin Multiplatform 的超高性能动态化框架,一套代码可运行于 Android、iOS、鸿蒙、H5、小程序等多端。官方文档:https://kuikly.tds.qq.com/DevGuide/dev-guide-overview.html ;GitHub:https://github.com/Tencent-TDS/KuiklyUI 。
用途 本工具用于 KuiklyUI 工程接入,根据用户提供的目录状态自动判断工作模式:空目录(或不存在的新目录)采用脚手架模式,快速创建可运行的 KMP 跨端工程;已有工程目录采用现有工程接入模式,指导将 Kuikly 渲染器逐步接入 Android / iOS / 鸿蒙宿主工程。
主要能力
- 空目录脚手架:根据用户选择的 DSL 类型,通过 npm CLI 生成接入工程。Kuikly DSL 命令:npx --yes @kuikly-ai/create-kuikly-app@latest --json create-integration MyApp --package com.example.myapp ;Compose DSL 命令追加 --dsl compose。生成工程包含 androidApp、iosApp、ohosApp、shared、static_server、buildSrc 等目录。
- 两种 DSL 差异:Kuikly DSL 页面继承 Pager 并重写 body(): ViewBuilder;Compose DSL 重写 willInit() 并调用 setContent {},额外引入 org.jetbrains.compose 插件与 com.tencent.kuikly-open:compose 依赖,源码更丰富,且需设置 KRThreadAdapter.stackSize() = 8MB。
- 现有工程接入:按环境搭建、添加 KMP shared 模块、平台接入、验证的顺序进行。环境需 Android Studio、Kotlin 与 Kotlin Multiplatform 插件、JDK 17、Xcode、CocoaPods 等。shared 模块可通过 Kuikly AS 插件创建,或用 Node 脚手架生成后迁移。
- Android 接入:添加 core-render-android 与 core 依赖,新增 KuiklyRenderActivity 承载容器及布局,实现图片加载、日志、路由、线程、异常等适配器并通过 KuiklyRenderAdapterManager 注册。
- iOS 接入:通过 CocoaPods(pod 'OpenKuiklyIOSRender')或 SPM 添加渲染器依赖,实现承载容器等。
- 鸿蒙接入:使用 DevEco Studio 打开 ohosApp,按流程接入。
使用方式 先判断目标目录状态:目录不存在或为空进入脚手架模式,询问 DSL 类型并确认工程名与包名后执行 CLI 命令,生成 local.properties,再分别用 Gradle、pod install、DevEco Studio 验证;目录已包含工程文件则进入现有工程接入模式,按平台路径逐步接入,并检查各端 Kuikly 版本号一致,2.5.0 版本后需添加 maven 源。
适用场景 新建 Kuikly 跨端工程、为已有 Android/iOS/鸿蒙工程接入 Kuikly 渲染页面、熟悉 Jetpack Compose 的开发者选择 Compose DSL 等。
限制 接入须遵循官方文档代码示例,不应凭记忆编造 API;接入为非侵入式,不修改原有启动 Activity;iOS 编译需 Mac 环境,Windows 环境可注释 iOS 相关配置。具体收费、价格等信息暂未提供。