開発者コンソール

ADBを使用してFire TVに接続する方法

ADBを使用してFire TVに接続する方法

Android Debug Bridge(ADB)を使用すると、Amazon Fire TVデバイスやAmazon Fire TV Stickに開発用コンピューターを接続して、アプリのインストール・テスト・デバッグを行うことができます。ADBを使用する前に、必ずFire TVデバイスでデバッグを有効にしてコンピューターでADBを設定してください。手順は以下のとおりです。

Fireタブレットへの接続方法については、ADBを使用してFireタブレットに接続する方法を参照してください。

基本的な手順については、次のビデオ(日本語字幕付き)で説明しています。詳細については、本ページの残りの部分を参照してください。

手順A:Amazon Fire TVでデバッグを有効にする

Fire TVデバイスに接続する前に、同デバイスでADBとデバッグの両方を必ず有効にしてください。

  1. Fire TVのメイン画面で [設定] を選択します。
  2. [端末] または [My Fire TV] > [開発者オプション] の順に選択します。
  3. [ADBデバッグ] を有効にします。
  4. [不明ソースからのアプリ] を有効にします。
  5. (省略可能)USBケーブルを使用してコンピューターをUSB対応のFire TVデバイスに接続する場合は、[USBデバッグ] をオンにします。USBデバッグが有効になっているときは、USBポートをほかの用途(外部ストレージ、入力デバイスなど)に使用することはできません。USBポートを再び有効にするには、USBデバッグをオフにしてください。

手順B:Android Debug Bridgeを設定する

Android Debug Bridge(ADB)は、デバイスまたはエミュレーターでAndroidアプリの実行と管理を行うためのコマンドラインユーティリティです。ADBはAndroid Studioをインストールすると使用できますが、Windowsユーザーは特別なUSBドライバーをインストールする必要があります。

Android Studioで [Tools] > [SDK Manager] の順に選択すれば、ADBがインストールされているかどうかを確認できます。[SDK Tools] タブをクリックしてから、[Android SDK Platform-Tools] を選択してインストールしてください(まだ選択されていない場合)。

Mac

Mac OS XでADBを使用する場合は、特に必要な作業はありません。

Windows

WindowsコンピューターをUSBケーブルでFire TVに接続する場合は、特別なUSBドライバーをインストールしてからADBを介してFire TVデバイスに接続する必要があります。このドライバーは、すべてのFire TVプラットフォームをサポートしています。同ドライバーのインストール手順は以下のとおりです。

  1. USBファイルをダウンロードしてzipファイルの内容を抽出します。
  2. FireDevices_Driversをダブルクリックします。
  3. ダイアログボックスの指示に従ってインストールを実行します。

手順C:PATHにAndroid Debug Bridgeを追加する

adbコマンドを実行しやすくするために、PATHに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 Location] の横にAndroid SDKの場所が表示されます。例:/Users/<ユーザー名>/Library/Android/sdk

      Android Studioを初めて起動する場合、[SDK Manager] ボタンは表示されません。代わりに [Welcome to Android Studio] というプロンプトで、[Configure] > [SDK Manager] の順にクリックし、Android SDKの場所を指定してください。

    2. SDKのパスをコピーして、テキストエディターなどに貼り付けます。
    3. 直前の手順でコピーしたパスの末尾に/platform-toolsを追加します(「platform-tools」はadb実行ファイルが格納されているディレクトリです)。
    4. フルパスをクリップボードにコピーします。
  2. 以下のコマンドを使用して、ADBを.bash_profileに追加します。<ユーザー名>の部分を実際のユーザー名に置き換え、パスがAndroid SDKを指定するようにしてください。

    echo 'export PATH=$PATH:/Users/<ユーザー名>/Library/Android/sdk/platform-tools/' >> ~/.bash_profile
    

    .bash_profileファイルは通常、ユーザーディレクトリにあります。ユーザーディレクトリは、「cd ~」(change directory)と入力して確認できます。次に、「ls -a」(list all)と入力して、非表示のファイルも含めたすべてのファイルを表示します。

    .bash_profileファイルが存在しない場合は、新規に作成します。そのうえで「open .bash_profile」と入力すると、パスが一覧表示されます。

    bash profileにこのPATHを追加すると、.bash_profileファイルで次のように表示されます。

    export PATH=$PATH:/Users/johndoe/Library/Android/sdk/platform-tools/
    

    (ただし、johndoeの部分には実際のユーザー名が表示されます)

  3. ターミナルセッションをすべて再起動して、「adb」と入力します。PATHにADBが正しく追加されると、ADBのヘルプ情報が表示されます。正しく追加されていないと、「command not found.」と表示されます。

Windows

