Cambios Clave

Checkstyle 13.7.0, lanzado el 28 de junio de 2026, presenta varias mejoras y correcciones de errores cruciales, centrándose principalmente en la aplicación del estilo de código y la compatibilidad.

Nuevas Características:

  • Reglas de Estilo de Código: Una nueva propiedad jdkVersion para UnusedLocalVariable permite el manejo específico de variables de patrón de coincidencia con nombre no utilizadas en código anterior a Java 22. OverloadMethodsDeclarationOrder ahora incluye una propiedad required para exigir el orden de los métodos sobrecargados según el número creciente de parámetros.
  • Mejoras en Javadoc: MissingJavadocMethodCheck y JavadocMethod ahora utilizan el Abstract Syntax Tree (AST) de Javadoc, lo que resulta en un análisis de Javadoc más preciso y robusto.

Correcciones de Errores:

  • Cumplimiento del Estilo OpenJDK: Se han añadido o corregido numerosas verificaciones para alinearse con varias secciones de la Guía de Estilo OpenJDK, incluyendo Constantes, Expresiones de Ajuste, Modificadores, Estructura de Clases, Declaraciones de Importación, Orden de Constructores, Nombres de Clases, Interfaces y Enums, Paréntesis Redundantes y Comentarios de Documentación. Esto mejora significativamente la adhesión a los estándares de OpenJDK.
  • Archivos Fuente Compactos JEP 512: Se han resuelto una serie de errores relacionados con JEP 512 (Compact Source Files). Estas correcciones abordan falsos positivos y comportamientos incorrectos en verificaciones como UnnecessarySemicolonAfterTypeMemberDeclarationCheck, DeclarationOrderCheck, AnnotationLocationCheck, RequireThisCheck, InvalidJavadocPositionCheck y OuterTypeNumberCheck, asegurando un análisis correcto de los archivos fuente compactos.
  • Análisis de Javadoc: Se han corregido varios errores de análisis de Javadoc, particularmente los que involucran etiquetas @link con inicializadores de array y etiquetas @value formateadas, mejorando la fiabilidad de las verificaciones de Javadoc.

Para una lista completa de cambios, consulte las notas de lanzamiento oficiales.

Impacto para Equipos de QA

Los equipos de QA se benefician de una aplicación más precisa del estilo de código, especialmente para proyectos Java que siguen las directrices de OpenJDK o utilizan archivos fuente compactos JEP 512. Las verificaciones de Javadoc mejoradas reducen los falsos positivos, agilizando la revisión de código y los flujos de trabajo de análisis estático. Esta actualización ayuda a mantener estándares de calidad de código más altos.

FAQ

  • P: ¿Cuál es el enfoque principal de Checkstyle 13.7.0?
    • R: La actualización se centra principalmente en mejorar el cumplimiento del estilo OpenJDK, optimizar el análisis de Javadoc y corregir problemas relacionados con los archivos fuente compactos JEP 512.
  • P: ¿Cómo afecta esta actualización a los proyectos que utilizan JEP 512?
    • R: Resuelve varios errores que causaban falsos positivos y comportamientos incorrectos en archivos fuente compactos, asegurando un análisis estático más preciso para dichos proyectos.
  • P: ¿Hay nuevas reglas de estilo de código en esta versión?
    • R: Sí, las nuevas propiedades para UnusedLocalVariable y OverloadMethodsDeclarationOrder ofrecen un control más granular sobre la aplicación del estilo de código.