App 与智能小程序
在用户使用 App 扫描小程序的二维码或者点击设备,尝试进入小程序时,系统会对 App 当前环境与小程序所需运行环境进行比对,确定环境配置兼容后,App 才能启动并运行小程序。
比对规则中,主要涉及:
- 基础库版本的比对
- Kit 包的种类与版本比对
也就是说,小程序使用的基础库版本、Kit 包种类和版本,会影响 App 能否启动并运行小程序。
>> 新建项目
基础库比对
小程序基础库 是负责加载框架的容器,提供小程序框架需要的标准组件和标准 API 接口。
每个 App 中集成的容器(SDK)版本固定不变,一个容器版本会与多个小程序基础库版本有绑定关系。例如:
App 容器版本 2.4.1 可以绑定下述多个基础库版本: 2.2.4、2.2.3、2.1.20、2.1.19、2.1.18。
基础库次版本号改动是向下兼容的,所以 App 会拉取绑定的最新的基础库版本,去运行小程序。
开发者开发的小程序基础库版本低于当前 App 绑定的最新基础库版本,即表示兼容。
假设当前 App 的容器版本是 2.4.1,绑定的最新基础库版本是 2.2.4:
- 小程序指定基础库版本 2.1.15 —— ✅ App 拉取基础库 2.2.4 运行该小程序。
- 小程序指定基础库版本 1.2.30 —— ❌ 跨基础库主版本号,不兼容。
- 小程序指定基础库版本 2.4.0 —— ❌ 高于 App 绑定的最新基础库版本号。
Kit 包比对
Kit 包 是智能小程序将扩展能力以 Kit 的形式提供给开发者。详细信息可参考下方 API能力集成指南。
每个 App 中集成的 Kit 种类和版本固定不变,Kit 版本同样遵循次版本号向下兼容的原则。
进入小程序前,系统会比对 App 中集成的 Kit 种类、版本与小程序所需的 Kit 种类、版本,确定是否兼容。
假设当前 App 集成的 Kit 有:
Kit version BaseKit 2.2.3 MiniKit 2.3.8 TYKit 2.1.4 - 小程序使用的 Kit 有 BaseKit 2.1.2、MiniKit 2.3.7、TYKit 2.0.7 —— ✅ 小程序所需的 Kit 在 App 中都有集成且版本兼容。
- 小程序使用的 Kit 有 BaseKit 2.1.2、MiniKit 2.3.7、TYKit 2.0.7、DeviceKit 2.1.6 —— ❌ DeviceKit 在 App 中未集成。
- 小程序使用的 Kit 有 BaseKit 2.1.2、MiniKit 2.4.0 —— ❌ 小程序所需 MiniKit 版本高于 App 中集成的版本。
API能力集成指南
概念
小程序能力分为内置能力、扩展能力提供给开发者。内置能力以集成在基础库的 JS API 提供给开发者,扩展能力是将基础能力以 kit 的形式提供给业务(开发者)。以内置能力与扩展能力结合的方式实现快速接入涂鸦生态,达到互联互通的能力。
能力分包
能力分类 包名 基础能力 BaseKit 小程序容器能力 MiniKit 涂鸦内部基础能力以及细粒度通用业务能力 BizKit 设备控制相关能力 DeviceKit 家庭相关能力(比如获取家庭信息等) HomeKit 媒体、语音相关业务能力(比如音乐律动等) MediaKit 地图、定位相关业务能力 MapKit 配网相关业务能力 PlaynetKit 扫地机相关业务能力 P2PKit 使用
1. 配置小程序扩展能力
在 Tuya MiniApp Tools 中可手动配置需要的小程序扩展能力。其中,MiniKit 作为运行小程序容器的基础能力会自动引入,开发者只需要关注版本即可,其他的能力可以自行配置。
2. 使用 Kit 能力
-
插件 BaseKit、BizKit、MiniKit 作为基础能力,可以直接使用 ty.func() 即可。
比如 hideTabBar 作为 BaseKit 能力,可以直接使用,如下:
ty.hideTabBar({ animation: xxx, });
-
除 BaseKit、BizKit、MiniKit 外,其余 Kit 使用,需要在前面加上 namespace。
namespace 为 Kit 名称去掉 Kit 小写(HomeKit -> home)
比如 getCurrentHomeInfo 作为 HomeKit 能力,使用如下:
ty.home.getCurrentHomeInfo({ success(homeInfo) {}, });
3. 选择 Kit 版本
Kit 版本的选择会影响到小程序能否下发到 App。
在 App 中查看信息
在 App 中可以查看集成的容器版本、Kit 版本信息。在小程序右上角胶囊处,长按 关闭 按钮 10s,即会弹出相关信息。
弹窗显示的就是 App 中调用的基础库版本以及集成的 Kit 版本。
在Tuya MiniApp Tool 中配置环境
在 Tuya MiniApp Tool 中,您可手动配置需要的小程序扩展能力。其中,MiniKit 作为运行小程序容器的基础能力会被自动引入。开发者只需要关注版本即可,您也可以自行配置其他的能力。
关于 Kit 版本,建议您选择带有推荐标识的版本。
猜你喜欢
- 14天前(郭富城热舞劲歌演唱会)郭富城年度压轴《新濠尊属系列郭富城梦幻舞林演唱会2023》
- 14天前(哈弗h9优惠9万是真的吗)热浪来袭,哈弗H9超值补贴火热加码
- 14天前(fender japan hybrid)Fender东京旗舰店盛大开幕在即,开售商品和店内服务提前揭晓
- 14天前(福朋喜来登酒店宴会厅)福朋喜来登品牌亮相北部湾城市群 阳江中心福朋喜来登酒店开业
- 14天前(纳米比亚旅游报价)纳米比亚旅游局2024年中国推介会圆满落幕
- 14天前(澳涞山庄见证北欧零碳到中国实践,世界十佳环境保护城市榜单发布)澳涞山庄见证北欧零碳到中国实践,世界十佳环境保护城市榜单发布
- 14天前(美诺酒店集团旗下臻选品牌m collection)美诺酒店集团启动盛橡品牌战略焕新 开启全球扩张新篇章
- 14天前(辽宁新增6个国家4a级旅游景区有哪些)辽宁新增6个国家4A级旅游景区
- 14天前(大黄山景区高质量发展联盟成立多少年)大黄山景区高质量发展联盟成立
- 14天前(第三届“堡里有年味·回村过大年”民俗花灯会活动)第三届“堡里有年味·回村过大年”民俗花灯会活动
网友评论
- 搜索
- 最新文章
- (2020广州车展哈弗)你的猛龙 独一无二 哈弗猛龙广州车展闪耀登场
- (哈弗新能源suv2019款)智能科技颠覆出行体验 哈弗重塑新能源越野SUV价值认知
- (2021款全新哈弗h5自动四驱报价)新哈弗H5再赴保障之旅,无惧冰雪护航哈弗全民电四驱挑战赛
- (海南航空现况怎样)用一场直播找到市场扩张新渠道,海南航空做对了什么?
- (visa jcb 日本)优惠面面俱到 JCB信用卡邀您畅玩日本冰雪季
- (第三届“堡里有年味·回村过大年”民俗花灯会活动)第三届“堡里有年味·回村过大年”民俗花灯会活动
- (展示非遗魅力 长安启源助力铜梁龙舞出征)展示非遗魅力 长安启源助力铜梁龙舞出征
- (阿斯塔纳航空公司)阿斯塔纳航空机队飞机数量增至50架
- (北京香港航班动态查询)香港快运航空北京大兴新航线今日首航
- (我在港航“呵护”飞机 每一次安全着陆就是最好的荣誉)我在港航“呵护”飞机 每一次安全着陆就是最好的荣誉
- 热门文章