远程调试说明文档

WDB（WeTest Debug Bridge）是由WeTest平台提供的统一远程调试工具。程序为跨平台的二进制文件，可直接下载使用，比如windows下的cmd/cmder/powershell，MacOS下的Terminal/iTerm2等。

一、下载地址

Mac
Windows
Linux

二、使用前请注意

1、wdb支持同时连接WeTest远程的安卓和iOS设备
2、如果在Linux/MacOS上使用，请先手动备份/var/run/usbmuxd进程，wdb第一次启动时，也会自动对系统中原先已存在的/var/run/usbmuxd进行备份

3、如果在Windows上使用 请在cmd里执行如下命令，关闭Apple Mobile Device Service服务，如没有安装iTunes，请忽略
net stop "Apple Mobile Device Service

三、使用步骤

1、开云手机远程调试后，在Web界面根据自身电脑操作系统，下载对应的WDB工具。如果是Mac或Linux环境，下载后请参考下文常见问题部分进行设置

2、复制命令到终端，执行命令 ,如果是第一次执行WDB相关命令，WDB会自动拉起wdb server，默认端口为5038。

如果端口已被占用，根据提示设置WDB_SERVER_PORT环境变量，或者通过指定参数-p port来设置wdb server的端口，如果通过-p设置端口，后续执行WDB相关命令，都必须通过-p指定端口，建议通过设置WDB_SERVER_PORT环境变量的方式来设置自定义端口。

3、连接成功后

• 安卓设备：wdb会将adb连接forward到本地端口，通过adb devices可以看到，本地forward的端口已经自动连接，后续通过adb操作本地127.0.0.1:40000端口设备即可操作远程设备
  
• iOS设备：通过tidevice工具，执行tidevice info 查看设备信息，通过tidevice等工具操作远程设备

4、若连接了多个远程设备，可以通过 wdb devices查看远程设备地址与本地端口的对应关系。可以通过 wdb devices查看远程设备地址与本地adb端口（安卓设备）或设备串号（iOS设备）的对应关系

5、若要断开连接，执行wdb disconnect命令（可指定远程地址，断开特定设备），安卓设备还会断开本地adb的对应连接

四、常见问题

Mac环境

1、运行wdb如果出现 command not found问题？
请先执行 chmod +x wdb

2、若执行任意wdb命令时弹出"无法打开wdb，因为无法验证开发者"的弹窗

请前往系统设置 - 安全性与隐私，进行允许

3、再次执行wdb命令，确认打开

Linux环境

1、给wdb增加可执行权限 chmod +x wdb

Windows环境

1、运行wdb 命令，如果出现“’wdb’不是内部或外部命令，也不是可运行的程序”提示？

在存放wdb.exe文件的目录下运行命令，即在该文件的文件夹地址中输入cmd，回车后进入到cmd命令行操作工具

再次运行wdb命令