VDA参考
VDA参考
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。
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全局选项以及本地和shell命令来安装、测试和调试您的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
重启
使用重启命令重启设备。
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 shell命令
注意： 使用
kepler exec vda shell <命令> -h获取帮助，以及任何shell命令的选项列表。引用shell
kepler exec vda shell命令以交互方式运行远程shell，并有许多选项可用。
kepler exec vda shell
输出示例：
##################################################
##### Welcome to Developer Mode Shell #####
##################################################
sh(com.amazon.dev.shell):/$
其他shell命令
kepler exec vda shell <命令>
示例：
kepler vda shell whoami
app_user
应用管理和通信工具
您可以通过VDA shell访问这些工具：
kepler exec vda shell vpm <子命令>
kepler exec vda shell vlcm <子命令>
kepler exec vda shell vmsgr <子命令>
有关vpm、vlcm和vmsgr命令的详细信息，请参阅应用管理和通信工具。
启动组件shell
每个应用启动一个或多个组件。
要获取组件列表，请执行以下操作：
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):/$
要在组件shell中运行命令，请使用：
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 log。
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月21日
