Connect Your Fire Tablet for Testing

Introduction

For information about setting up your development computer, see Setting Up Your Development Environment for Fire Tablets

After you’ve created your Fire tablet app, you can use Android Debug Bridge (ADB) to connect your Fire tablet to a development computer for testing and debugging. For more information and instructions on using ADB, see Android Debug Bridge.

Use the following procedure to enable ADB and connect your Fire tablet to your computer:

  1. If you previously connected your Fire tablet to a Windows machine without having ADB enabled, you will need to uninstall the existing USB driver.
  2. If you are a Windows user, install the USB driver for Windows.
  3. Enable ADB on your Fire tablet.
  4. Connect your Fire tablet to your computer.

Uninstall the non-ADB Driver (Conditional)

If you are a Windows user who previously connected a Fire tablet without first enabling ADB, you will need to remove the existing USB device driver and force re-installation of the driver.

  1. Connect your Fire tablet to the USB port on your development computer.
  2. On the development computer, from the Start menu, right-click Computer, and then click Control Panel.
  3. On the control panel page, then click Device Manager.
  4. In the Device Manager window, expand Portable Devices.
  5. Right-click the Fire device and then click Properties.
  6. In the Properties window, on the Driver tab, click Uninstall, and then Confirm.
  7. Unplug your Fire tablet from your computer.

Installing the USB Driver (Windows Users)

Perform the following steps if your development computer runs Windows.

  • If you previously installed the now-deprecated Fire Phone SDK Add-on, the USB driver for Fire tablets and Fire phone has already been downloaded along with the Add-on.
  • If you have not downloaded the SDK Add-on or are new to Fire tablets development, you can directly download the driver from the following URL:
    https://s3.amazonaws.com/android-sdk-manager/redist/kindle_fire_usb_driver.zip
  • Extract the zip folder into a new folder.
  • Open the new folder and run the executable file, which installs the driver.

Enabling ADB on Your Fire Tablet

Enable ADB on your Fire tablet using the following steps:

  1. On your Fire tablet, go to Settings.
  2. On your Fire tablet (2014 or 2015 models), tap Device Options, then Developer Options. (On a 2013 model Kindle Fire tablet, tap Device, then Developer Options, or on a 2013 model Kindle Fire tablet, tap Security.

  3. Set Enable ADB to On, and then accept the pop-up warning message. Note: As a security precaution, you should set Enable ADB to Off when you are not trying to connect the tablet to your development computer.

Connecting Your Tablet to Your Computer

Once ADB is enabled on your Fire tablet, connect your tablet to your computer and follow the appropriate instructions for your computer’s OS:

Windows

Perform the following steps if your development computer runs Windows.

  1. Connect your Fire tablet to a USB port on your development computer.
  2. In the Allow USB debugging? dialog, on the tablet, tap OK.
  3. From Start, click Control Panel, and then select Device Manager.
  4. In Device Manager, under Fire, verify that the device appears as Android Composite ADB Interface.

    Your Fire tablet should display only as a Portable Device. If your Device Manager shows a second Fire device with a yellow alert sign (under Other Devices), your computer is listing Amazon’s unrecognized ADB module as a separate device. To fix this issue: 1. Right-click the Fire device under Other Devices, and select Properties to open the Properties window. 2. On the Driver tab of the Properties window, select Update Driver… 3. Choose to browse for the driver software, then navigate to Let me pick from a list of device drivers on my computer > Show All Devices > Have Disk. 4. Navigate to the folder where you installed the Amazon driver, typically C:\Program Files (x86)\Amazon.com\Kindle Fire\Drivers. 5. From the returned results, select Android Composite ADB Interface. 6. Ignore the warning regarding installing drivers and proceed.

    You should now correctly see your Fire tablet with the ADB driver installed.  
    
  5. From the Start menu, open a cmd prompt, and navigate to the directory where your Android SDK platform tools are installed, which if you are using the default location, should be similar to C:\Users\<user_name>\AppData\Local\Android\sdk\platform-tools.
  6. Verify that your device is detected by typing the following command:

    adb devices  
    

    The command should return your device’s serial number. If it does not return the serial number, try the following steps:

    1. Navigate to your Android SDK tools directory.
    2. Run the following command:

      android update adb
      
    3. Go back to your Android SDK platform-tools directory.
    4. Run the following commands:

      adb kill-server  
      adb start-server  
      adb devices
      

Mac OS X

Perform the following steps if your development computer runs OS X.

  1. Connect your Fire tablet to a USB port on your development computer.
  2. In the Allow USB debugging? dialog, on the tablet, tap OK.
  3. Open a terminal shell and navigate to your Android SDK tools directory.
  4. Run the following command to update ADB.

    ./android update adb
    
  5. In the terminal shell, navigate to your Android SDK platform-tools directory.
  6. Run the following commands and confirm that the serial number for your Kindle Fire tablet appears in the list of devices.

    ./adb kill-server
    ./adb start-server
    ./adb devices
    

Next Steps

Now that your Fire tablet is connected to your development computer, you can test an app on the tablet. For more information, see Running Your App on a Fire Tablet.