SuperAPI AI 工具集

kuikly-app-builder

编程与开发

查看项目

更新于 10-20 02:23

技能介绍

用途

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 源码并重新构建,修改前向用户展示改动。

使用方式

工作流须严格按顺序执行:

  1. 初始化:检查并在缺失时克隆 KuiklyUI 参考仓库到技能目录的 references/KuiklyUI(git clone https://github.com/Tencent-TDS/KuiklyUI.git)。
  2. 环境检查:运行 doctor,必装项缺失则停止并提示用户安装 JDK 17 与 Android SDK。
  3. 创建项目。
  4. 创建新页面。
  5. 写页面代码前必须完成三步:读取 KuiklyComposeDSL.md(Compose DSL 规则)、读取 ui-framework-guide.md(文档索引与编码规则)、按需求查阅相关组件/模块的 API 文档与示例;每次写新页面或改代码都要重复该步骤。
  6. 更新原生入口中的默认 pageName(Android 的 MainActivity.kt、iOS 的 ViewController.m),否则 APK/IPA 仍显示旧模板页。
  7. 构建与预览循环修复错误。

适用场景

  • 从零搭建 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+ 磁盘。

暂未提供

资料未说明该技能自身的收费、价格或商业授权信息。