用途
kuikly-app-builder 是一个面向跨平台移动应用开发的技能,基于 Kuikly——腾讯的 Kotlin Multiplatform UI 框架。当用户要求创建、构建或预览跨平台移动应用时使用。整个流程完全在命令行完成,不依赖 IDE。
主要能力
- 项目脚手架:使用
npx --yes @kuikly-ai/create-kuikly-app@latest --json create MyApp --package com.example.myapp --force创建项目,仅支持 Compose DSL(省略 --dsl 参数即使用默认 Compose)。 - 页面与组件生成:通过
create-page、create-component子命令添加代码,例如npx --yes @kuikly-ai/create-kuikly-app@latest --json create-page UserProfile --dir ./MyApp。 - 环境诊断:
doctor子命令检查 Node.js ≥ 16、JDK 17、Android SDK API 30+、ANDROID_HOME/JAVA_HOME 等必装项,以及 adb、Xcode、xcodegen、CocoaPods、hvigorw/ohpm 等可选项。 - 构建与预览:
build android --dir ./MyApp编译 APK;preview android/ios --dir ./MyApp --page <名称> --timeout 8完成构建、安装、启动并截图。构建成功后可将 JSON 输出中的 apkPath 对应 APK 复制到工作目录。 - 错误自修复:构建失败时解析结构化诊断(文件、行、列、消息、建议),在项目 shared/src/ 内修改 .kt 源码并重新构建,修改前向用户展示改动。
使用方式
工作流须严格按顺序执行:
- 初始化:检查并在缺失时克隆 KuiklyUI 参考仓库到技能目录的 references/KuiklyUI(
git clone https://github.com/Tencent-TDS/KuiklyUI.git)。 - 环境检查:运行 doctor,必装项缺失则停止并提示用户安装 JDK 17 与 Android SDK。
- 创建项目。
- 创建新页面。
- 写页面代码前必须完成三步:读取 KuiklyComposeDSL.md(Compose DSL 规则)、读取 ui-framework-guide.md(文档索引与编码规则)、按需求查阅相关组件/模块的 API 文档与示例;每次写新页面或改代码都要重复该步骤。
- 更新原生入口中的默认 pageName(Android 的 MainActivity.kt、iOS 的 ViewController.m),否则 APK/IPA 仍显示旧模板页。
- 构建与预览循环修复错误。
适用场景
- 从零搭建 Kotlin Multiplatform 跨平台移动应用。
- 在无 IDE 的云端或容器环境中生成、编译和预览 App。
- Android/iOS 双端开发与验证;HarmonyOS 可创建项目结构但需手动构建。
限制
- 不安装任何系统工具,不使用 sudo 或 root;工具须用户预先安装。
- 仅在 create 命令创建的项目目录及技能自身 references/ 目录内读写,不修改外部文件;自修复仅限项目 shared/src/ 下的 .kt 文件。
- JDK 仅支持 17,18+ 会导致构建失败;iOS 构建需 macOS + Xcode 15+。
- HarmonyOS、H5、MiniApp 的构建/预览在 CLI 中尚未支持(🚧),需手动构建或用对应开发工具。
- iOS 构建前须先运行
./gradlew :shared:generateDummyFramework,再在 iosApp/ 下执行pod install,否则运行时会 SIGABRT 崩溃;Podfile 不应添加 use_frameworks!。 - HarmonyOS 手动构建流程:在 ohosApp 目录执行
ohpm install --all --strict_ssl true与hvigorw assembleApp --mode project -p product=default -p buildMode=debug --no-daemon,产物位于 ohosApp/entry/build/default/outputs/default/,未签名 hap 仅可装模拟器,真机需配置签名后用绝对路径hdc app install安装;截图用hdc shell snapshot_display并通过hdc file recv取回。 - 最低 2GB 内存、5GB 磁盘,推荐 4GB+ 内存、10GB+ 磁盘。
暂未提供
资料未说明该技能自身的收费、价格或商业授权信息。