AVISO JavaFX: configuração JavaFX não suportada: classes carregadas de 'Módulo sem nome @...'

Problema:

Ao instalar e executar o JavaFX, os usuários encontram um aviso informando "Configuração JavaFX não suportada: classes foram carregadas de 'módulo sem nome @...'."

Antecedentes:

Este aviso decorre da introdução do Java Platform Module System (JPMS) no Java 9. Os módulos JavaFX devem ser carregados como "módulos nomeados" do caminho do módulo, não do caminho da classe.

Solução:

Para resolver isto:

• Certifique-se de que o JavaFX esteja no caminho do módulo: Adicione o JavaFX ao caminho do módulo usando a opção --module-path.
• Resolver JavaFX como módulos nomeados: Para aplicativos não modulares, use a opção --add-modules para forçar o Java a resolver módulos JavaFX como nomeados módulos.
• Aplicativos modulares: Use a opção --module para iniciar seu aplicativo como um módulo com as diretivas require apropriadas no descritor module-info.
• Use uma distribuição JDK com JavaFX: Instale uma distribuição JDK que inclua JavaFX, como BellSoft Liberica JDK ou Azul Zulu JDK, para carregar JavaFX como módulos nomeados automaticamente.
• Ignore o aviso: A partir do JavaFX 21, ignorar o aviso é uma opção, mas usar configurações não suportadas pode levar a problemas futuros.

Implantação:

• Exigir que os clientes tenham JRE com JavaFX: Certifique-se de que os clientes tenham um JRE com JavaFX instalado.
• Distribua um aplicativo independente: Crie um aplicativo independente usando ferramentas como jlink ou imagem nativa para agrupar o aplicativo , bibliotecas e JRE juntos.
• Arquivo JAR "Fat" executável: Incorpore JavaFX e todas as dependências em um arquivo JAR executável. No entanto, esta abordagem não é implicitamente suportada, pois carrega JavaFX do módulo sem nome.