Console

Settings

Sign out

Notifications

Alexa

Amazonアプリストア

Ring

AWS

ドキュメント

Support

My Cases

Console

Vega開発者向けドキュメント

ホーム

開発

設計と開発

公開

リファレンス

サポート

開発者モードの有効化

オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、最新のリリースノートを参照してください。

開発者モード（「開発モード」とも呼ばれます）では、ネットワークまたはUSBインターフェイス経由で接続した開発者シェルとVDA（Vega Device Adapter）を介して、アプリのサイドロード、コンポーネントのデバッグ、Fire TVデバイスへのアクセスを行うことができます。アプリのテスト、セキュアシェルへのアクセス、パッケージの管理、ファイルシステムへのアクセスが可能です。開発者モードを有効にするには、Amazon開発者アカウントによる認証とデバイスの再起動が必要です。どのVega Fire TVデバイスでも、開発者モードを有効にする手順は同じです。

完了までの予想所要時間： 5～10分

前提条件

開始する前に、以下の準備が整っていることを確認してください。

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

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

開発者モードを有効にするには、Vega CLIを使用してAmazon開発者アカウントで認証する必要があります。このプロセスでは、Fire TVデバイスから認証コードを取得し、ブラウザ経由で認証した後、ターミナルからデバイスの有効化を完了します。有効化すると、デバイスは自動的に再起動します。

Fire TVの [設定] メニューにアクセスします。

オプション1：ホームボタンを使用する

a. リモコンのホームボタンを押して、[ホーム] 画面に移動します。

b. 上部のメニューバーに移動します。

c. 右にスクロールして、[設定] アイコン（歯車記号）を見つけて選択します。

オプション2：ホームボタンのショートカットを使用する

a. リモコンのホームボタンを3秒間長押します。

b. 表示されたクイックメニューから [設定] を選択します。
[設定] > [My Fire TV] > [バージョン情報] に移動します。
デバイス名（Fire TV Stick HD、Fire TV Stick 4K Select、Fire TVストリーミングメディアプレーヤーなど）を選択します。
リモコンの中央のボタンを7回押します。

7回押すと、画面に「You are now a developer」という簡単な通知が表示されます。
戻るボタンを押して [My Fire TV] に戻ります。

一覧に [開発者オプション] が表示されます。
[開発者オプション] を選択します。

メニュー一覧に [開発者モード]（デフォルトでは無効）が表示されます。
[開発者モード] を選択して続行します。
[続行] を選択して続行します（または、[キャンセル] を選択すると中止します）。

[キャンセル] を選択すると、ダイアログが閉じ、何も変更されずに [開発者オプション] 画面に戻ります。

[続行] を選択すると、Fire TVの画面に6桁の認証コードが表示されます。このコードは手順11で入力します。

注：コードは5分後に期限切れになります。割り当てられた時間内にコードを入力しなかった場合は、同じ画面で [Request a New Code] を選択するか、[開発者オプション] に戻ってプロセスをやり直してください。
Amazon開発者アカウントで認証するために、loginコマンドを実行します。
クリップボードにコピーしました。
```
 vega devmode login
```
CLIの指示に従って認証を完了します。CLIによってデフォルトのウェブブラウザが自動的に開き、Amazonの認証ページが表示されます。ブラウザが自動的に開かない場合は、ターミナルに表示されているURLに移動してください。
ブラウザで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に次のように表示されます。
```
Login successful! You are now authenticated with Amazon Developer Services.
```
Fire TVの画面に表示された6桁のコードを使用してデバイスを有効にします。
クリップボードにコピーしました。
```
vega devmode enable-device --code <6桁のコード>
```
Amazon開発者アカウントに登録されているベンダーが1つだけの場合は、CLIに次のように表示されます。
```
Using vendor: Amazon
✓ Device enabled successfully
```
アカウントに複数のベンダーが登録されている場合は、CLIからいずれかを選択するように求められます。
```
Select a vendor:
1. Amazon (XXXXXXXXXX)
2. Amazon (XXXXXXXXXX)
```
使用するベンダーに対応する番号を入力します。CLIに「✓ Device enabled successfully」と表示されます。

注：ベンダーは、Amazonの開発者サービスを通じてコンテンツを管理および公開するための開発者アカウントです。この認証がデバイスに届くまでには数秒かかることがあります。
デバイスが再起動するまで待ちます。
デバイスの再起動後、[設定] > [My Fire TV] > [開発者オプション] > [開発者モード] に移動します。

