Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
Ring
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート
ネイティブ
Skip to main content
開発者モード(「開発モード」とも呼ばれます)では、アプリをサイドロードしたり、Fire TVデバイスにコンポーネントをデバッグしたりできます。デバイスには、開発者シェルとVDA(Vegaデバイスアダプター)を介してネットワークまたはUSBインターフェイスを介してアクセスします。アプリのテスト、セキュアシェルへのアクセス、パッケージの管理、ファイルシステムへのアクセスが可能です。開発者モードを有効にするには、Amazon開発者アカウントによる認証とデバイスの再起動が必要です。どのVega Fire TVデバイスでも、開発者モードを有効にする手順は同じです。このページでは、開発者モードを無効にする方法と、Amazonアカウントからデバイスを登録解除する方法についても説明します。 **完了までの予想所要時間:**5~10分

前提条件

開始する前に、以下の準備が整っていることを確認してください。
  • Amazon開発者アカウント(認証に必要): お持ちでない場合は、サインアップしてください。
  • 開発マシンにインストールされている Vega CLI: vega --versionで確認してください。インストールされていない場合は、Vega SDKのインストールを参照してください。
  • 最新のSDKマネージャ: vega updateを実行して最新バージョンを入手してください。Vega SDK Managerを参照してください。
  • Vega OSを実行し, 使用するコンピューターと同じネットワークに接続されているFire TVデバイス。すべてのサポート対象デバイスの一覧については、Fire TVのデバイス仕様を参照してください。

Fire TVでの開発者モードの認証

開発者モードを有効にするには、Vega CLIを使用してAmazon開発者アカウントで認証する必要があります。このプロセスでは、Fire TVデバイスから認証コードを取得し、ブラウザ経由で認証した後、ターミナルからデバイスの有効化を完了します。有効化すると、デバイスは自動的に再起動します。
  1. Fire TVの [設定] メニューにアクセスします。 オプション1: [ホーム] ボタンを使用する a. リモコンの [ホーム] ボタンを押して、[ホーム] 画面に移動します。 b. 上部のメニューバーに移動します。 c. 右にスクロールして、[設定] アイコン(歯車記号)を見つけて選択します。 オプション2: [ホーム] ボタンのショートカットを使用する(より迅速) a. リモコンの [ホーム] ボタンを3秒間長押します。 b. 表示されたクイックメニューから [設定] を選択します。
  2. [設定] > [My Fire TV] > [バージョン情報] に移動します。 [My Fire TV] 設定メニューの [バージョン情報] オプションが表示されたスクリーンショット。
  3. デバイス名(Fire TV Stick HD、Fire TV Stick 4K Select、Fire TVストリーミングメディアプレーヤーなど)を選択します。 [バージョン情報] 画面の [Fire TV Stick 4K Select] オプションを示すスクリーンショット。
  4. リモコンの中央のボタンを7回押します。 7回押すと、画面に「You are now a developer」という簡単な通知が表示されます。
  5. [戻る] ボタンを押して [My Fire TV] に戻ります。 一覧に [開発者オプション] が表示されます。 [My Fire TV] 設定メニューの [開発者オプション] を示すスクリーンショット。
  6. [開発者オプション] を選択します。 メニュー一覧に [開発者モード](デフォルトでは無効)が表示されます。 [開発者オプション] で [開発者モード] のステータスが [無効] として表示されているスクリーンショット。
  7. [開発者モード] を選択して続行します。 開発者モードを有効にするための確認ダイアログを示すスクリーンショット。[続行] および [キャンセル] オプションがあります。
  8. [続行] を選択して続行します(または、[キャンセル] を選択すると中止します)。 [キャンセル] を選択すると、ダイアログが閉じ、変更が保存されることなく [開発者オプション] 画面に戻ります。 [続行] を選択すると、Fire TVの画面に6桁の認証コードが表示されます。このコードは手順11で入力します。 6桁の認証コードが表示されるFire TVの画面を示すスクリーンショット。
  9. Amazon開発者アカウントで認証するために、loginコマンドを実行します。
    CLIの指示に従って認証を完了します。CLIによってデフォルトのウェブブラウザが自動的に開き、Amazonの認証ページが表示されます。ブラウザが自動的に開かない場合は、ターミナルに表示されているURLに移動してください。
  10. ブラウザでVega CLIのアクセスを認可します。 Amazon OAuthの同意画面に、「Vega Authentication Test would like access to:」というメッセージに続けて開発者の基本的なプロフィール情報と名前が表示されます。 a. リクエストされた権限を確認します。 b. [許可] を選択してVega Authentication Testを認可します(または、[キャンセル] を選択して拒否します)。 [キャンセル] を選択すると、CLIは認可を拒否し、認証エラーを表示します。vega devmode loginを再実行して再試行してください。 [許可] を選択すると、確認ページが開き、チェックマークアイコンと「Device connected to your account」というメッセージが表示されます。 このページは閉じて構いません。 ターミナルに戻ります。CLIに次のように表示されます。
  11. Fire TVの画面に表示された6桁のコードを使用してデバイスを有効にします。
    Amazon開発者アカウントに登録されているベンダーが1つだけの場合は、CLIに次のように表示されます。
    アカウントに複数のベンダーが登録されている場合は、CLIからいずれかを選択するように求められます。
    使用するベンダーに対応する番号を入力します。その後、CLIに✓ Device enabled successfullyが表示されます。
  12. デバイスが再起動するまで待ちます。 デバイスが3秒後に再起動することを示すFire TVの通知。
  13. デバイスの再起動後、[設定] > [My Fire TV] > [開発者オプション] > [開発者モード] に移動します。 [開発者モード] のステータスが [有効] として表示されます。 [開発者オプション] の設定で [開発者モード] のステータスが [有効] として表示されているスクリーンショット。
  14. デバイスが認識されることを確認します。
    1台のデバイスを接続したときの出力例:
    複数のデバイスを接続したときの出力例:
  15. デバイスに接続します。
    • 接続されているデバイスが1台の場合は、次のコマンドを使用します。
    • 接続されているデバイスが複数ある場合は、デバイスのシリアル番号を指定します。
      出力の例:

