VDAリファレンス
VDAコマンドラインユーティリティを使用すると、Vegaアプリのインストール、テスト、デバッグを行うことができます。VDAはVega SDKに含まれているバイナリで、<Vega SDKのパス>/bin/tools/vdaに配置されています。
Vega SDKのインストール中にパスにvega_SDK_PATH/binを追加した場合は、コマンドプロンプトで「kepler exec vda」と入力してVDAを起動します。
VDAで使用するようにFire TV Stickをセットアップする方法については、Fire TV Stickのセットアップを参照してください。VDAでVega仮想デバイス（シミュレーター）を操作する場合は、追加のセットアップは必要ありません。
VDAグローバルオプション
以下のVDAグローバルオプション、ローカルコマンド、シェルコマンドを使用して、Vegaアプリをインストール、テスト、デバッグします。
シリアルオーバーライド
特定のシリアル番号または修飾子を使用してデバイスまたはエミュレーターにコマンドを送信するには、-sを使用します。このオプションは、VDA_SERIAL環境変数をオーバーライドします。
デバイス
kepler exec vda -s <特定のデバイス>
例：
kepler exec vda -s G071R20720350DT6 shell
出力の例：
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
Vega仮想デバイス
kepler exec vda -s emulator-<VVDポート> shell
例：
kepler exec vda -s emulator-5554 shell
出力の例：
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
VDAローカルコマンド
デバイス
接続されているすべてのデバイスの一覧を表示するには、devicesを使用します。-lを追加してデバイス修飾子を一覧表示します。
kepler exec vda devices [ -l ]
例：
kepler exec vda devices -l
デバイスの出力例：
kepler exec vda devices -l
List of devices attached
G071R20720350DT6 device usb:14131000
Vega仮想デバイスの出力例：
kepler exec vda devices -l
List of devices attached
G071R20720350DT6 device usb:14131000
emulator-5554 device
ヘルプ
ヘルプファイルを表示するには、kepler exec vda helpを使用します。
kepler exec vda help
出力の例（注：画面の出力に関する日本語表記は説明のために提供しています。実際には英語で表示されます。）：
kepler exec vda help
VDA version 1.0.0
-a - VDAをすべてのインターフェイスで接続待機状態にします
-d - コマンドを、接続されている唯一のUSBデバイスに対して実行します
接続されているUSBデバイスが複数存在する場合、エラーを返します。
-e - コマンドを、実行中の唯一のエミュレーターに送信します。
複数のエミュレーターが実行されている場合、エラーを返します。
-s <特定のデバイス> - コマンドを、指定されたシリアル番号または修飾子と一致する
デバイスまたはエミュレーターに送信します。VDA_SERIAL環境変数を
オーバーライドします。
-p <製品名またはパス> - 単純な製品名（'sooner'など）または
製品出力ディレクトリへの
相対／絶対パス（'out/target/product/sooner'など）を指定します。
-pを指定しなかった場合、VDA_PRODUCT_OUT
環境変数が使用されます。この変数は
絶対パスで指定する必要があります。
-H - VDAサーバーホストの名前（デフォルト：localhost）
-P - VDAサーバーのポート（デフォルト： 5037）
devices [-l] - 接続されているすべてのデバイスを一覧表示します
（'-l'を指定するとデバイスの修飾子も一覧表示されます）
connect <ホスト>[:<ポート>] - TCP/IP経由でデバイスに接続します
ポート番号が指定されていない場合、デフォルトではポート5555が使用されます。
disconnect [<ホスト>[:<ポート>]] - TCP/IP接続のデバイスの接続を解除します。
ポート番号が指定されていない場合、デフォルトではポート5555が使用されます。
引数を指定せずにこのコマンドを使用すると、
TCP/IP接続のすべてのデバイスの接続が解除されます。
サーバーの強制終了
サーバーを停止するには、kill-serverを使用します。
kepler exec vda kill-server
kepler exec vda kill-serverからは何も出力されません。サーバーの起動
サーバーを起動するには、start-serverを使用します。
kepler exec vda start-server
出力の例：
kepler exec vda start-server
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
プッシュ
ファイルまたはディレクトリをデバイスにコピーするには、pushコマンドを使用します。転送の進行状況を表示するには-pを使用します。
kepler exec vda push [-p] <ローカル> <リモート>
例：
kepler exec vda push Echo.png /data/
出力の例：
kepler exec vda push Echo.png /tmp/
2283 KB/s (6109 bytes in 0.002s)
kepler exec vda shell ls /data/Echo*
/data/Echo.png
プル
デバイスからファイルまたはディレクトリをコピーするには、pullを使用します。-pを追加すると転送の進行状況が表示され、-aを追加するとタイムスタンプとモードが表示されます
kepler exec vda pull [-p] [-a] <リモート> [<ローカル>]
例：
kepler exec vda pull -p /data/Echo.png
出力の例：
kepler exec vda pull -p /tmp/Echo.png
Transferring: 6109/6109 (100%)
370 KB/s (6109 bytes in 0.016s)
ls Echo*
Echo.png
バージョン
VDAのバージョンを表示するには、vda versionを使用します。
kepler exec vda version
出力の例：
kepler exec vda version
VDA version 1.0.0
デバイスの待機
デバイスがオンラインになるまでアクティビティをブロックするには、wait-for-deviceを使用します。これは、スクリプトで操作する場合に役立ちます。
kepler exec vda wait-for-device
出力の例：
kepler exec vda devices
List of devices attached
kepler exec vda wait-for-device
kepler exec vda devices
List of devices attached
G071R20720350DT6 device
再起動
rebootコマンドを使用してデバイスを再起動します。
kepler exec vda reboot
出力の例：
kepler exec vda reboot
kepler exec vda wait-for-device
kepler exec vda devices
List of devices attached
G071R20720350DT6 device
VDAシェルコマンド
kepler exec vda shell <コマンド> -hコマンドを使用します。シェルの起動
kepler exec vda shellコマンドを使用すると、リモートシェルをインタラクティブに実行し、多くのオプションを使用できます。
kepler exec vda shell
出力の例：
##################################################
##### Welcome to Developer Mode Shell #####
##################################################
sh(com.amazon.dev.shell):/$
その他のシェルコマンド
kepler exec vda shell <コマンド>
以下に例を示します。
kepler vda shell whoami
app_user
アプリの管理・通信ツール
これらのツールにはVDAシェルからアクセスできます。
kepler exec vda shell vpm <サブコマンド>
kepler exec vda shell vlcm <サブコマンド>
kepler exec vda shell vmsgr <サブコマンド>
vpm、vlcm、vmsgrコマンドの詳細については、アプリの管理・通信ツールを参照してください。
コンポーネントシェルの起動
各アプリは1つまたは複数のコンポーネントを起動します。
コンポーネントの一覧を取得するには、次のコマンドを実行します。
kepler exec vda shell vlcm list
コンポーネントを対話型で実行するには、次のコマンドを使用します。
kepler exec vda shell -c <コンポーネントID>
出力の例：
kepler exec vda shell -c com.amazon.otad.main
##################################################
##### Welcome to Developer Mode Shell #####
##################################################
sh(com.amazon.otad):/$
コンポーネントシェルでコマンドを実行するには、次のコマンドを使用します。
kepler exec vda shell -c <コンポーネントID> <コマンド>
出力の例：
kepler exec vda shell -c com.amazon.otad.main df -h /tmp
Filesystem Size Used Avail Use% Mounted on
none 64M 0 64M 0% /tmp
メモリ使用状況
システム内のすべてのプロセスに関するメモリ使用量の概要を確認するには、ace-memusageを使用します。
kepler exec vda shell ace_memusage
出力の例：
kepler exec vda shell ace_memusage
PID User Cmdline Swap Uss Pss Rss Vss
1 root /sbin/init 0 1128 2669 8184 28904
401 root /lib/systemd/systemd-journald 0 2560 3150 7116 19692
423 root /lib/systemd/systemd-udevd 0 2432 2694 6220 18956:Total System Memory:
Total Free Buffers Cached Shmem Slab Available
1782444 1088312 142808 278528 10880 79024 1479176
Done
gwsi-tool-screenshooter
スクリーンショットをキャプチャしてPNG形式で保存するには、次のコマンドを使用します。
kepler exec vda shell gwsi-tool-screenshooter <file.png>
例：
kepler exec vda shell gwsi-tool-screenshooter /temp/test.png
出力の例：
kepler exec vda shell gwsi-tool-screenshooter /tmp/test.png
kepler exec vda pull /temp/test.png
ls test.png
test.png
デバイスログ
デバイスログを画面に出力するには、loggingctlログを使用します。
kepler exec vda shell loggingctl log <サブコマンド>
例：
kepler exec vda shell loggingctl log -o short-precise -f
出力の例：
kepler exec vda shell loggingctl log -o short-precise -f
Jun 05 18:10:37.484732 firetvstick-fa0ef0f89ff2d145 idle-manager[3268]: I idle-service:[IdleManagerService.cpp:107] transitionTo: 0->2
Jun 05 18:10:37.484831 firetvstick-fa0ef0f89ff2d145 idle-manager[3268]: I idle-service:[ScreensaverLauncher.cpp:71] Launching pkg://com.amazon.screensaver
Jun 05 18:10:37.485561 firetvstick-fa0ef0f89ff2d145 lcm_service[2151]: I lcm-ipc-server:[LcmServer.cpp:182] Received request: launch app for result (1) from (uid:101, gid:101, pid:3268, security_ctx:System)
<ログの出力を継続>
関連トピック
Last updated: 2025年10月22日
