在安卓设备上使用 Chrome 远程调试功能

你的网页内容在移动设备上的体验可能和电脑上完全不同。Chrome DevTools 提供了远程调试功能，这让你可以在安卓设备上实时调试开发的内容。

安卓远程调试支持：

• 在浏览器选项卡中调试网站。
• 在原生安卓应用中调试网页内容。
• 将屏幕从你的安卓设备上投影到你的开发机器上。
• 使用端口转发和虚拟主机映射来让安卓设备访问开发使用的服务器。

需求

要开始远程调试，你需要：

• 安装 Chrome 32 或者之后的版本。
• 连接安卓设备用的 USB 线缆。
• 对于通过浏览器调试：安卓 4.0 以上并且安装了 Chrome for Android。
• 对于通过应用调试：安卓 4.4 以上并且应用包括可用于调试的 WenView 组件。

提示：远程调试需要你电脑端的 Chrome 版本要高于安卓端的版本。想更好地使用此功能，请使用电脑端的 Chrome Canary （Mac/Windows） 或者 Dev channel 发行版（Linux）。

设置安卓设备

请按照以下说明来设置安卓设备：

1. 打开 USB 调试选项

在安卓设备上，进入设置>开发者选项。

设置页面的开发者选项

注意：在安卓 4.2 及以后的版本中，默认情况下开发者选项是隐藏的。要启用开发者选项，选择设置>关于手机然后点击版本号7次。

在开发者选项中，选中 USB 调试复选框。

在安卓上启用 USB 调试

之后会有一个警告，提示你是否要开启 USB 调试模式。选择 OK。

2. 连接你的设备

将你的安卓设备和电脑用 USB 线连接起来。

注意：如果你在 Windows 下进行开发，那么你需要为你的安卓设备安装驱动。具体可以参考安卓开发者网站上的 OEM USB Drivers

在 Chrome 中找到设备

在安卓设备上设置好远程调试后，在 Chrome 中找到你的设备。

在电脑端的 Chrome 里，在地址栏输入 chrome://inspect。进入后确认 Discover USB devices 已经勾选了：

**提示**：你也可以从 Chrome menu > More tools > Inspect Devices 来进入 chrome://inspect

在你的设备上，会跳出一个警告，告诉你是否要允许在电脑端进行 USB 调试。选择 OK。

提示：如果希望以后不再弹出系那个管提示，勾选 Always allow from this computer

注意：在远程调试时， Chrome 会阻止你的设备进入休眠状态。该特性对于调试相当有用，但在安全性上有所欠缺。所以在调试的时候要注意看好你的手机！

在电脑端，打开选项卡并启用 WebViews 调试后，chrome://inspect 页面会显示全部已连接的设备。

从 chrome://inspect 也卖弄查看已连接的设备

如果从 chrome://inspect 页面查找设备时遇到了问题，请参考 Troubleshooting 章节。

调试远程浏览器

在页面 chrome://inspect 上，你可以加载 DevTools 并且调试你的远程浏览器。

要开始调试，请点击你希望调试的浏览器选项卡下面的 inspect。

接着你的电脑会加载新的 DevTools。在新的 DevTools 上，你可以在你的安卓设备上和选中的浏览器实时交互。

通过电脑上的 DevTools 来调试安卓手机上的网页

比如，你可以在你的设备上使用 DevTools 来监审查网页元素：

• 当你的鼠标悬浮在 Elements 面板中的某个元素上时，DevTools 会在你的设备上高亮显示相关元素。
• 你也可以点击 审查元素 然后点击设备的屏幕，DevTools 就会在 Elements 面板中让选中的元素高亮显示。

注意：你设备的 Chrome 版本将会决定远程调试中 DevTools 的版本。由于这个原因，你在远程调试时使用的 DevTools 可能和你平常使用的不大一样。

调试提示

下面是使用远程调试功能的一些提示：

• 按 F5（或者在Mac上 Cmd + r）来重新加载远程页面。
• 让设备的网络处于打开状态。使用 Network 面板来查看实际移动设备的网络流状态。
• 使用 Timeline 面板来分析提交数据和 CPU 使用状态。在移动设备上运行的程序通常会比在开发机器上运行的要慢一些。
• 如果你是在本地的 web 服务器上运行的，使用端口转发或者虚拟主机映射 技术来让设备访问你的站点。