開発者モードの無効化

開発者モードを有効にした際に使用したのと同じ開発者モード設定において、開発者モードを無効にします。このプロセス中にデバイスが再起動します。
  1. [設定] > [My Fire TV] > [開発者オプション] に移動します。
  2. 開発者モードを選択します。 開発者モードを無効にするダイアログが表示されます。 開発者モードを無効にするための確認ダイアログを示すスクリーンショット。[続行] および [キャンセル] オプションがあります。
  3. [続行] を選択して続行します(または、[キャンセル] を選択すると中止します)。 [キャンセル] を選択すると、ダイアログが閉じ、開発者モードは有効のままになります。
  4. デバイスが再起動するまで待ちます。 再起動後、開発者モードのステータスに無効と表示されます。
開発者モードを無効にしても、[開発者オプション] メニューは [設定] に残ります。開発者モードを再び有効にするには、Fire TVで開発者モードを認証するの手順を繰り返します。

Fire TVデバイスの登録を解除する

Fire TVデバイスをAmazonアカウントから削除するには、工場出荷時の状態にリセットしてください。工場出荷時の状態にリセットすると、デバイスが Amazon アカウントからサインアウトされ、登録が解除され、開発者モードが無効になります。
  1. [設定] > [My Fire TV] > [工場出荷時の設定にリセット] に移動します。
  2. [リセット] を選択し、操作を確定します。 リセットすると、デバイスがAmazonアカウントからサインアウトされるという警告が表示されます。
  3. デバイスが再起動するまで待ちます。 端末が再起動して初期設定画面に戻り、Amazonアカウントへの登録が解除されます。

