真机调试

收藏

我的收藏

•​调试二维码生成后，请使用抖音扫码进行调试。​

•​Android 调试请确保抖音版本为 27.1.0 及以上版本。​

•​iOS 调试请确保抖音版本为 27.1.0 及以上版本​​

​前置条件 - 获取调试权限​

•​为当前开发者账号绑定抖音账号。​

•​成为小程序协作者，并具备“IDE 权限”。​

•​加入小程序的测试账号列表。​

​为当前开发者账号绑定抖音号​

•​绑定是一次性操作，绑定后不会再做此提示。目前绑定成功后无法解绑，请勿使用他人抖音号绑定（后续会支持账号合并或解绑，目前暂未支持）。​

•​若开发者账号先由邮箱或手机注册获得，后使用抖音号扫码注册了新账号，那么该抖音号无法用于绑定至先前创建的开发者账号，绑定过程中会遇到绑定冲突，此时开发者可以重新创建一个抖音号绑定。​

•​若开发者账号由抖音扫码注册创建，则无需绑定抖音号。​

•​绑定后，模拟器将使用该抖音号作为用户标识。​

•​使用“测试号”开发时，预览或真机调试前必须绑定抖音号。​

​成为小程序协作者，并具备“IDE 权限”​

•​登录开发者运营平台。​

•​点击【右上角用户名】-【账号中心】-【成员协作】- 选择要添加权限的小程序 - 点击【添加成员】- 输入被添加开发者的用户名 - 选择【协作者】角色- 选择【IDE 权限】- 点击【添加】。​

​加入小程序的测试账号列表​

•​登录开发者运营平台。​

•​进入【控制台】- 【xxx 小程序详情】-【开发】-【开发配置】-【测试设备管理】。​

•​击【扫码添加】，显示二维码，使用需要获取权限的抖音号扫码加入。​

•​扫码后抖音号将自动展示在列表中。​

​调试步骤​

​扫码调试​

​推送调试器​

​局域网快速调试​

​清除缓存​

​打开调试控制台配置​

1.​加入测试设备后，在抖音客户端中点击【我】- 底部【更多功能】，在底部找到 【开发者模式】并点击，进入开发者模式页面。首次加入测试账号时会自动引导跳转到该页面。​

2.​打开调试控制台：点击想要调试的小程序 - 打开调试控制台​

​使用清除缓存功能​

1.​重新开始预览或者调试。​

2.​右上角点击更多 - 弹出面板中点击清除缓存。​

3.​将会清理以下缓存，清除完成后，以当前启动参数，冷重启小程序：​

a.​数据缓存​

b.​登录缓存​

c.​授权缓存​

d.​webview缓存​

e.​cookie缓存​

f.​本地文件缓存​

​Bug & Tip​

•​暂不支持 RegExp.$1 $2 … $n 属性，相关问题。​

•​Taro 内部使用了 JS 引擎未定义的行为导致的白屏问题（解决方案：升级至 3 .5.4 以上），相关问题。​