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全局选项

要安装、测试和调试Vega应用，请使用以下VDA全局选项、本地命令和shell命令。

序列号覆盖

要使用特定序列号或限定符将命令定向到您的设备或模拟器，请使用-s。此选项会覆盖VEGA_SERIAL环境变量。

设备 (USB)

vega exec vda -s <特定设备>

示例：

vega exec vda -s G0XXXXXXXXXXXXXX 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>:<端口> 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本地命令

要管理设备连接、传输文件和控制VDA服务器，请在开发计算机上运行以下命令。

设备

要列出所有连接的设备，可使用devices。添加-l列出设备限定符。

vega exec vda devices [ -l ]

示例：

vega exec vda devices -l

通过USB连接的设备的输出示例：

List of devices attached
G0XXXXXXXXXXXXXX       device usb:14131000

通过TCP/IP连接的设备的输出示例：

List of devices attached
192.168.1.100:5555     device

Vega虚拟设备的输出示例：

List of devices attached
emulator-5554          device

获取序列号

要打印DSN，请使用get-serialno。对于联网设备，该命令返回的是实际DSN，而非标识符。

vega exec vda get-serialno

USB连接设备的输出示例：

G0XXXXXXXXXXXXXX

通过TCP/IP连接的同一设备的输出示例：

G0XXXXXXXXXXXXXX

TCP/IP模式

要将USB连接设备切换到TCP/IP模式，请使用带有端口号的tcpip。设备会重启其VDA守护程序，以监听指定端口。请使用端口5555或任何编号大于1024的端口。

vega exec vda tcpip <端口>

示例：

vega exec vda tcpip 5555

输出示例：

已连接到192.168.1.100:5555

切换到TCP/IP模式后，断开USB数据线并使用connect来建立无线连接。有关整套设置流程，请参阅通过TCP/IP配置VDA。

USB模式

运行此命令前，请先重新连接USB数据线。

vega exec vda usb

connect

要通过TCP/IP连接到设备，请使用connect。先将设备配置为TCP/IP模式（请参阅“通过TCP/IP配置VDA”）。

vega exec vda connect <host>[:<port>]

如果您未指定端口号，VDA将使用端口5555。示例：

断开连接192.168.1.100:5555

输出示例：

connected to 192.168.1.100:5555

连接失败时的示例输出：

failed to connect to '192.168.1.100:5555': Operation timed out

超时通常意味着未启用开发者模式，或者主机与设备不在同一网络上。有关原因的完整列表，请参阅修复VDA连接和电源问题。

disconnect

要断开通过TCP/IP连接的设备，请使用disconnect。如果您在不带参数的情况下运行此命令，VDA将断开与所有TCP/IP设备的连接。

vega exec vda disconnect [<host>[:<port>]]

示例：

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
Usage: vda [OPTIONS] [SUBCOMMAND]

Options:
  -V,--version                Display program version information and exit
  -h,--help                   Show this help message
  --one-device TEXT           only allowed with 'start-server'
  -a Excludes: -d             listen on all network interfaces, not just localhost
  -d Excludes: -a -e          use USB device (error if multiple devices connected)
  -e Excludes: -d             use TCP/IP device (error if multiple TCP/IP devices available)
  -s SERIAL (Env:VEGA_SERIAL) use device with given serial (overrides $VEGA_SERIAL)
  -t ID:POSITIVE              use device with given transport id
  -H TEXT (Env:VEGA_VDA_SERVER_ADDRESS) Excludes: -L
                              name of vda server host [default=localhost]
  -P INT:INT in [1 - 65534] (Env:VEGA_VDA_SERVER_PORT) Excludes: -L
                              port of vda server [default=5037]
  -L SOCKET (Env:VDA_SERVER_SOCKET) Excludes: -H -P
                              listen on given socket for vda server [default=tcp:localhost:5037]
  --exit-on-write-error       exit if stdout is closed

终止服务器

要停止服务器，请使用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版本，请使用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
G0XXXXXXXXXXXXXX    device

重启

要重启设备，请运行reboot命令。

vega exec vda reboot

输出示例：

$ vega exec vda reboot

$ vega exec vda wait-for-device

$ vega exec vda devices
List of devices attached
G0XXXXXXXXXXXXXX    device

VDA shell命令

这些命令通过VDA shell在设备上运行。

引用shell

vega exec vda shell命令以交互方式运行远程shell，并有许多选项可用。

vega exec vda shell <命令>

输出示例：

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

其他shell命令

vega exec vda shell <command>

示例：

vega exec vda shell whoami

输出示例：

app_user

应用管理和通信工具

您可以通过VDA shell访问这些工具：

   vega exec vda shell vpm <子命令>
   vega exec vda shell vlcm <子命令>
   vega exec vda shell vmsgr <子命令>

有关vpm、vlcm和vmsgr命令的详细信息，请参阅应用管理和通信工具。

启动组件shell

每个应用都会启动一个或多个组件。要获取组件列表，请执行以下操作：

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):/$

要在组件shell中运行命令，请使用：

vega exec vda shell -c <组件ID> <命令>

示例：

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

截取屏幕截图

要以PNG格式捕获和保存屏幕截图，请使用gwsi-tool-screenshooter。

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-xxxxxxxxxxxxxxxx idle-manager[3268]: I idle-service:[IdleManagerService.cpp:107] transitionTo: 0->2
Jun 05 18:10:37.484831 firetvstick-xxxxxxxxxxxxxxxx idle-manager[3268]: I idle-service:[ScreensaverLauncher.cpp:71] Launching pkg://com.amazon.screensaver
Jun 05 18:10:37.485561 firetvstick-xxxxxxxxxxxxxxxx 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)
<continuous log output>

Vega CLI 工具

VDA全局选项

序列号覆盖

设备 (USB)

设备 (TCP/IP)

Vega虚拟设备

VDA本地命令

设备

获取序列号

TCP/IP模式

USB模式

connect

disconnect

帮助

终止服务器

启动服务器

推送

拉取

版本

等待设备

重启

VDA shell命令

引用shell

其他shell命令

应用管理和通信工具

启动组件shell

内存占用量

截取屏幕截图

设备日志

相关主题

​VDA全局选项

​序列号覆盖

​设备 (USB)

​设备 (TCP/IP)

​Vega虚拟设备

​VDA本地命令

​设备

​获取序列号

​TCP/IP模式

​USB模式

​connect

​disconnect

​帮助

​终止服务器

​启动服务器

​推送

​拉取

​版本

​等待设备

​重启

​VDA shell命令

​引用shell

​其他shell命令

​应用管理和通信工具

​启动组件shell

​内存占用量

​截取屏幕截图

​设备日志

​相关主题

VDA全局选项

序列号覆盖

设备 (USB)

设备 (TCP/IP)

Vega虚拟设备

VDA本地命令

设备

获取序列号

TCP/IP模式

USB模式

connect

disconnect

帮助

终止服务器

启动服务器

推送

拉取

版本

等待设备

重启

VDA shell命令

引用shell

其他shell命令

应用管理和通信工具

启动组件shell

内存占用量

截取屏幕截图

设备日志

相关主题