[開発者モード] のステータスが [有効] として表示されます。
デバイスが認識されることを確認します。
クリップボードにコピーしました。
```
vega device list
```
1台のデバイスを接続したときの出力例：
```
Found the following device:
[シリアル番号] : [デバイス番号]
```
複数のデバイスを接続したときの出力例：
```
Found the following devices:
[シリアル番号] : [デバイス番号]
[シリアル番号] : [デバイス番号]
```

デバイスに接続します。

接続されているデバイスが1台の場合は、次のコマンドを使用します。
クリップボードにコピーしました。
```
vega device shell
```

接続されているデバイスが複数ある場合は、デバイスのシリアル番号を指定します。

vega device -d <デバイスのシリアル番号> shell

出力の例：

 (hostmachine)% vega device -d <デバイスのシリアル番号> shell

 ##################################################

 ##### Welcome to Developer Mode Shell #####

 ##################################################

 sh(com.amazon.dev.shell):/$

ヒント： 開発者モードを無効にするには、工場出荷時の設定にリセットします。[設定] には常に [開発者オプション] メニューが表示されますが、有効化の手順を繰り返すまでは非アクティブのままです。

開発者モードの状態

開発者モードの動作には、有効、認証、無効の各状態があります。

有効状態

有効状態では、vshシェルアクセス、vpmによるパッケージ管理、コンポーネントデバッグ機能など、すべての開発者機能が有効になります。

認証状態

認証状態は、有効化処理中に開発者モードへのアクセスがシステムによって検証されていることを示します。

無効状態

無効状態では、機能へのアクセスが標準ユーザー機能のみに制限されます。

開発ツール

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

Vega CLI

Vegaコマンドラインインターフェイス（CLI）コマンドは、デバイスにおけるパッケージのインストール、アンインストール、管理に使用します。以下のパッケージ操作が可能です。

# インストール（パッケージファイルのパスを指定）
vega device install-app --packagePath my-package.vpkg

# パッケージの一覧表示
vega device installed-packages

# パッケージの情報
vega device run-cmd --command 'vpm info <パッケージID>'

# アンインストール（パッケージファイルではなくコンポーネントIDを指定）
vega device uninstall-app --appName <コンポーネントID>

Amazon以外のパッケージ（com.amazonプレフィックスが付いていないパッケージ）のみをサイドロードできます。

コンポーネント管理

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

# 起動
vega device launch-app --appName <コンポーネントID>

# コンポーネントの一覧表示
vega device running-apps

# 終了
vega device terminate-app --appName <コンポーネントID>

ファイル操作

開発マシンとデバイス間でファイルを転送するには、ファイル操作を使用します。デフォルトシェルでは/tmpディレクトリへのアクセスのみが許可されますが、コンポーネントシェルでは特定の/tmp/scratch/<パッケージID>ディレクトリにアクセスできます。転送後は必ずファイルのアクセス権を確認します。また、デバイスのストレージを維持するため、不要になった一時ファイルは削除します。ファイルパスでは大文字と小文字が区別されることに注意してください。

ファイルを削除するときは、次の点に注意してください。

デフォルトの開発シェルから/tmpにプッシュされたファイルのみを削除します。

以下の操作を行って、特定のコンポーネントシェル内で/tmp/scratch/<パッケージID>にあるファイルを削除します。

vega exec vda shell -t component-id com.myorg.myapp.mainコマンドを使用して、コンポーネントシェルに入る
/scratchディレクトリ（コンポーネントシェル内の/tmp/scratch/<パッケージID>のバインドマウント）に移動する

 sh(com.myorg.myapp.main):/$ cd scratch
 sh(com.myorg.myapp.main):/scratch$ rm -rf <ファイル名>

デフォルトシェルプッシュ

 # デフォルトシェルにプッシュします
 vega device copy-to --source <ソース> --destination /tmp/

 # ファイルを表示します
 vega device shell
 sh(com.amazon.dev.shell):/$ ls -al /tmp

