通过ADB连接到Fire TV
在上一主题中,您在本地机器的Android Studio中下载并构建了Fire App Builder。在此步骤中,您将把ADB连接到Fire TV,并在Fire TV设备上运行应用。ADB可让您在Fire TV设备上构建和运行应用。
如果您已经将ADB设置成连接到Fire TV设备,请向下跳至在Fire TV设备上运行Fire App Builder。
- 概览
- 步骤A:在亚马逊Fire TV上启用调试
- 步骤B:设置Android调试桥
- 步骤C:在路径中添加Android调试桥
- 步骤D: 通过ADB连接到Fire TV设备
- 故障排除
- 步骤E: 运行应用
- 故障排除
- 后续步骤
概览
可使用Android调试桥(adb)将开发计算机连接到亚马逊Fire TV设备或Stick,以安装、测试和调试应用。使用ADB之前,必须在Fire TV设备上启用调试,并在计算机上设置ADB。请按照以下步骤操作。
如需查看Fire平板电脑连接说明,请参阅通过ADB连接到Fire平板电脑。
此视频中会讲解基础知识(附带中文字幕)。有关更多详细信息,请参阅此页面的其余部分。
步骤A:在亚马逊Fire TV上启用调试
必须在Fire TV设备上启用ADB和调试,然后才能连接:
- 从Fire TV的主屏幕中,选择Settings(设置)。
- 选择设备(或“我的Fire TV”)>开发者选项。
- 打开ADB调试。
- 打开来自未知来源的应用。
- (可选)如果您的Fire TV支持USB,且您希望使用USB数据线将计算机连接到Fire TV设备,请打开“USB调试”。请注意,启用“USB调试”后,USB端口不可用于其他用途,如用作外部存储或输入设备。要重新启用USB端口,请关闭USB调试。)
步骤B:设置Android调试桥
Android调试桥(ADB)是一个命令行实用工具,用于在设备或模拟器上运行和管理 Android应用。安装Android Studio后即可使用ADB,但Windows用户需要安装特殊的USB驱动程序。
可通过转到Tools(工具)> SDK Manager(SDK管理器)进行检查,以确保ADB已安装在Android Studio中。单击SDK Tools(SDK工具)选项卡。选择,并安装Android SDK Platform-Tools(Android SDK平台工具)(若尚未选择)。
无需任何操作即可在Mac OS X中使用ADB。
若使用Windows,并希望通过USB数据线将计算机连至Fire TV,则需要安装特殊的USB驱动程序,以便通过ADB将计算机连至Fire TV设备。该驱动程序支持所有Fire TV平台。要安装该驱动程序,请执行以下操作:
- 下载USB文件,提取zip文件内容。
- 双击FireDevices_Drivers。
- 按照提示完成安装对话框。
步骤C:在路径中添加Android调试桥
需要在PATH中添加ADB,以便轻松执行ADB
命令。(PATH是一个环境变量,用于指定程序可执行文件的位置。若不将ADB添加到PATH中,运行adb
命令时就需要浏览到<Android SDK>/platform-tools
目录以运行ADB。)
adb version
,以此检查是否已在PATH中添加ADB。若返回版本信息,则表明adb
已在PATH中。要在Mac上的PATH中添加ADB,请执行以下操作:
-
获取Android SDK platform-tools目录的路径:
-
打开Android Studio,然后单击SDK Manager按钮。Android SDK的位置,显示在Android SDK位置附近(在顶部)。例如:
/Users/<your username>/Library/Android/sdk
如果是第一次打开Android Studio,则不会出现“SDK Manager”按钮。在“Welcome to Android Studio(欢迎使用Android Studio)”提示窗口中,单击Configure(配置)> SDK Manager提供Android SDK的位置。
- 复制SDK的路径,将其粘贴到方便的工具中,例如文本编辑器。
- 将/platform-tools添加到上一步中复制的路径末尾。(“/platform-tools”是包含
adb
可执行文件的目录。) - 将完整路径复制到剪贴板。
-
-
使用以下命令,在.bash_profile中添加ADB。使用您的实际用户名替换
<your username>
。另外,路径必须指向Android SDK。echo 'export PATH=$PATH:/Users/<your username>/Library/Android/sdk/platform-tools/' >> ~/.bash_profile
.bash_profile
文件通常位于用户目录中,可键入cd ~
(转到您的用户目录)找到该目录。然后键入ls -a
(列出全部)以显示所有文件,包括隐藏文件。如果文件不在该位置,可直接创建一个。然后,可以键入
open .bash_profile
以查看列出的路径。在bash配置文件中添加此PATH后,应该可以在
.bash_profile
文件中看到以下内容:export PATH=$PATH:/Users/johndoe/Library/Android/sdk/platform-tools/
(唯一区别在于,您看到的不是
johndoe
,而是自己的用户名。) -
完全重启任何终端会话,然后键入
adb
。若成功在路径中添加ADB,将看到ADB帮助信息(而非“command not found”(找不到命令))。
要在Windows上的PATH中添加ADB,请执行以下操作:
-
获取Android SDK platform-tools目录的路径:
-
打开Android Studio,然后单击SDK Manager按钮。
Android SDK的位置,显示在Android SDK位置附近(在顶部)。例如:
C:\Users\<your user name>\AppData\Local\Android\Sdk
如果是第一次打开Android Studio,则不会出现“SDK Manager”按钮。在“Welcome to Android Studio(欢迎使用Android Studio)”提示窗口中,单击Configure(配置)> SDK Manager提供Android SDK的位置。
- 复制SDK的路径,将其粘贴到方便的工具中,例如文本编辑器。
- 将/platform-tools添加到上一步中复制的路径末尾。(“/platform-tools”是包含
adb
可执行文件的目录。) - 将完整路径复制到剪贴板。
-
- 单击计算机的搜索按钮(“开始”按钮旁边),然后键入View advanced system settings(查看高级系统设置)。
- 单击View advanced system settings。
- 当“System Settings(系统设置)”对话框打开时,单击Environment Variables(环境变量)按钮。
- 在System Variables(系统变量)下(下部窗格),选择Path(路径),然后单击Edit(编辑)。
-
执行以下操作之一:
- 在Windows 7或8上,将光标移动到最右侧,键入
;
,然后按Ctrl+V插入之前复制的SDK的路径。PATH如下(示例):;C:\Users\<your user name>\AppData\Local\Android\Sdk\platform-tools
。对于3个打开的对话框,单击确定,将其关闭。 - 在Windows 10上,单击新建按钮,添加此位置。
- 在Windows 7或8上,将光标移动到最右侧,键入
- 重启所有终端会话,然后键入
adb
。若成功在路径中添加ADB,将看到ADB帮助信息(而非“command not found”(找不到命令))。
步骤D: 通过ADB连接到Fire TV设备
可以通过网络或USB连接到ADB。大多数Fire TV设备只允许网络连接,所以这是更常见的方法。
通过此选项,可使用有线以太网或无线网络进行连接。您的计算机和Fire TV设备必须处于同一网络中,网络ADB连接才能正常工作。所有Fire TV设备都提供无线连接选项。
- 确保Fire TV设备和计算机共用同一网络上。可使用WiFi,或有线网络。可通过设置 > 网络检查Fire TV所在的网络。
-
现在,请获取您网络的IP地址。在设置中,转到设备(或“我的Fire TV”)>关于>网络。记下屏幕上列出的IP地址。
警告: 请勿从“设置”>“网络”界面获取IP地址。在“设置”>“设备”>“关于”>“网络”下,还有另外一个显示IP地址的“网络”界面。不要混淆这两个网络屏幕。 -
打开终端窗口。
在Mac上,可以通过按Cmd + 空格键,然后键入Terminal来打开终端。 在Windows上,通常通过在程序搜索中键入cmd来打开命令提示符。(具体步骤视Windows版本而异。)
-
运行以下命令,其中
<ipaddress>
是上一节中提到的Fire TV设备的IP地址。<port>
可以是5555至5585范围内的任意数字。adb connect <ipaddress>:<port>
例如:
adb connect 10.49.172.51:5555
注意: 确保已按照在路径中添加Android调试桥中所述,在PATH中添加ADB。否则,就需要先通过cd
转到platform-tools目录,并使用./adb
(在Mac上)或adb
(在Windows上)运行adb
命令。首次运行
adb connect
时,Fire TV将显示一个屏幕,询问“Allow USB debugging?”(是否允许USB调试?)如果不允许USB调试,则Fire TV不会授权ADB连接。选中Always allow from this computer(始终允许从此计算机连接)复选框,然后单击OK(确定)。
如果ADB连接成功,ADB会通过以下消息做出响应:
connected to <ipaddress>:5555
如果需要停止或重启服务器,请使用以下ADB命令:
adb kill-server adb start-server
-
验证Fire TV设备是否显示在设备列表中:
adb devices
ADB通过以下消息做出响应:
List of devices attached 10.49.172.51:5555 device
(其中
10.49.172.51
是您的IP地址。)
如果运行adb devices
后未显示序列号,或者收到一条消息,告知您unable to connect
,则需要对ADB进行故障排除。
adb connect <ipaddress>
命令。要通过USB将电脑连接到Fire TV Stick,请将USB数据线的一端连接到Fire TV Stick(通过HDMI插接电脑显示器),另一端连接到电脑。这也适用于通过USB连接Fire TV(第1代或第2代),但需要使用A对A型USB数据线。如果Fire TV设备不提供USB数据线端口,请改用网络连接选项。
- 如果使用Windows,请按照设置Android调试桥中所述安装USB驱动程序。
- 打开USB调试。请参阅有关在亚马逊Fire TV上启用调试的章节。(转到设置。然后选择设备(或“我的Fire TV”)>开发者选项。然后打开USB调试。)
- 将您的Fire TV连接到您计算机上的USB端口。
-
运行以下命令:
adb kill-server adb start-server adb devices
在最后一个命令之后,ADB会通过以下消息做出响应,其中<serialno>
是设备的序列号:
List of devices attached
<serialno> device
如果连接到ADB时遇到问题,请参阅以下故障排除提示。
故障排除
如果收到如下消息:
unable to connect to 192.168.0.6:5555: Operation timed out
或
error: device offline
请尝试执行以下操作解决该问题:
- 确保Fire TV和您的计算机使用同一网络。
- 使用
adb connect <ipaddress>
进行无线连接时,请确保正确键入IP地址,并输入所有必要的点(.
)。 - 关闭Android Studio和任何其他模拟器或USB数据线连接。
- 终止(
adb kill-server
)然后重启(adb start-server
)服务器。 - 重启Fire TV(“Settings”(设置)>“设备[或系统]”>“Restart”(重新启动))。
- 重启路由器。
- 查看是否有其他服务在阻止ADB。
- 阅读Android网站上的Android调试桥(ADB)
- 在线搜索您看到的错误消息。
步骤E: 运行应用
通过ADB将计算机连接到Fire TV设备后,就可以在Fire TV上构建并运行您的应用。
- 如前几节所述,使用ADB将您的计算机连接到Fire TV设备。
- 在Android Studio中,单击Run 'app'(运行“应用”)按钮。
-
在Select Deployment Target(选择部署目标)对话框中,选择Amazon(亚马逊),然后单击OK(确定)。
在Select Deployment Target(选择部署目标)对话框中,AFTS
是指亚马逊Fire TV(第2代)。如果您有其他设备,缩写和API级别将有所不同。您可以在Identifying Fire TV Devices(识别Fire TV设备)中查看每个Fire TV设备的具体构建模型。
成功构建应用后,您的Fire TV设备将加载该应用程序。
请注意,ADB会在您连接的设备上的temporary文件夹中构建应用。当您断开设备连接时,该应用将在Fire TV上不再可用。如果您希望将该应用永久安装到您的Fire TV上,则需要将应用侧载到您的设备上。请参阅安装和运行您的应用。
如果您关闭Fire TV上的应用,可以使用Fire TV UI重新启动它,方法是使用遥控器进入Settings(设置)> Applications(应用程序)> Manage Installed Applications(管理已安装的应用)> Fire App Builder。
如果您在运行应用时遇到问题,请参阅下面的故障排除信息。
故障排除
本节列出了一些常见问题和故障排除步骤。
程序包命名冲突问题: 如果您试图运行该应用,但在设备上出现错误,则可能存在程序包名称冲突。如果您的Fire TV设备上已经安装了应用的已发布版本,并且您试图通过Android Studio侧载或运行该应用的开发版本(具有相同的程序包名称),会看到一条错误消息。
在运行开发版本之前,请从设备上卸载已发布的应用。您可以通过转到Settings > Applications > Manage Installed Applications来从Fire TV卸载已发布的应用。选择您的应用,然后选择Uninstall(卸载)两次。
规格中缺少端口
如果您收到一个错误,例如指示规格中缺少端口:tcp:10.12.345.67
,请在连接时在末尾添加端口(5555
):adb connect 10.12.345.67:5555
。有关更多详细信息,请参阅堆栈溢出线程。
后续步骤
转到下一个主题浏览应用,以更加熟悉Fire App Builder中的设置、功能、活动和屏幕。
Last updated: 2022年6月28日