開発者モードの有効化

​

前提条件

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

​

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

1. Fire TVの [設定] メニューにアクセスします。 オプション1：ホームボタンを使用する a. リモコンのホームボタンを押して、[ホーム] 画面に移動します。 b. 上部のメニューバーに移動します。 c. 右にスクロールして、[設定] アイコン（歯車記号）を見つけて選択します。 オプション2：ホームボタンのショートカットを使用する a. リモコンのホームボタンを3秒間長押します。 b. 表示されたクイックメニューから [設定] を選択します。
2. [設定] > [My Fire TV] > [バージョン情報] に移動します。
3. デバイス名（Fire TV Stick HD、Fire TV Stick 4K Select、Fire TVストリーミングメディアプレーヤーなど）を選択します。
4. リモコンの中央のボタンを7回押します。 7回押すと、画面に「You are now a developer」という簡単な通知が表示されます。
5. 戻るボタンを押して [My Fire TV] に戻ります。 一覧に [開発者オプション] が表示されます。
6. [開発者オプション] を選択します。 メニュー一覧に [開発者モード]（デフォルトでは無効）が表示されます。
7. [開発者モード] を選択して続行します。
8. [続行] を選択して続行します（または、[キャンセル] を選択すると中止します）。 [キャンセル] を選択すると、ダイアログが閉じ、何も変更されずに [開発者オプション] 画面に戻ります。 [続行] を選択すると、Fire TVの画面に6桁の認証コードが表示されます。このコードは手順11で入力します。
9. Amazon開発者アカウントで認証するために、loginコマンドを実行します。
   vega devmode 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に次のように表示されます。
    Login successful! You are now authenticated with Amazon Developer Services.
    
11. 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」と表示されます。
12. デバイスが再起動するまで待ちます。
13. デバイスの再起動後、[設定] > [My Fire TV] > [開発者オプション] > [開発者モード] に移動します。 [開発者モード] のステータスが [有効] として表示されます。
14. デバイスが認識されることを確認します。
    vega device list
    
    1台のデバイスを接続したときの出力例：
    Found the following device:
    [シリアル番号] : [デバイス番号]
    
    複数のデバイスを接続したときの出力例：
    Found the following devices:
    [シリアル番号] : [デバイス番号]
    [シリアル番号] : [デバイス番号]
    
15. デバイスに接続します。
    • 接続されているデバイスが1台の場合は、次のコマンドを使用します。
      vega device shell
      
    • 接続されているデバイスが複数ある場合は、デバイスのシリアル番号を指定します。
      vega device -d <デバイスのシリアル番号> shell
      
      出力の例：
       (hostmachine)% vega device -d <デバイスのシリアル番号> shell
      
       ##################################################
      
       ##### Welcome to Developer Mode Shell #####
      
       ##################################################
      
       sh(com.amazon.dev.shell):/$
      

​

開発者モードの状態

​

開発ツール

​

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>

​

コンポーネント管理

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

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

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

​

ファイル操作

1. デフォルトの開発シェルから/tmpにプッシュされたファイルのみを削除します。
2. 以下の操作を行って、特定のコンポーネントシェル内で/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 --source <デバイスパス> --destination <ローカルパス>
   

​

ベストプラクティス

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

​

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

​

認証に関する問題

​

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

​

デバッグツール

​

関連トピック

• Fire TVデバイスでTCP/IP経由のVDAを構成する方法
• Vega仮想デバイスまたはFire TVでのアプリの実行
• Vega SDK CLIリファレンス
• Loggingctlを使用したシステムログの管理