本项目为 Kuikly MiniProgram 宿主 App 项目,用于运行 kuiklyCore 示例项目的小程序版本
# 构建 shared 项目 Debug 版
# miniApp需要用远程ksp源,KuiklyUI仓库加上 -Pkuikly.useLocalKsp=false 参数
./gradlew :demo:packLocalJsBundleDebug -Pkuikly.useLocalKsp=false然后构建 miniApp 项目
# 运行 miniApp 服务器 Debug 版
./gradlew :miniApp:jsMiniAppDevelopmentWebpack# 首先构建业务 Bundle
# miniApp需要用远程ksp源,KuiklyUI仓库加上 -Pkuikly.useLocalKsp=false 参数
./gradlew :demo:packLocalJSBundleRelease -Pkuikly.useLocalKsp=false
# 然后构建 miniApp
./gradlew :miniApp:jsMiniAppProductionWebpack使用小程序开发者工具打开miniprogramApp下的dist目录,根据你的实际页面,修改app.json里面的pages数组和在pages里新建对应的页面
// 例如demo里存在router的Page, 就需要在app.json的pages数组里添加 "pages/router/index", 同时在pages的目录里新建router目录补充和pages/index目录一样的内容
// pages/index/index.js内容
var render = require('../../lib/miniprogramApp.js')
render.renderView({
// 这里的pageName是最高优先级,如果没配置,会去拿小程序启动参数里的page_name,如果都没有会报错
// 建议小程序的第一个页面必须配置pageName
// pageName: "router",
statusBarHeight: 0 // 如果要全屏,需要把状态栏高度设置为0
})demo里面的src/commonMain/assets下的文件,需要复制到dist/assets目录
// 复制业务的assets文件到小程序目录
./gradlew :miniApp:copyAssets小程序的壳工程中,每个页面里都会调用render.renderView, 支持传递两个参数
- pageName页面名称, 这里如果配置了,会忽略小程序启动的时候传递的page_name参数
- statusBarHeight状态栏高度,默认会使用系统的状态了高度, 设置为0可以全屏
在小程序开发者工具,可以配置启动参数,指定启动的页面和其他配置
例如配置 page_name=SafeAreaExamplePage&testParam=123
项目入口在 Main.kt 的 main 方法中,其中 KuiklyRenderViewDelegator 用于注册外部自定义 View 和 Module 及 PropHandler, 宿主侧可以在此实现自定义的View,Module并注册到KuiklyRenderViewDelegator中。