開発者モードの状態

開発者モードの動作には、有効、認証、無効の各状態があります。 有効状態 enable状態では、vshシェルアクセス、vpmによるパッケージ管理、コンポーネントデバッグ機能など、すべての開発者機能が有効になります。 認証状態 authenticating状態は、有効化処理中に開発者モードへのアクセスがシステムによって検証中であることを示します。 無効状態 disable状態では、機能へのアクセスが標準ユーザー機能のみに制限されます。

開発ツール

開発者モードでは、パッケージのデプロイ、コンポーネント管理、ファイル操作に不可欠なツールにアクセスできます。これらのツールは、適切な権限と適切なコンテキストの下で使用してください。

Vega CLI

Vegaコマンドラインインターフェイス(CLI)コマンドは、デバイスにおけるパッケージのインストール、アンインストール、管理に使用します。以下のパッケージ操作が可能です。
Amazon以外のパッケージ(com.amazonプレフィックスが付いていないパッケージ)のみをサイドロードできます。

コンポーネント管理

アプリコンポーネントを起動、一覧表示、終了するには、vega deviceを使用します。主なコマンドは以下のとおりです。

ファイル操作

開発マシンとデバイス間でファイルを転送するには、ファイル操作を使用します。デフォルトシェルでは/tmpディレクトリへのアクセスのみが許可されますが、コンポーネントシェルでは特定のディレクトリにアクセスできます。転送後は必ずファイルのアクセス権を確認します。また、デバイスのストレージを維持するため、不要になった一時ファイルは削除します。ファイルパスでは大文字と小文字が区別されることに注意してください。コンポーネントシェルがvega exec vda shellを使用するのは、vega device shellがデフォルトシェルのみに接続し、コンポーネントをターゲットにできないためです。 ファイルを削除するときは、次の点に注意してください。
  1. デフォルトの開発シェルから/tmpにプッシュされたファイルのみを削除します。
  2. 次の方法で、特定のコンポーネントシェル内でにあるファイルを削除します。
    • 以下を使用してコンポーネントシェルに入ります。vega exec vda shell -t component-id com.myorg.myapp.main
    • /scratchディレクトリ(コンポーネントシェル内ののバインドマウント)に移動する
    デフォルトシェルへのプッシュ
    コンポーネントシェルへのプッシュ
    例:
    コンポーネントの一覧を特定します
    出力の例:
    デバイスにインストールされたパッケージの一覧を特定します
    出力の例:
    コンポーネントシェルを起動する
    プッシュされたファイルを表示します
    出力の例:
    デバイスからのプル

ベストプラクティス

開発者モードを使用するときは、意図しないシステム変更を防ぐために、次のプラクティスを通常の開発ワークフローに組み込むことをお勧めします。
  • サイドロードするアプリは、Amazon以外のパッケージIDを持つアプリのみに限定します(パッケージIDの先頭がcom.amazonではないことを確認します)。
  • タスクに必要な最低限のアクセスレベルを使用します。
  • 最小権限の原則に従います。
  • 自分のアクションがデバイスの安定性とセキュリティに影響を及ぼす可能性があることに注意します。

トラブルシューティングとサポート

開発中に問題が発生した場合は、影響を受けている領域(認証、シェルアクセス、パッケージ管理、コンポーネントの起動、ファイル操作)を特定することから始めます。よくある問題の原因として、権限の誤りやデバイス状態の制限などが挙げられます。 以下のセクションで説明する解決策で問題が解決しない場合は、loggingctl logを使用して関連するログを収集し、サポートを受けてください。

認証に関する問題

開発に関する一般的な問題

デバッグツール

loggingctl logを使用してシステムログを収集し、コンポーネントの状態をモニタリングします。各デバッグツールには、デバイスの状態に基づいた特定のアクセスレベルがあります。

関連トピック


最終更新日 2026年10月13日