Vega Studio性能CLI
Vega Studio性能CLI
开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发布说明。
性能CLI作为Vega开发者工具 (VDT) 的一部分安装。要分析应用性能，您可以使用Vega Studio扩展中的命令面板，也可以使用性能命令行界面 (CLI)。
先决条件
- 安装Vega SDK。
-
要验证您的开发环境中是否安装了性能CLI，可运行以下命令：
kepler exec perf --help
帮助选项
要浏览所有性能CLI命令的选项，可运行以下命令：
kepler exec perf --help
要获取有关特定命令的信息，可运行以下命令：
kepler exec perf [命令] --help
要查看record命令的所有选项，可运行以下命令：
kepler exec perf record --help
常用命令
kepler exec perf record
使用record命令启动事件记录工具。这样会捕获性能事件以供分析。该命令采用以下参数：
--app-name- 指定来自manifest.toml的应用的主要交互组件名称。--recording-timeout- 以秒为单位设置记录持续时间（默认值： 120秒）--device-serial-number- 当您有多个设备时设置设备序列号--output-dir- 指定输出目录路径--trace-categories- 指定跟踪期间要启用的平台跟踪类别。默认类别：app、graphics、ui、lifecycle、input、video和webview--enable-cpu-sched- 在跟踪期间启用CPU调度程序事件记录（默认情况下禁用）
要记录应用的性能事件，可运行以下命令：
kepler exec perf record --app-name com.<公司名称>.<应用名称>.main
要使用特定超时时间进行记录，可运行以下命令：
kepler exec perf record --app-name com.<公司名称>.<应用名称>.main --recording-timeout 60
要使用自定义跟踪类别进行记录，可运行以下命令：
kepler exec perf record --app-name com.<公司名称>.<应用名称>.main --trace-categories app,graphics,ui,video
要在启用CPU调度器事件的情况下进行记录，可运行以下命令：
kepler exec perf record --app-name com.<公司名称>.<应用名称>.main --enable-cpu-sched
kepler exec perf activity-monitor
使用activity-monitor命令启动Activity Monitor工具。该命令采用以下参数：
--app-name- 指定来自manifest.toml的应用的主要交互组件名称。--record-cpu-profiling- 在记录期间启用JavaScript CPU分析器--sdk-path- 指定已安装的Vega SDK路径（使用--record-cpu-profiling时为必需项）--sourcemap-file-path- 指定JavaScript源映射路径 （使用--record-cpu-profiling时为必需）
要监控应用活动，可运行以下命令：
kepler exec perf activity-monitor --app-name com.<公司名称>.<应用名称>.main
要在启用CPU分析的情况下进行监控，可运行以下命令：
kepler exec perf activity-monitor --app-name com.<公司名称>.<应用名称>.main --record-cpu-profiling --sdk-path /path/to/vega/sdk --sourcemap-file-path /path/to/sourcemap
kepler exec perf memory-monitor
使用memory-monitor命令启动Memory Monitor工具。该命令采用以下参数：
--app-name- 指定来自manifest.toml的应用的主要交互组件名称。--keplerscript-app- 指定该应用是基于React Native的Vega应用。--relative-gc-count- 将垃圾回收 (GC) 计数显示为当前和先前GC计数之间的增量（仅适用于基于React Native的应用）
要监控应用内存，可运行以下命令：
kepler exec perf memory-monitor --app-name com.<公司名称>.<应用名称>.main
要监控React Native应用的相对垃圾回收次数，可运行以下命令：
kepler exec perf memory-monitor --app-name com.<公司名称>.<应用名称>.main --keplerscript-app --relative-gc-count
要开始和停止记录会话，可运行以下命令：
提示： 按Ctrl+C无法正确终止正在运行的进程。请改为按
q退出。对于 Mac：
- 按
s开始记录。 - 再次按
s停止记录。
如果按s不起作用，请按S和Return。
对于 Linux：
- 按
s开始记录。 - 再次按
s停止记录。
如果按s不起作用，请按S和Enter。
按q和Return，或按q和Enter，可退出记录。
注意： 默认情况下，记录会话在达到120秒时会超时。
kepler exec perf kpi-visualizer
使用kpi-visualizer命令来衡量您的应用KPI。该命令采用以下参数：
--app-name- 指定来自manifest.toml的应用的主要交互组件名称。--overridden-video-fps- 在视频播放期间覆盖每秒帧数以计算视频流畅度
衡量应用KPI：
kepler exec perf kpi-visualizer --app-name com.<公司名称>.<应用名称>.main
要在视频流畅度计算中覆盖视频FPS，可运行以下命令：
kepler exec perf kpi-visualizer --app-name com.<公司名称>.<应用名称>.main --overridden-video-fps 30
相关主题
Last updated: 2025年10月8日
