真机调试
收藏我的收藏
收藏为了便于开发者在真实移动设备上对抖音 App 中的小程序进行调试，开发者工具提供了真机调试功能。
注意：
- •调试二维码生成后，请使用抖音扫码进行调试。
- •Android 调试请确保抖音版本为 27.1.0 及以上版本。
- •iOS 调试请确保抖音版本为 27.1.0 及以上版本
视频教程
前置条件 - 获取调试权限
预览或真机调试前，需要先获取当前小程序的调试权限，以下三种条件满足其一即可具备调试权限 （“测试号”除外）：
- •为当前开发者账号绑定抖音账号。
- •成为小程序协作者，并具备“IDE 权限”。
- •加入小程序的测试账号列表。
详细的操作步骤与注意事项见下方。
为当前开发者账号绑定抖音号
通过邮箱或手机号注册的开发者账号，未绑定抖音时，在点击预览后 IDE 会弹出绑定抖音账号的提示，如图所示。开发者打开抖音扫码绑定即可。
绑定的一些注意事项：
- •绑定是一次性操作，绑定后不会再做此提示。目前绑定成功后无法解绑，请勿使用他人抖音号绑定（后续会支持账号合并或解绑，目前暂未支持）。
- •若开发者账号先由邮箱或手机注册获得，后使用抖音号扫码注册了新账号，那么该抖音号无法用于绑定至先前创建的开发者账号，绑定过程中会遇到绑定冲突，此时开发者可以重新创建一个抖音号绑定。
- •若开发者账号由抖音扫码注册创建，则无需绑定抖音号。
- •绑定后，模拟器将使用该抖音号作为用户标识。
- •使用“测试号”开发时，预览或真机调试前必须绑定抖音号。
成为小程序协作者，并具备“IDE 权限”
该操作的目的是获取在 IDE 中预览、真机调试小程序的权限。
- •登录开发者运营平台。
- •点击【右上角用户名】-【账号中心】-【成员协作】- 选择要添加权限的小程序 - 点击【添加成员】- 输入被添加开发者的用户名 - 选择【协作者】角色- 选择【IDE 权限】- 点击【添加】。
加入小程序的测试账号列表
如果登录用户不具备该页面权限，可以联系小程序管理员按以下步骤操作。
- •登录开发者运营平台。
- •进入【控制台】- 【xxx 小程序详情】-【开发】-【开发配置】-【测试设备管理】。
- •击【扫码添加】，显示二维码，使用需要获取权限的抖音号扫码加入。
- •扫码后抖音号将自动展示在列表中。
调试步骤
扫码调试
打开开发者工具，单击工具栏上的【真机调试】按钮，默认为扫码调试使用抖音 App 的扫一扫功能扫描二维码成功后，电脑端自动打开真机调试窗口。
推送调试器
切换至推送调试，使用抖音 App 的扫一扫功能扫描二维码，并且在手机上进行确认进行调试。
等待一段时间，抖音 App 内自动打开小程序，电脑端自动打开真机调试窗口。
局域网快速调试
设备和开发者工具在同一局域网中时，请优先使用局域网快速调试。开启后可显著提高出码速度和连接稳定性。
清除缓存
打开调试控制台配置
- 1.加入测试设备后，在抖音客户端中点击【我】- 底部【更多功能】，在底部找到 【开发者模式】并点击，进入开发者模式页面。首次加入测试账号时会自动引导跳转到该页面。
- 2.打开调试控制台：点击想要调试的小程序 - 打开调试控制台
使用清除缓存功能
- 1.重新开始预览或者调试。
- 2.右上角点击更多 - 弹出面板中点击清除缓存。
- 3.将会清理以下缓存，清除完成后，以当前启动参数，冷重启小程序：
- a.数据缓存
- b.登录缓存
- c.授权缓存
- d.webview缓存
- e.cookie缓存
- f.本地文件缓存
Bug & Tip
由于技术上的限制，目前「IDE iOS 真机调试」使用的 JS 运行时与「IDE 预览扫码」或者「直接打开线上 / 测试版小程序」有一定的差异，对应问题官方正在修复支持中，开发者可以自行替换部分实现，或者在对应场景下使用「IDE 预览扫码」替代，或者使用 Android 真机调试。
- •暂不支持 RegExp.$1 $2 … $n 属性，相关问题。
- •Taro 内部使用了 JS 引擎未定义的行为导致的白屏问题（解决方案：升级至 3 .5.4 以上），相关问题。
