as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
Vega ESLint插件eslint-plugin-kepler为Vega应用提供自动lint规则,帮助您发现和修复性能及兼容性问题。

先决条件

安装插件及其依赖项:

配置插件

  1. 更新.eslintrc配置文件的extends、plugins和overrides部分:
    kepler配置包括所有Vega规则。要使用规则子集,请改为扩展以下一个或多个配置:
    • performance - 仅限性能相关规则
    • system-distributed-libs - 仅限系统分布式库检查(package.json验证和导入信息标记)
    • accessibility - 仅限无障碍功能规则
    例如,要仅使用性能和系统分布式库规则,请使用以下命令:
    要仅使用无障碍规则,请使用以下命令:
    保存文件。下次运行linter时,ESLint会加载Vega规则。
  2. (可选)按照ESLint的配置规则指南自定义lint规则。 如果跳过此步骤,所有规则都将以默认严重程度运行。 有关Vega ESLint插件提供的规则,请参阅了解性能规则、了解系统分布式库规则和了解无障碍功能规则。
  3. 在package.json文件的lint脚本中指定自定义格式化程序:
    您的lint脚本现在使用Vega自定义格式化程序。
  4. 运行linter:
    如果未出现package.json警告,请确认已安装jsonc-eslint-parser,并且已将package.json传递给eslint命令。 您可以在控制台上看到结果: 运行linter后控制台中示出的输出显示。 linter还会生成一个HTML报告: 屏幕截图显示了Vega项目ESLint分析报告,其中突出显示了两个与性能相关的警告: 缺少useReportFullyDrawn() 的实现(用于完全绘制时间指标)和usePreventHideSplashScreen() 的实现(用于启动画面优化)。报告表明代码库中没有严重错误。 在悬停于代码上方时,您可以在VS Code上查看这些linter警告: 屏幕截图显示了VS Code上的linter警告。

了解性能规则

以下规则有助于识别Vega应用中的常见性能问题,并实施最佳实践以实现最佳运行时性能。 在本页面的规则表中,Error规则会标记问题并导致构建失败。Warn规则会标记问题,但不会导致构建失败。

了解系统分布式库规则

以下规则检测系统分布式库的使用情况,并就正确实施为您提供指导。

(可选)配置语义化版本规范

系统分布式库规则会检查package.json依赖项中的语义化版本规范。默认情况下,该插件使用自动模式来检测项目的版本规范设置。 通过设置semverGuidance选项来覆盖默认值:
  • 仅限修补程序模式 (semverGuidance: "patch"): 使用~前缀限制对修补程序的更新。
  • 次要模式和修补程序模式 (semverGuidance: "minor"): 允许使用^前缀的次要更新。
  • 自动模式 (semverGuidance: "auto"): 根据项目存储库中的项目签名检测设置。这是默认设置。
仅修补模式配置示例:

了解无障碍功能规则

以下规则标记辅助技术(例如屏幕阅读器)无法描述或无法正确操作的组件。有关这些规则检查的无障碍功能属性的指导,请参阅适用于React Native 0.83或React Native 0.72的无障碍功能。 要更改无障碍功能规则的严重程度,请在ESLint配置的rules部分中覆盖它:
要为单个元素禁止某条规则,请在其上一行添加标准ESLint禁止注释:
要在编辑时查找并修复这些问题,请使用Vega Studio中的A11y检查器。它使用相同的规则,并识别相同的禁止注释。

(可选)配置VS Code进行JSON验证

如果想在VS Code的package.json中查看错误和警告,请在以下settings.json条目中添加json:

相关主题


最后修改于 2026年10月29日