开发者控制台
登录
登录
开发者控制台

通过ADB连接到Fire TV

通过ADB连接到Fire TV

 I： 开始设置

步骤1：
下载并构建示例应用
→
步骤2：
通过adb连接
→
步骤3：
浏览应用
→
步骤4：
尝试Alexa集成
→
步骤5：
自定义示例项目

在上一主题中，您在本地机器的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/<用户名>/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。使用您的实际用户名替换<用户名>。另外，路径必须指向Android SDK。

    echo 'export PATH=$PATH:/Users/<用户名>/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\<用户名>\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\<用户名>\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日