使用Vega ESLint插件发现性能问题

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。

eslint-plugin-kepler为Vega应用提供自动lint规则，帮助您发现和修复性能问题。

安装和配置插件

安装Vega ESLint插件：

已复制到剪贴板。

npm install --save-dev @amazon-devices/eslint-plugin-kepler

在您的项目中配置ESLint：

更新.eslintrc配置文件的extends和plugins：

已复制到剪贴板。

{
"extends": [
         "@react-native",
         "eslint:recommended",
         "plugin:@amazon-devices/eslint-plugin-kepler/performance" // 添加扩展
],
"plugins": [
         "@typescript-eslint", 
         "@amazon-devices/kepler" // 纳入插件
],
"parserOptions": {
         "project": "./tsconfig.json" 
},
"parser": "@typescript-eslint/parser"
}

（可选）您可以按照ESLint文档中的配置规则（仅提供英文版）中所述自定义lint规则来满足您的要求。有关此插件提供的所有规则，请参阅ESLint规则。

在package.json中指定自定义格式化器：

已复制到剪贴板。

{
"scripts": {
   :
   "lint": "eslint src test --ext .ts,.tsx --format node_modules/@amazon-devices/eslint-plugin-kepler/dist/formatters/default.js",
   :
   }
}

运行linter：
已复制到剪贴板。
```
 npm run lint
```
您可以在控制台上看到结果：

运行linter后控制台显示输出

除了控制台输出外，linter还生成HTML报告：

Vega ESLint性能报告

在编辑代码时，您可以在VS Code上查看这些linter警告：

linter警告

ESLint规则

规则名称	默认严重性	描述	最佳实践
@amazon-devices/kepler/flat-list	警告 - 标记问题但不会导致构建失败	检查FlatList元素是否有足够的属性	FlatList
@amazon-devices/kepler/check-subscription	警告 - 标记问题但不会导致构建失败	检查useAddVegaAppStateListenerCallback和useAddUserInputListenerCallback安装的回调是否已正确取消订阅	侦听器、事件订阅和计时器
@amazon-devices/kepler/animated	错误 - 标记问题并且会导致构建失败	检查动画元素组件是否使用原生驱动程序	Animated库
@amazon-devices/kepler/detect-report-fully-drawn	警告 - 标记问题但不会导致构建失败	检查是否正确调用useReportFullyDrawn()	完全绘制的标记
@amazon-devices/kepler/detect-splash-screen	警告 - 标记问题但不会导致构建失败	检查是否正确调用usePreventHideSplashScreen() 和useHideSplashScreenCallback()。	SplashScreenManager

ESLint官方文档（仅提供英文版）

Last updated: 2025年9月30日

使用Vega ESLint插件发现性能问题

安装和配置插件

ESLint规则

相关主题