ADVERTENCIA de JavaFX: Configuración de JavaFX no compatible: clases cargadas desde el 'Módulo sin nombre @...'

Problema:

Al instalar y ejecutar JavaFX, los usuarios encuentran una advertencia que indica "Configuración de JavaFX no compatible: las clases se cargaron desde 'módulo sin nombre' @...'."

Antecedentes:

Esta advertencia surge de la introducción de Java Platform Module System (JPMS) en Java 9. Los módulos JavaFX deben ser cargados como "módulos con nombre" desde la ruta del módulo, no desde la ruta de clase.

Solución:

Para resolver esto:

• Asegúrese de que JavaFX esté en la ruta del módulo: Agregue JavaFX a la ruta del módulo usando la opción --module-path.
• Resolver JavaFX como módulos con nombre: Para aplicaciones no modulares, utilice la opción --add-modules para forzar a Java a resolver módulos JavaFX con nombre módulos.
• Aplicaciones modulares: Utilice la opción --module para iniciar su aplicación como un módulo con las directivas requeridas apropiadas en el descriptor de información del módulo.
• Utilice una distribución JDK con JavaFX: Instale una distribución JDK que incluya JavaFX, como BellSoft Liberica JDK o Azul Zulu JDK, para cargar JavaFX como módulos nombrados automáticamente.
• Ignorar la advertencia: A partir de JavaFX 21, ignorar la advertencia es una opción, pero el uso de configuraciones no compatibles puede generar problemas futuros.

Implementación:

• Requerir que los clientes tengan JRE con JavaFX: Asegúrese de que los clientes tengan un JRE con JavaFX instalado.
• Distribuya una aplicación autónoma: Cree una aplicación autónoma utilizando herramientas como jlink o una imagen nativa para empaquetar la aplicación , bibliotecas y JRE juntos.
• Archivo JAR "Fat" ejecutable: Incruste JavaFX y todas las dependencias en un archivo JAR ejecutable. Sin embargo, este enfoque implícitamente no es compatible ya que carga JavaFX desde el módulo sin nombre.