#开发者工具常见问题

#Tuya MiniApp IDE 调试和真机调试有什么区别？如何选择？

Tuya MiniApp IDE 调试 是通过虚拟设备插件生成一个虚拟设备，并预置面板小程序所依赖的基础硬件及设备能力，便于开发者在 Tuya MiniApp IDE 里快速进行 UI 等绘制和还原。但是，无法实现所有 App 端侧所拥有的硬件或设备能力，比如扫码、电话之类的硬件环境以及 Mesh 直连之类的设备能力。因此，推荐以下用法：

1. Tuya MiniApp IDE 调试：开发初期，需要快速实现 UI 还原及基础的功能逻辑时。
2. 真机调试：开发中后期，已经完成基础的功能逻辑后，需要测试依赖 App 端侧的能力时。

#面板插件提示无权限

如下错误：

• MQTT 连接失败和模拟控制扫码失败。
• deviceId 无效与无权限的错误
• getDeviceInfo，getLaunchOptions 未实现
• 某些接口报请授权登录

请优先确定权限关系：

• 确认产品 id 存在于对应的空间下，且有操作权限。可到产品列表查询。
• 授权与空间的关系说明

如确定以上步骤没问题，可尝试以下步骤：

1. 确定 app 扫码授权的登录是否还有效
2. 确定 app 账号所在数据中心和开发工具所在的一致
3. 确定 设备工具 已经扫码授权，且和步骤 1 的 app 和账号是同一个
4. 尝试 设备工具 里的 解除绑定 功能，重新绑定一个虚拟设备
5. 点击 开发者工具顶部功能栏的 刷新按钮

#v1.4.0 以下面板插件版本如何操作？

通过真机调试，您可以在真实的 App 环境下调试对应的虚拟设备或真实设备。具体操作步骤见下。

1. 首先，获取到对应的 设备 ID，即 deviceId。您可在以下三种方式中，根据自己的情况选择任意一种方式来获取 deviceId。

• 从 Tuya MiniApp IDE 获取:

  • 在虚拟设备插件界面右侧，找到设备信息区块，单击 deviceId 右侧的 复制 按钮即可。

• 从涂鸦开发者平台获取:

  • 创建产品，若已创建可跳过。
  • 在涂鸦开发者平台，进入设备调试页面。
  • 在真实设备调试或虚拟设备列表中，选择需要调试的设备 ID。
  • 若没有可用设备，选择 新增真实设备调试 或 新增虚拟调试设备 增加可用调试设备，添加后选择对应的设备 ID 进行调试。

• 从 App 获取:

  • 打开智能生活 App 或 涂鸦开发者平台账号下的 OEM App，进入 App 首页。
  • 选择并单击需要调试的设备，进入设备调试页面。
  • 点击右上角 ··· 图标，进入设备设置页面。
  • 在设备设置页面，选择 设备信息，进入设备信息页面。
  • 页面第一行 虚拟 ID 即 deviceId。单击右侧的 复制 按钮，即可复制该 deviceId。具体操作见下图。

2. 在 Tuya MiniApp IDE 上方的点击 编译参数 按钮，按照下图格式中输入 deviceId 或 groupId，设置启动参数，其中，groupId 在群组设备调试时才会用到。

3. 在小程序内部，可以通过 getLaunchOptionsSync 或 getLaunchOptions，获取启动参数。

4. 使用智能生活 App 进行扫码，出现下图调试工具且连接状态正常。此时，真机调试就已经顺利完成。

#授权（登录）和权限相关

如果提示登录态失效，需要授权和扫码失效等字眼，请确保登录的正常，例如 app 扫码授权是否过期，app 账号和开发者工具是否在同个区，或者手动退出登录重新授权。

#在非常见的 Windows 系统上，如 Vista 等，无法运行应用，应该如何处理？

可以尝试用兼容模式与管理员模式来运行。

#无法打开开发者工具

确保系统环境

• Node.js 版本 >= 16.y.z
• 尽可能使用最新版本的 Microsoft Visual C++

安装过程中，请关闭杀毒软件，以免影响安装。或者注意查看杀毒软件是否拦截了安装过程中的文件。

#真机调试常见问题

#二维码失效

• 二维码只能使用一次，需要重新生成，请不要使用截图中的二维码。

#当前家庭不存在此群组

• Tuya MiniApp IDE 参数配置了 groupId，需要去 App 首页切换到有该群组的家庭下面。

#当前家庭不存在此设备

• Tuya MiniApp IDE 参数配置了 deviceId，需要去 App 首页切换到有该设备的家庭下面。

#已断连，请重新扫码调试

• 由于网络原因，可能会断开连接，需要手动关闭小程序，重新扫码调试。

#真机调试 1.0 app 加载失败

• 如果是智能小程序，确保不要在启动参数里带有 deviceId 和 groupId，否则会导致真机调试失败。

#远程真机调试 无权限

• 确保开发者工具的账户是有权限打开关联的小程序，有可能是切换了空间导致的没权限，也可能是账户没有权限。

#真机调试加载不出来 element 板块

• 真机调试 2.0 的右下边菜单栏有可以刷新的按钮
• 真机调试 1.0 只能切换 tag 来尝试，比如 console 和 element tag 来回切换

#windows 系统的错误

1. 

• 重新安装 ide，注意别被杀毒软件拦截了安装过程中的文件或者误杀，隔离文件夹下的文件。

2. 

• 确定 node 环境 > 18.0.0
• 升级 mvc++
• 升级显卡驱动

#其他无法解决的问题

请在涂鸦开发者论坛给我们留言。