调试 WebViews

在安卓 4.4 及后续版本中，你可以使用 DevTools 来调试原生安卓应用中的 WebView 的内容。

将 WebViews 配置为可调试状态

你的应用程序必须允许调试 WebView。要开启 WebView 调试，在 WebView 类里面调用静态函数 setWebContentsDebuggingEnabled。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
     WebView.setWebContentsDebuggingEnabled(true);
}

该设置对该应用中所有的 WebView 都会生效。

提示： WebView 的调试并不会受到应用中 manifest 文件的 debuggable 标签状态的影响。如果你想只有在 debuggable 为 true 时启用 WebView 调试，请在运行的时候测试该标签的状态。

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    if (0 != (getApplicationInfo().flags &= ApplicationInfo.FLAG_DEBUGGABLE))
    { WebView.setWebContentsDebuggingEnabled(true); }
}

在 DevTools 中打开 WebView

chrome://inspect 页面会显示设备中所有可调试的 WebView.

要开始调试，点击你想调试的 WebView 下面的 inspect。接下来就像使用远程浏览器选项卡一样使用 DevTools。

使用 Chrome DevTools 来调试远程安卓 Webview

在 WebView 中列出的灰色图片表示其大小以及相对设备屏幕的大小。如果你的 WebView 有设置名称，那么其名称也会列出来。

实时截屏

要在两个屏幕间不断转移注意力是相当不方便的。Screencast 将你设备的屏幕显示在开发机上的 DevTools 右侧。你也可以在 screencast 中与你的设备进行交互。

在 KitKat 4.4.3，screencast 既可以给浏览器选项卡使用也可以给安卓 WebView 使用。

开启截屏会话

要开启 screecast，点击远程调试窗口右侧上方的 Screencast 图标。

Screecast 图标

Screencast 面板在左侧打开并且显示设备屏幕的实时状况。

在你的电脑上与你的安卓设备实时进行交互

截屏只会显示网页内容。该截屏的透明部分涵盖了多功能框、设备键盘以及其他设备接口。

注意：由于截屏会连续捕获帧，会造成不小的性能开销。如果你的测试是对帧速率敏感的，最好禁用截屏。

使用截屏来与设备交互

当你使用截屏来互动的时候，点击会被转换为触屏，会在设备上触发适当的触控事件。电脑端的按键会发送到设备，这样就可以避免使用大拇指来打字。

其他的 DevTools 工作也可以在截屏上使用。例如，要检查元素，点击 Inspect Element 然后在截屏内点击就可以查看网页源码中对应部分。

要模拟一个缩放手势，拖动鼠标的时候按住 Shift。要在页面上滚动，使用你的触控板或者鼠标滚轮，也可以拖动鼠标指针。

端口转发

你的手机不一定所有时候都能直接连接到你开发用的服务器。他们可能处于不同的网络环境下，此外，你也可能在一个受限的企业网络下进行开发。

Chrome for Android 上的端口转发使得在移动设备上测试你所开发的站点变得轻松很多。其工作原理是在你的移动设备上创建一个监听 TCP 端口，该端口映射到你的开发机器上的一个指定 TCP 端口。这些端口之间的流量通过 USB 来传输，因此该连接不需要依赖于你的网络环境。

要启用端口转发：

1. 在你开发用的机器上打开 chrome://inspect。
2. 点击 Port Forwarding。下面是端口转发的设置页面。
   
3. 在 Device port 后面输入你的安卓设备希望监听的端口号（默认是8080）。
4. 在 Host 后面输入你的 web 应用运行环境的 IP 地址（或者主机名称）以及端口号。
5. 检查 Enable port forwarding 是否已经勾选。
6. 点击 Done 来完成设置。

端口转发设置

当端口转发开启成功时，chrome://inspect 页面的端口状态将会显示为绿色。

使用端口转发来在你的安卓设备上查看本地网页

现在你可以打开一个新的 Chrome for Android 选项卡并且在你的设备上查看本地服务器的内容。

