本指南希望可以帮助测试人员快速了解小程序,知晓小程序的相关概念,定位排查问题。
学习内容
- 小程序基本概念
- 通过 App 扫码开始测试小程序的流程
- 审核上线时的安全合规注意点
小程序文档
更详细的小程序文档可以跳转:智能小程序文档
智能小程序
智能小程序可以理解为是涂鸦提供了一套开发框架给开发者,开发者按照规定的语法、框架规则就可以开发出具有原生 App 体验的服务,运行到涂鸦生态的各个 App 中。
小程序的优势在于:
- 跨端:开发者只需要开发一套代码,就可以投放到各个端,安卓和 iOS 的一致性是由小程序框架来保证的。而涂鸦生态的 App 只要它的 App SDK 集成了小程序能力,就可以运行智能小程序。
- 性能:原生般的体验、快速加载。
- 动态更新:不受 App 版本限制,在开发者平台中就可以操作上线新功能、停用已有服务。
- 能力集成:涂鸦的 IoT 能力,以小程序组件或插件的形式面向开发者。
开发者平台
开发者平台是管理小程序的平台,在这个平台可以对小程序进行版本管理、扫码体验、权限管理、多语言配置等。
进入测试流程前,开发者肯定在该平台已经创建了对应的小程序项目,测试人员可以要求开发者在开发者平台——成员管理中添加自己,将已有项目共享给自己。
开发者平台也可以生成体验二维码,测试人员通过 App 扫描体验二维码唤起小程序。
开发者平台更详细的操作说明:智能小程序文档——开发者平台
与正常的测试流程相比,小程序测试的区别就在于是利用 App 扫描开发者平台生成的体验二维码,来唤起、进入小程序页面。
体验二维码使用过程参考下节。

App 安装
测试人员首先需要找到客户端人员拿到需要测试的 App 安装包,客户端人员需要保证 App 集成了小程序能力,同时基础库版本、Kit 包版本兼容当前要扫码的小程序。
成为项目成员、加入白名单
要求开发者在 开发者平台—成员管理 中添加测试人员账号,这样测试人员就可以在自己的账号列表下找到小程序项目。
同时还需要让开发者正确的配置"投放管理",并且在"白名单"中添加测试人员账号。
具体流程参考文档:开发者平台—体验二维码。
生成体验二维码
- 在 开发者平台-版本管理 中将需要测试的版本设为体验版。
- 点击"体验二维码"按钮。
- 配置二维码信息,可以指定小程序自动进入某个页面。也可以什么都不配置,直接点击确定。
- 扫描体验二维码。


基础库
基础库负责小程序框架的加载的容器,提供小程序框架需要的标准组件和部分 JS API 接口。
Kit 包
客户端将提供的设备能力、基础业务能力等分成了不同 Kit 包,通过插件方式提供给小程序、RN、H5 等。
TTT 能力详细说明。
基础库与客户端
不同版本客户端 App 会绑定一些基础库版本,当 App 唤起小程序的时候,会比对 App 绑定的基础库版本与小程序的基础库版本。如果向下兼容,则可以显示该小程序,否则会报错。
例如:
上传的小程序基础库版本为 2.0.22。
- 如果客户端 App v1.1 版本绑定的基础库版本是 2.0.20,低于了小程序的基础库版本,则报错无法进入。
- 如果客户端 App v1.2 版本绑定的基础库版本是 2.0.26,高于了小程序的基础库版本,则是向下兼容的。

Kit 包与客户端
客户端 App 可能集成了不同种类、不同版本的 Kit 包,所以 App 唤起小程序的时候,也会检查 App 是否兼容小程序需要的 Kit 包。
例如:
上传的小程序需要四个 Kit 包:
- BaseKit: 1.2.8
- MiniKit: 2.0.5
- TYKit: 1.3.1
- IndustryKit: 1.0.0
- 如果客户端 App v1.1 版本集成了 Kit 包只有 BaseKit、MiniKit、TYKit,缺少 IndustryKit 时,则报错无法进入。
- 如果客户端 App v1.3 版本集成了 BaseKit: 1.3.0 / MiniKit: 2.0.3 / TYKit: 1.5.1 / IndustryKit: 1.0.0,Kit 包种类虽然都涵盖,但是 MiniKit 2.0.3 的版本低于小程序指定的 MiniKit 2.0.5,则报错无法进入。
- 如果客户端 App v1.3 版本集成了 BaseKit: 1.3.0 / MiniKit: 2.0.5 / TYKit: 1.5.1 / IndustryKit: 1.0.0,Kit 包种类都涵盖,切版本高于小程序指定的 Kit 包版本,则兼容可进入。

在上线审批前,需要正确的配置域名及请求路径。
具体规则与配置方法请参考:上线审核
- 恭喜你 🎉 完成了本教程的学习!
- 有任何问题可以联系 Tuya MiniApp Team