1. 为什么电视调试比手机更依赖ADB远程连接先讲个我自己的场景。有段时间我在做一款电视端的视频应用公司测试间里放着一台老款创维电视和一台杂牌机顶盒。每次改完代码要么拿U盘拷APK要么把设备从电视柜后面拽出来插USB线。电视不像手机USB口往往在背面或者侧面接口位置刁钻不说很多盒子甚至只留了一个供电口想插数据线都没地方插。折腾几次下来我就想明白了在电视这类设备上做开发远程ADB不是可选项而是刚需。Android TV本质上就是跑在电视上的Android系统只是交互方式从触摸换成了遥控器硬件形态从手持设备变成了客厅设备。既然是Android系统ADBAndroid Debug Bridge安卓调试桥这套完善的调试工具链就完全适用于电视。区别在于手机调试时大家习惯用USB线直连而电视因为物理接口和摆放位置的问题USB调试体验非常糟糕无线ADB才是真的主场。远程调试真正解决的不只是不用插线这一个麻烦它改变的是整个调试节奏。以前我改一行代码从编译到跑在电视上至少得五分钟编译完拷U盘、拔U盘、走到电视前、插上、用遥控器找文件管理器、点击安装、退回桌面打开应用。现在adb install命令敲下去几秒钟应用就装好了应用崩溃了adb logcat直接把堆栈捞回来界面布局不对uiautomator dump把View层级导出来逐行分析。这种坐在工位上完成整个联调的体验一旦用上就回不去了。这篇文章我打算把整个链路完整过一遍电视端怎么开开发者模式、电脑端怎么配ADB环境、局域网里怎么建立连接、连上之后哪些命令在电视场景下最实用、以及最常见的连接失败和授权问题怎么排查。不管你是做Android TV原生开发的还是在折腾电视盒子、投影仪、车机这类Android设备这套流程都能直接照抄。2. 电视端准备开启开发者模式和ADB调试开关远程调试的第一步不是敲命令而是先把电视端的门打开。这部分坑特别多因为Android TV作为一个量产消费产品各家厂商对开发者选项的态度完全不一样有的跟原生Android一模一样连续点击版本号就解锁有的干脆把入口藏起来甚至直接把ADB功能砍掉了。我分三类讲覆盖市面上绝大多数设备。2.1 开发者模式的三种常见入口第一类是原生Android TV / Google TV系统比如Sony电视、NVIDIA Shield这类。路径很标准设置 - 系统 - 关于 - 版本号对着版本号连续按OK键7次左右系统会提示您已进入开发者模式。然后回到设置 - 系统 - 开发者选项把USB调试开关打开。原生系统通常还会有个网络调试选项但实测很多版本的Android TV并不显示这个开关因为无线ADB本来就不依赖这个选项只要ADB开关开了同一局域网内就能连。第二类是国产电视创维、海信、TCL、小米电视这些。路径一般是设置 - 通用设置 - 关于 - 版本号连点也有一部分机型藏在系统信息里的内部版本号上。小米电视稍微特殊它用的是设置 - 关于 - 版本号连点7次解锁解锁后回到设置 - 账号与安全把ADB调试开关打开。创维的入口变化比较大老款机型有的在设置 - 系统 - 开发者选项里直接就有ADB开关有的则需要通过工厂菜单进入具体型号差异很大。第三类是电视盒子比如当贝、泰捷、小米盒子这些。盒子系统一般基于Android TV或手机版Android改的开发者选项通常都在设置 - 关于 - 版本号连点。但机顶盒市场的系统集成商非常多有些精简系统直接把开发者选项整个拿掉了这种情况要么刷对应固件要么用遥控器组合键或者特定APK调出隐藏入口。还有一类是运营商送的IPTV盒子这类设备ADB功能经常被锁死网上流传的强制ADB方案本质是利用系统漏洞提权或者刷第三方固件风险较高量产设备上我不建议普通用户盲目尝试。2.2 网络环境检查同一局域网和AP隔离问题设备端ADB开关打开之后还有一个容易被忽略的环节网络环境。无线ADB走的是TCP/IP协议电脑和设备必须能互相访问到对方。最直观的要求就是两者在同一个局域网内电视连着WiFi笔记本电脑也连着同一个WiFi通常就满足条件。但有两个例外情况容易踩坑。第一个是路由器开了AP隔离模式很多家庭路由器和公共WiFi会默认开启这个功能它会让同一个WiFi下的设备之间无法互相通信。判断方法很简单手机连着家里WiFi能不能访问电视的IP如果连ping都ping不通基本就是被隔离了。第二个是电视插了网线而电脑用的是WiFi虽然两个设备在同一个路由器下但不同网段之间可能没有互通。我遇到过好几次这种情况电视用有线连接电脑用无线连接ADB一直connect timeout最后发现两个设备压根不在一个网段里给电视换成WiFi连接才解决。这里补充一句如果你控制不了网络环境比如在酒店或者客户现场调试还有一个土办法自己带一个无线路由器把电视和电脑都接到这个路由器的网络下组成一个独立的小局域网实测这个方案最稳不受现场网络配置限制。2.3 拿到电视的IP地址和设备型号信息在电脑上连接电视之前需要先知道电视的IP地址。路径一般是设置 - 网络 - 网络状态/查看网络信息页面上会显示IP地址和MAC地址。记下来形如192.168.1.100这种格式。如果电视的网络页面不直接显示IP也可以去路由器后台看一眼DHCP客户端列表通过主机名或者MAC地址找到电视。还有一个办法是装一个局域网扫描工具在电脑上扫描整个网段识别出Android设备或者电视品牌对应的MAC前缀。顺手记一下电视的型号和Android系统版本这两个信息在后续排查问题时非常有用。在设置 - 关于里能看到设备名称、Android版本号、内核版本等信息版本号不同ADB的行为和兼容性会有细微差异。3. 电脑端ADB工具链安装与连接验证电视端的门打开了接下来是电脑侧的工具准备和连接验证。ADB工具本身不复杂但它对路径、版本、驱动这些细节比较敏感尤其是Windows环境下很多新手卡在command not found或者adb不是内部或外部命令这个阶段。3.1 下载Platform Tools并配置环境变量ADB工具包含在Google官方的Platform Tools压缩包里支持Windows、macOS、Linux三大平台。下载之后解压到一个固定目录比如Windows下解压到D:\platform-toolsmacOS下解压到~/platform-tools。然后配置环境变量目的是让你在终端的任意目录下都能直接敲adb命令不需要每次都cd到platform-tools目录。Windows环境变量配置路径右键此电脑 - 属性 - 高级系统设置 - 环境变量在系统变量里找到Path编辑并新增一条D:\platform-tools确定保存后重新打开命令行窗口生效。macOS和Linux则在~/.zshrc或~/.bashrc里加一行export PATH$PATH:~/platform-tools然后执行source ~/.zshrc。配置完成后验证一下终端里输入adb version如果输出了Android Debug Bridge version 1.0.xx这样的版本信息说明工具链安装成功。这里提醒一句尽量用官方原版工具不要用各种一键安装版或者第三方打包工具因为工具版本过旧会导致部分新命令不可用第三方打包版还容易夹杂多余的程序。macOS用户第一次运行adb可能会遇到无法打开因为无法验证开发者的提示这是因为Platform Tools没有经过App Store公证。解决办法是去系统设置 - 隐私与安全性里点仍要打开或者在终端执行sudo xattr -d com.apple.quarantine ~/platform-tools/adb。Windows用户如果遇到找不到设备驱动的情况通常是电视或者盒子需要单独安装ADB驱动不过走无线连接的话驱动问题会少很多因为无线ADB认的是TCP端口而不是USB设备。3.2 首次连接adb connect命令和电视弹窗授权工具准备好之后开始连接。命令格式是adb connect 电视IP:5555其中5555是ADB默认的调试端口。我一般这样操作adb connect 192.168.1.100:5555 connected to 192.168.1.100:5555看到connected提示后不要急着高兴先验证一下设备状态adb devices List of devices attached 192.168.1.100:5555 device设备状态是device表示连接正常可以开始调试了。如果显示unauthorized说明电视上弹出了授权确认框需要你手动允许。这是Android的RSA密钥指纹授权机制首次连接一个新设备时系统会要求你在设备端确认是否信任这台电脑。电视端那个弹窗长什么样通常是一个对话框写着允许USB调试吗下面有取消和确定两个按钮有些电视还会显示电脑的RSA密钥指纹。记得勾选始终允许使用这台计算机进行调试再点确定免得下次重连又弹一次。这里有个容易忽视的点因为这是电视必须用遥控器操作电视的弹窗有时候不会自动获得焦点你需要先用遥控器按两下方向键再点确定我第一次搞的时候遥控器按了半天没反应以为卡死了。授权完成之后再执行adb devices应该就变成device状态了。如果还是unauthorized可以试试先把连接断开再重新连接adb disconnect 192.168.1.100:5555 adb connect 192.168.1.100:5555还有一种情况电视上根本没有弹出授权框连接状态一直是unauthorized。这个通常是电视端的ADB授权服务异常可以看后面排查那一节这里先不展开。3.3 理解设备状态的几种含义adb devices输出的状态不同的词代表不同的问题阶段我把它们整理成一张表方便排查状态含义处理方向device正常连接已授权可执行调试直接开始调试unauthorized已连通但设备端未授权在电视上确认授权弹窗offline设备已连接但ADB通信异常断开重连必要时重启ADB服务no devices没有任何已连接设备检查adb connect命令和IPconnect timeout连接超时检查IP、网络隔离、电视ADB开关理解这几个状态很重要因为后续所有连接问题最终都会落到这几种状态上。遇到问题先跑adb devices看一眼状态再决定往哪个方向查比盲猜IP要高效得多。4. 常用ADB命令按调试场景拆解连接建立之后真正值钱的部分来了。我按日常开发中最高频的几个调试场景把命令一个一个过一遍每条命令都给实际用法和注意事项。这些命令我在电视开发里几乎每天都在用含金量很高。4.1 安装与卸载APK彻底告别U盘电视应用安装是最高频的操作。传统方式是U盘拷贝再手动安装远程调试之后一切都在命令行里完成adb install -r C:\build\app-release.apk-r参数表示覆盖安装保留应用数据适合在已有版本上更新测试。如果是全新安装不带-r也行。大体积APK比如几百兆的游戏包安装耗时较长电视性能参差不齐耐心等安装进度条走完。安装完成之后如果想验证版本是否装对adb shell dumpsys package com.example.myapp | grep versionName用包名替换com.example.myapp即可。卸载则是adb uninstall com.example.myapp如果你需要在一台电视上批量安装多个APK可以写一个简单的循环脚本。Windows的bat版本echo off for %%f in (*.apk) do ( echo Installing %%f... adb install -r %%f ) pausemacOS/Linux的bash版本for f in *.apk; do echo Installing $f... adb install -r $f done实测这个方式在电视整机测试、门店设备批量部署这些场景下特别实用。4.2 截图与录屏调试证据随手留存电视端应用出bug最直观的证据就是屏幕画面。截图命令有个容易踩坑的细节我单独拎出来说一下。很多人一开始会用adb shell screencap -p /sdcard/screen.png adb pull /sdcard/screen.png这两条命令能截图但效率低要走两步。更快的方案是一条命令直接把截图输出到电脑adb exec-out screencap -p screen.png注意这里有个Windows用户必踩的坑如果用adb shell screencap -p screen.pngWindows终端在做输出重定向的时候会把换行符从LF转换成CRLF导致生成的PNG图片损坏打开提示文件格式无效。用exec-out替代shell可以绕过这个问题因为exec-out会以二进制模式直接输出原始数据。macOS和Linux用户不太会遇到这个坑但为了统一习惯我建议所有平台都用exec-out写法。录屏命令也常用特别是复现一些偶现的崩溃或者动画问题adb shell screenrecord --bit-rate 4000000 --time-limit 60 /sdcard/demo.mp4然后拉回电脑adb pull /sdcard/demo.mp4--bit-rate控制码率默认是4Mbps画面复杂时建议调高到8Mbps以减少模糊--time-limit最大支持180秒。4.3 抓取日志logcat的过滤和定位技巧应用崩溃、ANR、接口报错全靠日志定位。logcat命令的输出量非常大直接跑adb logcat不加过滤日志滚动的速度快到根本看不清。我的使用习惯是先清空缓冲区再复现问题最后抓取过滤后的日志adb logcat -c清空缓冲区之后在电视上操作复现bug然后抓日志。最常用的过滤方式是按包名做PID过滤adb logcat --pid$(adb shell pidof com.example.myapp) -v time--pid参数直接指定进程ID只输出该应用相关的日志干净利落。如果你比较习惯老方式也可以先adb shell pidof com.example.myapp拿到PID再手动传给logcat。加了-v time之后每条日志前面会带上时间戳方便梳理事件时序。如果想抓崩溃现场logcat里搜索AndroidRuntime和FATAL EXCEPTION关键字adb logcat -v time | grep -E AndroidRuntime|FATALWindows的PowerShell用户把grep换成Select-Stringadb logcat -v time | Select-String AndroidRuntime|FATAL日志也可以直接存到文件里方便后续分析adb logcat -v time C:\logs\app_log_$(Get-Date -Format yyyyMMdd_HHmmss).txt这里顺带提一个电视场景的特殊点电视应用经常使用焦点Focus机制来响应遥控器操作如果焦点处理有问题日志里会出现大量Focus相关的警告定位这类问题时可以过滤focus关键字来缩小范围。4.4 文件推拉push和pull的电视路径规范电视上的文件操作和手机有些路径差异。push是把电脑文件推送到电视pull是把电视文件拉回电脑。adb push C:\test\test.mp4 /sdcard/Download/ adb pull /sdcard/Download/test.mp4 C:\test\电视的标准外部存储路径是/sdcard/很多国产电视会把USB设备挂载在/storage/或者/mnt/usb/下。在测试视频播放器或者本地媒体应用时我经常把测试视频推送到/sdcard/Movies/或者/sdcard/Download/目录因为这两个目录是媒体扫描服务默认监听的路径。推完之后执行一次媒体扫描让应用能发现新文件adb shell am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///sdcard/Download/test.mp4这个广播在部分Android TV上可能没有响应另一个更通用的办法是重启应用大部分播放器启动时会重新扫描媒体库。4.5 UI层级导出用uiautomator dump排查布局问题电视应用UI调试有个天然劣势没法像手机一样直接触摸查看控件边界。uiautomator dump是解决这个问题的利器它能把当前界面的控件层级结构导成XML文件adb shell uiautomator dump /sdcard/ui.xml adb pull /sdcard/ui.xml拿到XML文件之后用文本编辑器或者脚本解析能看到界面上每个控件的id、class、text、bounds坐标范围等信息。我在排查遥控器焦点问题时经常用它比如某个按钮按方向键跳不过去通过看XML里控件的bounds位置就能判断是布局重叠还是焦点顺序问题。有一点需要注意uiautomator dump在电视上的执行输出经常比较慢有时候需要几秒才能完成不要以为卡死了。另外在一些资源占用高的界面比如正在播放视频时dump可能会失败提示ERROR: could not get idle state这时候可以先暂停播放或者等界面稳定再执行。4.6 按键操作模拟无需遥控器的备用方案调试中偶尔会遇到遥控器不在手边的情况ADB可以直接模拟遥控器按键adb shell input keyevent 20 # 方向键下 adb shell input keyevent 22 # 方向键右 adb shell input keyevent 23 # OK/确认键 adb shell input keyevent 4 # 返回键 adb shell input keyevent 3 # Home键 adb shell input keyevent 85 # 播放/暂停DPAD_CENTER按键事件KEYCODE_DPAD_CENTER是23在电视上等价于遥控器的OK键。这一组命令在自动化测试、冒烟测试里都很常用尤其是需要连续操作电视界面的场景用脚本模拟按键比人手点遥控器稳定得多。5. 高频踩坑unauthorized、timeout和电视休眠断连远程ADB连接本身并不复杂但实际使用中总会遇到一些反反复复的怪问题。这一节我把最常踩的几个坑按排查链路完整写出来遇到类似问题能少走弯路。5.1 adb unauthorized的处理授权密钥的三个细节先讲最常见也最让人困惑的unauthorized。设备能ping通端口能连通但状态就是unauthorized。这个状态说明TCP层是通的问题出在应用层的密钥认证上。排查链路是这样的第一步看电视上有没有弹窗弹了就允许。第二步如果没弹窗可能是第一次连接时手滑点了取消或者弹窗被其他应用挡住了。第三步如果确认没弹窗重启一下电视端的ADB服务也就是把电视的USB调试开关关掉再打开。第四步还不行就同时重启电脑端ADB服务和电视端ADB开关电脑端重启命令是adb kill-server adb start-serverkill-server会清掉电脑端保存的所有已知设备的密钥状态重新连接时会触发一次全新的授权流程。实测这个命令能解决大部分授权状态异常的问题。另外有一个容易忽略的点如果你有多台电脑轮换着连同一台电视电视端会保存多台电脑的授权记录当记录的设备数量超过一定限制后新电脑连接时可能不会被正常弹窗。这种情况可以在电视端开发者选项里找撤销USB调试授权之类的选项清空所有已授权记录再重新连接。5.2 connect timeout和connection refused物理层的排查顺序connect timeout和connection refused虽然都连不上但含义完全不同。connection refused说明数据包能到达电视但电视上没有程序在监听5555端口大概率是电视的ADB开关没开或者电视系统版本没有启动ADB守护进程。connect timeout说明数据包根本没有到达电视问题出在网络链路上。遇到timeout我的排查顺序是先ping电视IPping不通就检查网络是不是同一个网段、路由器有没有开AP隔离ping通了就检查电视IP是不是变了电视用DHCP获取IP时重启后地址可能变化顺手在路由器后台确认一下IP没错再检查电视端ADB开关状态。还有一个隐蔽的情况有些电视在开启了网络待机后休眠状态下网络模块也会休眠导致设备假离线需要用遥控器唤醒电视再连接。如果用电视自带的以太网口连接排查思路一样另外注意有没有VLAN隔离或者防火墙策略。在办公网络或者酒店网络里设备间的互相访问经常被策略拦截。5.3 电视休眠和重启后的断连处理电视比手机更容易进入休眠状态而电视一旦深度休眠WiFi网卡很可能进入低功耗模式ADB连接会立刻断开。这个问题的根源在于Android的休眠策略和手机不一样电视的休眠是屏保关屏但是网络状态各家处理不一样。处理方案有三个层面。最简单的是调整电视的休眠策略在显示设置里把睡眠时间设置成从不或者尽量长的分钟数但量产电视不一定有这个选项。第二个方案是在调试期间保持屏幕常亮adb shell svc power stayon true这条命令让设备在充电状态下不休眠但电视一般不接USB线所以实际上未必生效。第三个方案是碰运气断开之后重新connectadb connect 192.168.1.100:5555如果电视的ADB守护进程还活着重连就能救回来。如果重连不上只能用遥控器唤醒电视再重连。为了减少这种烦恼我现在调试时都养成了习惯需要长时间跑测试就先在电视端把睡眠时间调长不用的测试间隙手动锁屏再唤醒尽量不给休眠断连的机会。5.4 老款电视和机顶盒的隐藏ADB入口老款电视和廉价机顶盒是ADB问题的重灾区。这部分设备的系统一般由方案商深度定制开发者选项要么被精简掉要么被改得面目全非。网上关于老款创维如何打开adb、机顶盒强制adb的讨论很多方法五花八门但归总起来就几条路。第一条路找系统设置里的版本号连点很多定制ROM虽然隐藏了开发者选项但解锁逻辑还是原生的只是入口位置换了。可以重点在设置 - 关于、设置 - 系统信息这些子菜单里找版本号、内核版本、软件版本这些字眼逐个尝试连点。第二条路有些遥控器有特定的组合按键或者工厂菜单入口比如音量减频道减菜单同时按住几秒这个因机型差异太大需要搜对应型号的方案。第三条路用系统自带的应用商店搜索开发者选项或者ADB开关类应用部分机型可以用这种方式打开隐藏设置项。坦率地说这些方法都只是碰运气。如果设备型号太老系统版本在Android 5.0以下或者方案商直接砍掉了ADB守护进程那远程调试这条路基本走不通。老设备的处理思路是放弃抵抗用物理方式调试或者直接换一台好调试的设备来开发把老设备当兼容性测试目标机而不是开发主力机。6. 进阶玩法多设备管理、启动调试和批处理脚本单台设备的调试跑通之后如果你需要同时管理多台电视、或者做自动化测试可以再往下看。这一节的技巧能让调试效率再上一个台阶。6.1 多台设备同时连接adb devices与-s参数测试团队经常遇到这种情况手边有三台电视、两台盒子需要同时往它们上面装应用或者分别查看日志。ADB支持多设备同时连接连完之后用adb devices查看所有设备列表adb devices List of devices attached 192.168.1.100:5555 device 192.168.1.101:5555 device 192.168.1.102:5555 device要对指定设备操作时用-s参数指定adb -s 192.168.1.101:5555 install -r app.apk adb -s 192.168.1.102:5555 shell screencap -p /sdcard/screen.png注意如果只有一台设备不加-s也没问题但多台设备同时连接时不带-s参数的adb命令会报错more than one device/emulator要求你必须指定目标设备。这个报错信息出现过无数次看到它就知道设备列表里不止一台机器。6.2 用脚本把重复操作变成一条命令多设备批量操作最适合脚本化。我写过一个简单的批处理脚本一键往所有已连接的电视上安装指定APK。Windows版本echo off setlocal enabledelayedexpansion set APK_PATHD:\build\app-release.apk for /f tokens1 %%a in (adb devices) do ( echo %%a | findstr : nul if not errorlevel 1 ( echo Installing to %%a ... adb -s %%a install -r %APK_PATH% ) ) pause这个脚本的逻辑是遍历adb devices输出用findstr过滤掉标题行和空行只对包含冒号的设备IP:端口格式执行安装。macOS/Linux版本更简洁#!/bin/bash APK_PATHbuild/app-release.apk for device in $(adb devices | awk NR1 $2device {print $1}); do echo Installing to $device ... adb -s $device install -r $APK_PATH doneawk NR1 $2device的意思是从第二行开始找状态为device的设备这样只有真正连接且已授权的设备才会被安装。实测这个脚本在门店几十台设备批量部署时效率提升非常明显。类似的思路还可以用来批量抓取所有设备的logcat、批量截图、批量拉取某个文件。你只需要把adb install换成对应的操作命令即可。6.3 把电视画面投到电脑上scrcpy的电视场景用法最后分享一个我非常推荐的辅助工具scrcpy。它本质上是把Android设备的屏幕实时投射到电脑上支持鼠标和键盘操作传输走ADB通道不需要在电视上装任何应用。电视场景下它的价值尤其大电视通常放在客厅或者测试台上你不可能一直盯着电视屏幕看用scrcpy把画面投到电脑窗口里一边看代码一边看屏幕效果眼睛不用来回切换。操作方式scrcpy --max-size 1024 --max-fps 15--max-size限制画面分辨率--max-fps限制帧率这两个参数在电视上特别有用因为电视分辨率高不放限制容易卡。如果用无线连接ADB通道本身的带宽和稳定性限制了画面流畅度建议帧率保持在15左右够用且流畅。如果电视支持鼠标操作很多Android TV接USB鼠标后会出现鼠标指针scrcpy可以直接用电脑鼠标点在电视上调试那种需要点击特定区域的弹窗时非常方便。在部分电视上scrcpy默认的投屏协议可能不被支持报错提示device does not support之类的话可以在scrcpy后面加--push-target或者--encoder-name参数切换编码器试试。这个属于周边工具的优化不影响核心的ADB调试链路。回到最开始的话题。把ADB远程调试摸透之后我做Android TV开发的状态彻底变了编译完直接adb install操作完直接screencap拉图看效果测试反馈bug直接logcat抓日志多台设备一键批量操作这种流畅度是U盘时代完全不敢想的。如果你也正在被电视调试折磨照着这篇文章把环境配好把常用命令跑熟然后再去扩展自己项目的专属脚本调试效率绝对会上一个台阶。
