小程序开发工具—— Tuya MiniApp Tools 发布、配置、更新等详解

打包发布

发布前需要确定发布的版本号，备注和上传多语言

在版本号旁边，可以看到当前的版本号，分别是 最新开发版 和 最新正式版, 保持版本号递增即可。

打包流程

1. 编译（build）
   • 如果编译的时候出现问题，可以查看日志来定位问题
   • 问题无法解决，可以截图日志，且找到日志文件，然后提工单
2. 上传（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 的前置介绍

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 系统权限的特殊性，如果提示 当前用户没权限修改开发者工具的文件夹, 可以尝试以下方法之一：
  1. 可找到安装目录，右键属性，安全，编辑，选中当前用户，勾选完全控制。
  2. 卸载后重新安装，选择安装在当前用户的目录下。
     • 安装目录一般在类似下面的路径：
       1. C:\Program Files\Tuya MiniApp Tools（所有用户，系统域）
       2. 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

 👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。