开发者控制台

通过ADB连接到Fire TV(Fire TV)

通过ADB连接到Fire TV(Fire TV)

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

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

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

步骤A. 在Amazon 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调试。请参阅有关在Amazon 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)
  • 在线搜索您看到的错误消息。

后续步骤

要在Amazon Fire TV设备上安装和运行您的应用以进行测试,请参阅安装和运行您的应用