WindowsでPATHにADBを追加する手順は以下のとおりです。

  1. Android SDK platform-toolsディレクトリのパスを確認します。

    1. Android Studioを起動して [SDK Manager] ボタンをクリックします。

      上部の [Android SDK Location] の横にAndroid SDKの場所が表示されます。例: C:\Users\<ユーザー名>\AppData\Local\Android\Sdk

      Android Studioを初めて起動する場合、[SDK Manager] ボタンは表示されません。代わりに [Welcome to Android Studio] というプロンプトで、[Configure] > [SDK Manager] の順にクリックし、Android SDKの場所を指定してください。

    2. SDKのパスをコピーして、テキストエディターなどに貼り付けます。
    3. 直前の手順でコピーしたパスの末尾に/platform-toolsを追加します(「platform-tools」はadb実行ファイルが格納されているディレクトリです)。
    4. フルパスをクリップボードにコピーします。
  2. コンピューターの [スタート] から検索画面を開き、「システムの詳細設定の表示」と入力します。
  3. [システムの詳細設定の表示] をクリックします。
  4. [システム設定] ダイアログが表示されたら、[環境変数] ボタンをクリックします。
  5. [システム環境変数](下のペイン)で [Path] を選択し、[編集] をクリックします。
  6. 次のいずれかの操作を行います。

    • Windows 7または8の場合:カーソルを右端に移動し、「;」と入力してCtrl+Vキーを押し、先ほどコピーしたSDKのパスを挿入します(例:;C:\Users\<ユーザー名>\AppData\Local\Android\Sdk\platform-tools)。開いている3つのダイアログボックスを [OK] ボタンで閉じます。
    • Windows 10の場合:[新規] ボタンをクリックしてこの場所を追加します。
  7. ターミナルセッションを再起動して「adb」と入力します。PATHにADBが正しく追加されると、ADBのヘルプ情報が表示されます。正しく追加されていないと、「command not found.」と表示されます。

手順D: ADBを使用してFire TVデバイスに接続する

ADBは、ネットワーク経由またはUSB経由で接続できます。ほとんどのFire TVデバイスはネットワーク接続のみ可能となっているため、接続方式としてはネットワーク経由の方が一般的です。

ネットワーク接続

有線イーサネットまたはワイヤレス接続を使用した接続方法です。ネットワークADB接続が機能するには、コンピューターとFire TVデバイスが同じネットワーク上に存在する必要があります。また、すべてのFire TVデバイスにはワイヤレス接続の機能が備わっています。

  1. Fire TVデバイスとコンピューターが同じネットワーク上にあることを確認します。Wi-Fiネットワークと有線ネットワークのどちらも使用可能です。Fire TVがどのネットワーク上にあるかを確認するには、[設定] > [ネットワーク] の順にクリックしてください。
  2. 次に、ネットワークのIPアドレスを取得します。[設定] から、[端末] または [My Fire TV] > [バージョン情報] > [ネットワーク] の順にクリックします。画面に表示されたIPアドレスをメモしてください。

  3. ターミナルウィンドウを開きます。

    Macの場合、ターミナルを開くには、Cmd+Spaceキーを押して「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の画面に「USBデバッグを許可しますか?」という画面が表示されます。

    USBデバッグを許可しますか?
    USBデバッグを許可しますか?

    USBデバッグを許可しない場合、Fire TVはADB接続を承認しません。[このコンピューターから常に許可する] チェックボックスをオンにして、[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
    

    (IPアドレスが10.49.172.51の場合)

adb devicesを実行してもシリアル番号が表示されない場合や、unable to connectというメッセージが返された場合は、ADBのトラブルシューティングを行う必要があります。

USB接続

コンピューターをUSB経由でFire TV Stickに接続するには、USBケーブルの一端をFire TV Stick(HDMI経由でコンピューターのモニターに接続されている状態)に接続し、もう一端をコンピューターに接続します。この接続方法はFire TV(第1世代または第2世代)でも利用できますが、その場合はA-to-AタイプのUSBケーブルが必要です。使用するFire TVデバイスにUSBケーブルポートがない場合は、代わりにネットワーク接続を行ってください。

  1. Windowsコンピューターを使用する場合は、USBドライバーをインストールします(Android Debug Bridgeを設定するを参照)。
  2. USBデバッグをオンにします。Amazon Fire TVでデバッグを有効にするを参照してください([設定] > [端末] または [My Fire TV] > [開発者オプション] の順に選択し、[USBデバッグ] をオンにします)。
  3. コンピューターのUSBポートにFire TVを接続します。
  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を再起動します([設定] > [端末] または [システム] > [再起動])。
  • ルーターを再起動します。
  • ADBが別のサービスによってブロックされていないかを確認します。
  • AndroidのAndroid Debug Bridge(ADB)全体を読みます。
  • エラーメッセージをオンライン検索します。

次のステップ

テストのためにAmazon Fire TVデバイスにアプリをインストールして実行する方法については、アプリのインストールと実行を参照してください。


Last updated: 2022年6月28日