VDAリファレンス

VDAコマンドラインユーティリティを使用すると、Vegaアプリのインストール、テスト、デバッグを行うことができます。VDAはVega SDKに含まれているバイナリで、$HOME/vega/sdk/vega-sdk/main/{SDK version}/bin/tools/vdaに配置されています。 VDAで使用するようにFire TV Stickをセットアップする方法については、Fire TV Stickのセットアップを参照してください。VDAでVega仮想デバイス（シミュレーター）を操作する場合は、追加のセットアップは必要ありません。

VDAグローバルオプション

以下のVDAグローバルオプション、ローカルコマンド、シェルコマンドを使用して、Vegaアプリをインストール、テスト、デバッグします。

シリアルオーバーライド

特定のシリアル番号や修飾子を持つデバイスまたはエミュレーターにコマンドを送信するには、-sを使用します。このオプションはVDA_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の出力に表示される識別子を使用します：

vega exec vda -s <ip>:<port> 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

connect

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

ヘルプ

ヘルプファイルを表示するには、vega exec vda helpを使用します。

vega exec vda help

出力の例：

VDA version 1.0.0

 -a                            - directs vda to listen on all interfaces for a   connection
 -d                            - directs command to the only connected USB device
                                 returns an error if more than one USB device is present.
 -e                            - directs command to the only running emulator.
                                 returns an error if more than one emulator is running.
 -s <specific device>          - directs command to the device or emulator with the given
                                 serial number or qualifier. Overrides VDA_SERIAL
                                 environment variable.
 -p <product name or path>     - simple product name like 'sooner', or
                                 a relative/absolute path to a product
                                 out directory like 'out/target/product/sooner'.
                                 If -p is not specified, the VDA_PRODUCT_OUT
                                 environment variable is used, which must
                                 be an absolute path.
 -H                            - Name of vda server host (default: localhost)
 -P                            - Port of vda server (default: 5037)
 devices [-l]                  - list all connected devices
                                 ('-l' will also list device qualifiers)
 connect <host>[:<port>]       - connect to a device via TCP/IP
                                 Port 5555 is used by default if no port number is specified.
 disconnect [<host>[:<port>]]  - disconnect from a TCP/IP device.
                                 Port 5555 is used by default if no port number is specified.
                                 Using this command with no additional arguments
                                 will disconnect from all connected TCP/IP devices.

サーバーの強制終了

サーバーを停止するには、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

出力の例：

VDA version 1.0.0

デバイスの待機

デバイスがオンラインになるまでアクティビティをブロックするには、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コマンドを使用すると、リモートシェルをインタラクティブに実行し、多くのオプションを使用できます。

vega exec vda shell <コマンド>

出力の例：

##################################################
#####     Welcome to Developer Mode Shell    #####
##################################################
sh(com.amazon.dev.shell):/$

その他のシェルコマンド

vega exec vda shell <command>

例：

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

コンポーネントを対話型で実行するには、次のコマンドを使用します。

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 logを使用します。

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)
<ログ出力が続行>

Vega CLIツール

VDAグローバルオプション

シリアルオーバーライド

デバイス（USB）

デバイス（TCP/IP）

Vega仮想デバイス

VDAローカルコマンド

devices

connect

disconnect

ヘルプ

サーバーの強制終了

サーバーの起動

プッシュ

プル

バージョン

デバイスの待機

再起動

VDAシェルコマンド

シェルの起動

アプリの管理・通信ツール

コンポーネントシェルの起動

メモリ使用状況

gwsi-tool-screenshooter

デバイスログ

関連トピック

​VDAグローバルオプション

​シリアルオーバーライド

​デバイス（USB）

​デバイス（TCP/IP）

​Vega仮想デバイス

​VDAローカルコマンド

​devices

​connect

​disconnect

​ヘルプ

​サーバーの強制終了

​サーバーの起動

​プッシュ

​プル

​バージョン

​デバイスの待機

​再起動

​VDAシェルコマンド

​シェルの起動

​アプリの管理・通信ツール

​コンポーネントシェルの起動

​メモリ使用状況

​gwsi-tool-screenshooter

​デバイスログ

​関連トピック

VDAグローバルオプション

シリアルオーバーライド

デバイス（USB）

デバイス（TCP/IP）

Vega仮想デバイス

VDAローカルコマンド

devices

connect

disconnect

ヘルプ

サーバーの強制終了

サーバーの起動

プッシュ

プル

バージョン

デバイスの待機

再起動

VDAシェルコマンド

シェルの起動

アプリの管理・通信ツール

コンポーネントシェルの起動

メモリ使用状況

gwsi-tool-screenshooter

デバイスログ

関連トピック