开发者控制台

通过ADB连接到Fire TV

通过ADB连接到Fire TV

上一主题中,您在本地机器的Android Studio中下载并构建了Fire App Builder。在此步骤中,您将把ADB连接到Fire TV,并在Fire TV设备上运行应用。ADB可让您在Fire TV设备上构建和运行应用。

如果您已经将ADB设置成连接到Fire TV设备,请向下跳至在Fire TV设备上运行Fire App Builder

概览

可使用Android调试桥(adb)将开发计算机连接到亚马逊Fire TV设备或Stick,以安装、测试和调试应用。使用ADB之前,必须在Fire TV设备上启用调试,并在计算机上设置ADB。请按照以下步骤操作。

如需查看Fire平板电脑连接说明,请参阅通过ADB连接到Fire平板电脑

此视频中会讲解基础知识(附带中文字幕)。有关更多详细信息,请参阅此页面的其余部分。

步骤A:在亚马逊Fire TV上启用调试

必须在Fire TV设备上启用ADB和调试,然后才能连接:

  1. 从Fire TV的主屏幕中,选择Settings(设置)
  2. 选择设备(或“我的Fire TV”)>开发者选项
  3. 打开ADB调试
  4. 打开来自未知来源的应用
  5. (可选)如果您的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

无需任何操作即可在Mac OS X中使用ADB。

Windows

若使用Windows,并希望通过USB数据线将计算机连至Fire TV,则需要安装特殊的USB驱动程序,以便通过ADB将计算机连至Fire TV设备。该驱动程序支持所有Fire TV平台。要安装该驱动程序,请执行以下操作:

  1. 下载USB文件,提取zip文件内容。
  2. 双击FireDevices_Drivers
  3. 按照提示完成安装对话框。

步骤C:在路径中添加Android调试桥

需要在PATH中添加ADB,以便轻松执行ADB命令。(PATH是一个环境变量,用于指定程序可执行文件的位置。若不将ADB添加到PATH中,运行adb命令时就需要浏览到<Android SDK>/platform-tools目录以运行ADB。)

Mac

要在Mac上的PATH中添加ADB,请执行以下操作:

  1. 获取Android SDK platform-tools目录的路径:

    1. 打开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的位置。

    2. 复制SDK的路径,将其粘贴到方便的工具中,例如文本编辑器。
    3. /platform-tools添加到上一步中复制的路径末尾。(“/platform-tools”是包含adb可执行文件的目录。)
    4. 将完整路径复制到剪贴板。
  2. 使用以下命令,在.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,而是自己的用户名。)

  3. 完全重启任何终端会话,然后键入adb。若成功在路径中添加ADB,将看到ADB帮助信息(而非“command not found”(找不到命令))。

Windows

要在Windows上的PATH中添加ADB,请执行以下操作:

  1. 获取Android SDK platform-tools目录的路径:

    1. 打开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的位置。

    2. 复制SDK的路径,将其粘贴到方便的工具中,例如文本编辑器。
    3. /platform-tools添加到上一步中复制的路径末尾。(“/platform-tools”是包含adb可执行文件的目录。)
    4. 将完整路径复制到剪贴板。
  2. 单击计算机的搜索按钮运行“应用”(“开始”按钮旁边),然后键入View advanced system settings(查看高级系统设置)
  3. 单击View advanced system settings
  4. 当“System Settings(系统设置)”对话框打开时,单击Environment Variables(环境变量)按钮。
  5. System Variables(系统变量)下(下部窗格),选择Path(路径),然后单击Edit(编辑)
  6. 执行以下操作之一:

    • Windows 7或8上,将光标移动到最右侧,键入;,然后按Ctrl+V插入之前复制的SDK的路径。PATH如下(示例):;C:\Users\<your user name>\AppData\Local\Android\Sdk\platform-tools。对于3个打开的对话框,单击确定,将其关闭。
    • 在Windows 10上,单击新建按钮,添加此位置。
  7. 重启所有终端会话,然后键入adb。若成功在路径中添加ADB,将看到ADB帮助信息(而非“command not found”(找不到命令))。

步骤D: 通过ADB连接到Fire TV设备

可以通过网络或USB连接到ADB。大多数Fire TV设备只允许网络连接,所以这是更常见的方法。

网络连接

通过此选项,可使用有线以太网或无线网络进行连接。您的计算机和Fire TV设备必须处于同一网络中,网络ADB连接才能正常工作。所有Fire TV设备都提供无线连接选项。

  1. 确保Fire TV设备和计算机共用同一网络上。可使用WiFi,或有线网络。可通过设置 > 网络检查Fire TV所在的网络。
  2. 现在,请获取您网络的IP地址。在设置中,转到设备(或“我的Fire TV”)>关于>网络。记下屏幕上列出的IP地址。

  3. 打开终端窗口。

    在Mac上,可以通过按Cmd + 空格键,然后键入Terminal来打开终端。 在Windows上,通常通过在程序搜索中键入cmd来打开命令提示符。(具体步骤视Windows版本而异。)

  4. 运行以下命令,其中<ipaddress>是上一节中提到的Fire TV设备的IP地址。<port>可以是5555至5585范围内的任意数字。

    adb connect <ipaddress>:<port>
    

    例如:

    adb connect 10.49.172.51:5555
    

    首次运行adb connect时,Fire TV将显示一个屏幕,询问“Allow USB debugging?”(是否允许USB调试?)

    是否允许USB调试?
    是否允许USB调试?

    如果不允许USB调试,则Fire TV不会授权ADB连接。选中Always allow from this computer(始终允许从此计算机连接)复选框,然后单击OK(确定)

    如果ADB连接成功,ADB会通过以下消息做出响应:

    connected to <ipaddress>:5555
    

    如果需要停止或重启服务器,请使用以下ADB命令:

    adb kill-server
    adb start-server
    
  5. 验证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进行故障排除

USB连接

要通过USB将电脑连接到Fire TV Stick,请将USB数据线的一端连接到Fire TV Stick(通过HDMI插接电脑显示器),另一端连接到电脑。这也适用于通过USB连接Fire TV(第1代或第2代),但需要使用A对A型USB数据线。如果Fire TV设备不提供USB数据线端口,请改用网络连接选项。

  1. 如果使用Windows,请按照设置Android调试桥中所述安装USB驱动程序。
  2. 打开USB调试。请参阅有关在亚马逊Fire TV上启用调试的章节。(转到设置。然后选择设备(或“我的Fire TV”)>开发者选项。然后打开USB调试。)
  3. 将您的Fire TV连接到您计算机上的USB端口。
  4. 运行以下命令:

    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上构建并运行您的应用。

  1. 如前几节所述,使用ADB将您的计算机连接到Fire TV设备。
  2. 在Android Studio中,单击Run 'app'(运行“应用”)按钮运行“应用”按钮
  3. 在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日