コンポーネントシェルプッシュ

 vega device copy-to --source <ソース> --destination /tmp/scratch/<パッケージID>/

 例：
 (hostmachine)% vega device copy-to --source myfile_cloud.sh --destination /tmp/scratch/com.myorg.myapp   

 # コンポーネントの一覧を見つけます
 vega device installed-apps

 出力の例： 
 com.myorg.myapp.main         
 com.myorg.otad.main          
 com.myorg.dev.shell.service  

 # デバイスにインストールされたパッケージの一覧を見つけます
 vega device installed-packages

 出力の例：
 com.myorg.myapp
 com.myorg.test.lifecycleobserver
 com.myorg.TESSERACT.TEST
 com.myorg.sm-sample.client
 com.myorg.samplepkg
 com.myorg.security.manager.unprivileged-test
 com.myorg.nmunprivileged.task
 com.myorg.messaging.mr33.okidl.ac

 # コンポーネントシェルを起動します
 (hostmachine)% vega exec vda shell -t component-id com.myorg.myapp.main 

 # プッシュされたファイルを表示します
 sh(com.myorg.myapp):/$ ls -al scratch/

 出力の例：
 total 4
 drwxr-xr-x  2 app_user app_user  60 2024-07-16 03:03 .
 drwxr-xr-x 19 app_user app_user 400 2024-07-16 03:03 ..
 -rwxrwxrwx  1 app_user 30086    650 2024-07-16 03:03 myfile_cloud.sh

デバイスからプル

 # デバイスからプルします
 vega device copy-from -o <デバイスパス> -s <ローカルパス>

ベストプラクティス

開発者モードを使用するときは、意図しないシステム変更を防ぐために、次のプラクティスを通常の開発ワークフローに組み込むことをお勧めします。

サイドロードするアプリは、Amazon以外のパッケージIDを持つアプリのみに限定します（パッケージIDの先頭がcom.amazonではないことを確認します）。
タスクに必要な最低限のアクセスレベルを使用します。
最小権限の原則に従います。
自分のアクションがデバイスの安定性とセキュリティに影響を及ぼす可能性があることに注意します。

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

開発中に問題が発生した場合は、影響を受けている領域（認証、シェルアクセス、パッケージ管理、コンポーネントの起動、ファイル操作）を特定することから始めます。よくある問題の原因として、権限の誤りやデバイス状態の制限などが挙げられます。

以下のセクションで説明する解決策で問題が解決しない場合は、loggingctl logを使用して関連するログを収集し、サポートを受けてください。

認証に関する問題

問題	解決策
認証に失敗する	デバイスとコンピューターが同じネットワーク上にあることを確認します。有効なAmazon開発者アカウントを持っていることを確認します。認証コードを表示どおりに正確に入力したことを確認します。
コードが期限切れになる	5分間の有効期限が切れた場合は、同じ画面で [Request a New Code] を選択するか、[開発者オプション] に戻ってプロセスをやり直します。
CLIが応答しない	CLIが最新バージョンであることを確認します。`vega --version`コマンドを実行して、Vega CLIが正しくインストールされていることを確認します。デバイスのIPアドレスが正しいことを確認します。ファイアウォールで接続がブロックされていないことを確認します。
検証がタイムアウトする	「Validation check timed out」というメッセージが表示された場合、システムは自動的に再試行します。再試行が完了するまで待ちます。繰り返しエラーが発生する場合は、[開発者オプション] からやり直します。
デバイスが再起動しない	確認ダイアログで [キャンセル] を選択した場合、プロセスは中止されます。もう一度実行するには、[開発者オプション] からやり直します。
ブラウザが自動的に開かない	ターミナルに表示されたURLに手動で移動してください。URLをコピーしてブラウザに貼り付け、プロンプトが表示されたら認証コードを入力します。

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

問題	考えられる原因	解決策	予防策
パッケージのインストールが失敗する	ディレクトリの間違い、または形式の問題。	`/tmp`の場所とパッケージ形式を確認します。	パッケージのガイドラインに従います。
コンポーネントの起動に関する問題	マニフェストエントリが見つからない。	マニフェストの構成とコンポーネントIDを確認します。	適切なマニフェストエントリを含めます。

デバッグツール

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

ツール	目的	必要なアクセスレベル	一般的なユースケース
`loggingctl`	システムログとコンポーネントログ	シェルの種類により異なる	デバッグクラッシュ、動作の検証。
`vlcm list`	コンポーネントのモニタリング	デフォルトシェル	実行中のコンポーネントの追跡、状態の確認。
`ps -efZ`	プロセスとセキュリティコンテキスト	コンポーネントシェル	権限の確認、プロセスの状態の確認。

Last updated: 2026年8月7日