打包发布
发布前需要确定发布的版本号,备注和上传多语言
在版本号旁边,可以看到当前的版本号,分别是 最新开发版
和 最新正式版
, 保持版本号递增即可。
打包流程
- 编译(build)
- 上传(upload)
- 如果开启上传多语言
- 对比平台的多语言和本地多语言文件,之后上传
- 智能小程序的多语言同步会有延迟
- 上传的包体积是有限制的:5MB
- 确保上传时的网络稳定
- 如果开启上传多语言
项目配置文件 project.config.json
project.config.json
文件是小程序项目的配置文件,用于配置项目的基本信息、构建配置、开发者工具配置等。
- devMode: 是否开启 ray 自动编译模式
ray
: 开启 ray 自动编译模式,npm
: 实际上就是执行 npm run start(package.json 里的 script)- 空字符串或者不配置: 需要自己手动编译
- remoteDebug: 调试模式
mqtt
: 使用远程模式,只需要在有网络的情况下即可lan
: 使用局域网模式,需要在开发者工具和 app 在同个网络下
- compileType: 编译类型
miniprogram
: 小程序widget
: 小部件
基础库
- 基础库的前置介绍
- 本地开发版本
- 最低可用版本
本地开发版本
本地开发版本是指在模拟器里运行时的基础库版本,可用于验证与调试最新的能力。 但选择的版本是 latest 时,会动态改用最新的基础库版本
最低可用版本
最低可用版本是指小程序在真机上运行时的基础库版本,也就是发布时的小程序版本。app 会根据规则加载对应的基础库版本。
Kit
kit 不会打包到小程序的包里,但是会影响 app 打开小程序时判断,从而下载适配的小程序
如果用版本在 v4.5.0 及以上的 App 进行真机调试,请选择对应的环境,具体如下:
- 基础库需要用 v2.10.x 及以上版本。
- Kits 需要用 v3.x.x 及以上版本。
- TYKit => BizKit,后续 TYKit 不再维护,请用 BizKit 代替。
自动更新
当对应版本(release 和 nightly)发现新版本时,会提示更新,如下图:
- 更新日志:查看官网的更新日志
- 确定:则开始 无感的自动升级。
- 跳过
- 确定:不再提示当前版本的更新
- 取消:下次再次提示更新
右上角会有下载的进度,在完成下载且 ide 关闭之后,则会自动安装,在下次打开 Tuya MiniApp Tools 时启动新版本。但如果关闭和打开 Tuya MiniApp Tools 的时间间隔很短,则取消安装,等待下一次。
- 如果想 快速使用新版本,也可以在右上角按钮提示为 重启&更新 时单击该按钮,IDE 会 自动关闭 后安装新应用,之后 自动打开。如果长时间没响应,可以重新手动打开 Tuya MiniApp Tools 或者关闭 Tuya MiniApp Tools 再打开重试。
Windows 系统更新 常见问题
- 因为 windows 系统权限的特殊性,如果提示
当前用户没权限修改开发者工具的文件夹
, 可以尝试以下方法之一:- 可找到安装目录,右键属性,安全,编辑,选中当前用户,勾选完全控制。
- 卸载后重新安装,选择安装在当前用户的目录下。
- 安装目录一般在类似下面的路径:
C:\Program Files\Tuya MiniApp Tools
(所有用户,系统域)C:\Users\{用户名}\AppData\Local\Programs\Tuya MiniApp Tools
(当前用户,用户域)
- 老版本的开发者工具会默认安装在路径 1,新版本(0.7.0)的开发者工具可以选择安装在不同的路径,推荐是路径 2,这样可以避免权限问题。
- 安装目录一般在类似下面的路径:
如何反馈问题?
一般可以提供一下信息给开发者人员:
- 日志:主要是编译时的输出,一般在如下情况需要提供
- 进入项目
- 真机预览
- 发布
- 日志文件:获取方式见下文
途径:
- 论坛:Tuya开发者社区
- 工单
- 官方群
日志文件
- 如果开发者工具的日志目录出现问题,可以反馈给开发者人员,排查问题。
- Mac
/Users/用户名/Library/Application Support/tuya-ark-ide/logs
- Windows
C:\Users\用户名\AppData\Roaming\tuya-ark-ide\logs
- Mac
👉 立即免费领取开发资源,体验涂鸦 MiniApp 小程序开发。