VDAリファレンス
VDAコマンドラインユーティリティを使用すると、Vegaアプリのインストール、テスト、デバッグを行うことができます。VDAはVega SDKに付属のバイナリで、$HOME/vega/sdk/vega-sdk/main/<SDKバージョン>/bin/tools/vdaに配置されています。
VDAで使用するようにFire TV Stickをセットアップする方法については、Fire TV Stickのセットアップを参照してください。VDAでVega仮想デバイス（シミュレーター）を操作する場合は、追加のセットアップは必要ありません。
VDAグローバルオプション
以下のVDAグローバルオプション、ローカルコマンド、シェルコマンドを使用して、Vegaアプリをインストール、テスト、デバッグします。
シリアルオーバーライド
特定のシリアル番号または修飾子を持つデバイスまたはエミュレーターにコマンドを送信するには、-sを使用します。このオプションはVEGA_SERIAL環境変数をオーバーライドします。
デバイス（USB）
vega exec vda -s <特定のデバイス>
例：
vega exec vda -s G071R20720350DT6 shell
出力の例：
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
デバイス（TCP/IP）
デバイスがTCP/IP経由で接続されている場合は、vega exec vda devicesの出力に表示される<IP>:<ポート>識別子を使用します。
vega exec vda -s <IP>:<ポート> shell
例：
vega exec vda -s 192.168.1.100:5555 shell
出力の例：
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
Vega仮想デバイス
vega exec vda -s emulator-<VVDポート> shell
例：
vega exec vda -s emulator-5554 shell
出力の例：
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
VDAローカルコマンド
devices
接続されているすべてのデバイスの一覧を表示するには、devicesを使用します。-lを追加してデバイス修飾子を一覧表示します。
vega exec vda devices [ -l ]
例：
vega exec vda devices -l
USB経由で接続されているデバイスの出力例：
List of devices attached
G071R20720350DT6 device usb:14131000
TCP/IP経由で接続されているデバイスの出力例：
List of devices attached
192.168.1.100:5555 device
Vega仮想デバイスの出力例：
List of devices attached
emulator-5554 device
devicesの出力には、物理シリアル番号ではなく<IP>:<ポート>識別子が表示されます。接続タイプにかかわらずデバイスのシリアル番号（DSN）を取得するには、get-serialnoを使用します。シリアル番号の取得
デバイスのシリアル番号（DSN）を出力するには、get-serialnoを使用します。このコマンドは、デバイスがネットワークに接続されている場合でも、<IP>:<ポート>識別子ではなく実際のDSNを返します。
vega exec vda get-serialno
USB接続デバイスでの出力例：
G071R20720350DT6
TCP/IP接続デバイスでの出力例：
GT533M06507401WA
get-serialnoを使用すると、デバイスがUSBとTCP/IPのどちらで接続されているかにかかわらず、Appiumなどのツールで必要となるDSNを確実に取得できます。TCP/IPモード
USB接続デバイスをTCP/IPモードに切り替えるには、tcpipを使用してポート番号を指定します。デバイスはVDAデーモンを再起動し、指定されたポートでリッスンします。ポート5555を使用するか、1024より大きいポートを使用してください。
vega exec vda tcpip <ポート>
例：
vega exec vda tcpip 5555
出力の例：
restarting in TCP mode port: 5555
TCP/IPモードに切り替えたら、USBケーブルを取り外し、connectを使用してワイヤレス接続を確立します。設定の詳細なワークフローについては、Fire TVデバイスでTCP/IP経由のVDAを構成する方法を参照してください。
USBモード
デバイスをUSBモードに戻すには、usbを使用します。このコマンドを実行する前に、USBケーブルを再接続してください。
vega exec vda usb
vega exec vda usbからは何も出力されません。vega exec vda devicesを実行して、デバイスがUSB接続として表示されることを確認してください。接続
TCP/IP経由でデバイスに接続するには、connectを使用します。デバイスがあらかじめTCP/IPモードに構成されている必要があります（Fire TVデバイスでTCP/IP経由のVDAを構成する方法を参照）。
vega exec vda connect <ホスト>[:<ポート>]
ポート番号を指定しない場合、デフォルトでポート5555が使用されます。
例：
vega exec vda connect 192.168.1.100:5555
出力の例：
connected to 192.168.1.100:5555
disconnect
TCP/IP接続デバイスの接続を解除するには、disconnectを使用します。引数を指定せずにこのコマンドを実行すると、VDAはすべてのTCP/IP接続デバイスの接続を解除します。
vega exec vda disconnect [<ホスト>[:<ポート>]]
例：
vega exec vda disconnect 192.168.1.100:5555
出力の例：
disconnected 192.168.1.100:5555
すべてのTCP/IPデバイスを一度に接続解除するには、コマンドを引数なしで実行します。
vega exec vda disconnect
出力の例：
disconnected everything
ヘルプ
ヘルプファイルを表示するには、vega exec vda --helpを使用します。
vega exec vda --help
出力の例（注：画面の出力に関する日本語表記は説明のために提供しています。実際には英語で表示されます。）：
Vega Device Adapter
使用方法：vda [オプション] [サブコマンド]
オプション：
-V、--version プログラムのバージョン情報を表示して終了します。
-h、--help このヘルプメッセージを表示します。
--one-device TEXT 「start-server」でのみ使用できます。
-a 排他：-d localhostだけでなく、すべてのネットワークインターフェイスをリッスンします。
-d 排他：-a -e USBデバイスを使用します（複数のデバイスが接続されている場合はエラーになります）。
-e 排他：-d TCP/IPデバイスを使用します（複数のTCP/IPデバイスがある場合はエラーになります）。
-s SERIAL（環境：VEGA_SERIAL） 指定されたシリアル番号のデバイスを使用します（$VEGA_SERIALをオーバーライドします）。
-t ID:正数 指定されたトランスポートIDを持つデバイスを使用します。
-H TEXT（環境：VEGA_VDA_SERVER_ADDRESS）排他：-L
サーバーホストの名前を指定します。[デフォルト＝localhost]
-P INT:整数[1 - 65534]（環境：VEGA_VDA_SERVER_PORT）排他：-L
vdaサーバーのポートを指定します。[デフォルト＝5037]
-L SOCKET（環境：VDA_SERVER_SOCKET）排他：-H -P
指定されたソケットでvdaサーバーをリッスンします。[デフォルト＝tcp:localhost:5037]
--exit-on-write-error stdoutが閉じられている場合は終了します。
サーバーの強制終了
サーバーを停止するには、kill-serverを使用します。
vega exec vda kill-server
vega exec vda kill-serverからは何も出力されません。サーバーの起動
サーバーを起動するには、start-serverを使用します。
vega exec vda start-server
出力の例：
* daemon not running. starting it now on port 5037 *
* daemon started successfully *
プッシュ
ファイルまたはディレクトリをデバイスにコピーするには、pushコマンドを使用します。転送の進行状況を表示するには-pを使用します。
vega exec vda push [-p] <ローカル> <リモート>
例：
vega exec vda push Echo.png /tmp/
出力の例：
$ vega exec vda push Echo.png /tmp/
2283 KB/s (6109 bytes in 0.002s)
$ vega exec vda shell ls /tmp/Echo*
/tmp/Echo.png
プル
デバイスからファイルまたはディレクトリをコピーするには、pullを使用します。-pを追加すると転送の進行状況が表示され、-aを追加するとタイムスタンプとモードが表示されます。
vega exec vda pull [-p] [-a] <リモート> [<ローカル>]
例：
vega exec vda pull -p /tmp/Echo.png
出力の例：
$ vega 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を使用します。
vega exec vda version
出力の例：
Vega Device Adapter version 2.12+0a5eee73
Server Version 41
Platform Version 34.0.4
デバイスの待機
デバイスがオンラインになるまでアクティビティをブロックするには、wait-for-deviceを使用します。これは、スクリプトで操作する場合に役立ちます。
vega exec vda wait-for-device
出力の例：
$ vega exec vda devices
List of devices attached
$ vega exec vda wait-for-device
$ vega exec vda devices
List of devices attached
G071R20720350DT6 device
再起動
デバイスを再起動するには、rebootを使用します。
vega exec vda reboot
出力の例：
$ vega exec vda reboot
$ vega exec vda wait-for-device
$ vega exec vda devices
List of devices attached
G071R20720350DT6 device
VDAシェルコマンド
vega exec vda shell <コマンド> -hコマンドを使用します。シェルの起動
vega exec vda shellコマンドを使用すると、リモートシェルをインタラクティブに実行し、多くのオプションを使用できます。
vega exec vda shell
出力の例：
##################################################
##### Welcome to Developer Mode Shell #####
##################################################
sh(com.amazon.dev.shell):/$
その他のシェルコマンド
vega exec vda shell <コマンド>
例：
vega exec vda shell whoami
出力の例：
app_user
アプリの管理・通信ツール
これらのツールにはVDAシェルからアクセスできます。
vega exec vda shell vpm <サブコマンド>
vega exec vda shell vlcm <サブコマンド>
vega exec vda shell vmsgr <サブコマンド>
vpm、vlcm、vmsgrコマンドの詳細については、アプリの管理・通信ツールを参照してください。
コンポーネントシェルの起動
各アプリは1つ以上のコンポーネントを起動します。
コンポーネントの一覧を取得するには、次のコマンドを実行します。
vega exec vda shell vlcm list
出力の例：
application type pid id state lifespan timeout container launch args
com.amazon.lcm.stem.webview.main S 2719 1 IDLE PERMANENT DEFAULT framework.slice/service <none>
com.amazon.lcm.stem.apl.main S 2725 2 IDLE PERMANENT DEFAULT framework.slice/service <none>
com.amazon.otad.main I 3901 18 NOT_VISIBLE PERMANENT DEFAULT app.slice/app <none>
以降のコマンドでは、application列の値を<コンポーネントID>引数として使用します。
コンポーネントを対話型で実行するには、次のコマンドを使用します。
vega exec vda shell -c <コンポーネントID>
出力の例：
vega exec vda shell -c com.amazon.otad.main
##################################################
##### Welcome to Developer Mode Shell #####
##################################################
sh(com.amazon.otad):/$
コンポーネントシェルでコマンドを実行するには、次のコマンドを使用します。
vega exec vda shell -c <コンポーネントID> <command>
例：
vega exec vda shell -c com.amazon.otad.main df -h /tmp
出力の例：
vega 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を使用します。
vega 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形式で保存するには、次のコマンドを使用します。
vega exec vda shell gwsi-tool-screenshooter <file.png>
例：
$ vega exec vda shell gwsi-tool-screenshooter /tmp/test.png
$ vega exec vda pull /tmp/test.png
$ ls test.png
test.png
デバイスログ
デバイスログを画面に出力するには、loggingctlログを使用します。
vega exec vda shell loggingctl log <サブコマンド>
例：
vega 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: 2026年7月30日
