---
title: 真机调试
summary: 介绍真机调试功能的使用方法，包括自定义参数、设备工具、客户端版本要求和调试器的使用。
questions:
  - 真机调试有哪几种模式？
  - 面板小程序真机调试时必须携带什么参数？
  - 如何通过设备工具自动获取 deviceId？
  - 远程模式需要什么版本的智能生活 App？
  - 局域网模式需要什么版本的智能生活 App？
  - 真机调试时如何自定义启动参数？
  - 真机调试支持热更新吗？
  - 使用 v4.5.0 及以上的 App 调试需要注意什么？
  - 基础库和 Kits 版本有什么要求？
  - TYKit 和 BizKit 是什么关系？
---

## 概述

Tuya MiniApp IDE 远程调试可以实现在真机上运行小程序，在工具里查看与调试的能力。远程调试可以尽可能的模拟真实的运行环境。 

<Image 
  src="/images/ide/new/13.png" 
  style={{
      borderRadius: '10px',
      boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    }}
/>

## 前置步骤

### 自定义参数

某些条件下，在进入小程序的时候需要携带相关初始化信息，通过编译参数可以指定进入首页以及参数。自定义启动参数，在小程序内部通过 App 的 `onLaunch` 获取值。
 - 如果小程序是面板，真机调试时必须携带 `deviceId` 参数。
 - `deviceId` 也可以通过设备工具自动获取与填写

<Image 
  src="/images/ide/new/14.png" 
  style={{
      borderRadius: '10px',
      boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    }}
/>

### 设备工具

启用设备工具，关联设备后，会自动填写 `deviceId` 参数。

<Image 
  src="/images/ide/new/15.png" 
  style={{
      borderRadius: '10px',
      boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    }}
/>


### 客户端接入


<Image 
  src="/images/ide/remote-3.png" 
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)',
    width: '300px',
  }}
/>


真机调试有 2 个模式：远程模式和局域网模式
* 远程模式：使用智能生活 v4.1.0 以上，（v.5.0 及以上版本需要特殊处理，详情请看底下的提示）。
* 局域网模式：需要 IDE 和 智能生活 在同个局域网下，且 智能生活 版本在 5.18.0 以上。




## 调试器

### 视图


<Image 
  src="/images/ide/new/16.png" 
  style={{
    borderRadius: '10px',
    boxShadow: '0 0 5px rgba(0,0,0,0.3)'
  }}
/>


### 热更新

开发者更新代码保存后，小程序容器将自动重启更新变化的内容。

## Tips

如果用版本在 v4.5.0 及以上的 App 进行真机调试，请选择对应的环境，具体如下：

- 基础库需要用 v2.10.x 及以上版本。
- Kits 需要用 v3.x.x 及以上版本。
- `TYKit` => `BizKit`，后续 `TYKit` 不再维护，请用 `BizKit` 代替。