虚拟主机映射

当你在 localhost 域名上进行开发的时候，端口转发非常有效。但是有些情况下你可能需要是哟高自定义的本地域名。

例如，假设你正在使用的第三方 JavaScript SDk 只有在白名单上的域名中才能运行。所以你需要在你的端口文件中加入一个进入点，比如 127.0.0.1 production.com。又或者你需要在你的 web 服务器上通过虚拟主机来设置特定的域名。

如果你想让你的手机能够访问到你自定域名上的内容，你可以结合端口转发和代理服务器技术。代理会把来自设备上的请求映射到主机上的相应位置。

在代理上使用端口转发

虚拟主机映射要求你在主机上开启一个代理服务器。所有来自你的安卓设备的请求都会发送到这个代理上。

要在代理上使用端口转发：

1. 在主机上安装代理软件，比如 Charles Proxy 或者 Squid。

2. 运行代理服务器，要记住该服务器使用的端口号。

   ---

   注意：代理服务器和你开发用的服务器必须在不同的端口上运行.

   ---

3. 在 Chrome 浏览器中，进入 chrome://inspect。

4. 点击 Port forwarding。下面是端口转发设置页面。
   
5. 在 Device port 后面输入你的安卓设备希望监听的端口号。使用安卓允许的端口，比如 9000.
6. 在 Host 处输入 localhost:XXXX，其中 XXXX 是你的代理服务器占用的端口号。
7. 检查 Enable port forwarding 是否已经勾选。
8. 点击 Done 来完成设置。

代理服务器的端口转发

在你的设备上设置代理

你的安卓设备需要和主机上的代理服务器交互。

要在你的设备上设置代理：

1. 选择 设置 > WiFi。

2. 长按你当前连接的网络。

   ---

   注意：代理设置适用于所有网络.

   ---

3. 点击修改网络。

4. 选择高级设置。
   代理设置页面如下：
   
5. 点击代理菜单并选择手动。
6. 在代理主机名处输入 localhost。
7. 在代理端口号处输入 9000。
8. 点击保存。

通过这些设定，你的设备会将它所有的请求都发给代理服务器。该代理代表你的设备发出新的请求，故而对你本地特定域名的请求会被合理地解析。

现在你就可以像在主机上那样在 Chrome for Android 上加载本地域名了。

使用虚拟主机映射技术来在安卓设备上访问特定的本地域名

提示：要恢复正常的浏览模式，在断开连接后将设备上的代理设置还原就可以了。

常见问题

我在 chrome://inspect 页面无法看到我的设备

• 如果你在 Windows 下进行开发，请确认你是否安装好了你的设备所对应的驱动。安卓开发者网站上的 OEM USB Drivers 可供参考。
• 确认你的设备是否直接或者通过集线器连接到了你的主机上。
• 确认设备上 USB 调试模式 有没有打开。记得在提示是否允许 USB 调试的时候选择是。
• 在电脑上打开 chrome://inspect 并确认 Discover USB devices 有没有勾选。
• 远程调试要求你电脑上的 Chrome 版本高于安卓设备的。尽量使用 Chrome Canary（Mac/Windows）或者 Dev channel 发行版（Linux）。

如果你仍然无法看到你的设备，请断开设备与主机的连接。然后在你的设备上，打开 设置 > 开发者选项。选择撤销 USB 调试授权。然后重新尝试设置设备以及在 Chrome 中查找设备。

在 chrome://inspect 页面中我无法看到我的浏览器选项卡

• 在你的设备中，打开 Chrome 浏览器并进入到你想调试的页面。然后刷新 chrome://inspect 页面。

我无法在 chrome://inspect 页面中看到我的 WebView

• 确认WebView 调试模式在你的应用中已经启用。
• 在你的设备上，启动应用并打开你想调试的 WebView。然后，刷新 chrome://inspect 页面。

在我的安卓设备上我无法访问 web 服务器

• 如果是网络限制条件导致你的设备无法连接到开发用的服务器，请尝试端口转发或者虚拟主机映射。

最后，如果远程调试仍然无法工作，你可以使用 Android SDK 中的 adb 二进制包将你的工作流恢复到最近的状态。