Build e Gradle
Falhas antes de a app subir. Formato: sintoma → causa → correção.
Dependência não resolve
Causa: módulo/coordenada errados.
Correção: confira a dependência do CrossFly no core + o módulo de plataforma
(lwjgl3/android/ios/web) no settings.gradle/build.gradle.
(Instalação)
Biblioteca nativa (crossfly-lib / SQLite3MC) não encontrada em runtime
Causa: o módulo nativo daquela plataforma não foi empacotado.
Correção: inclua o launcher/nativo correto; no desktop, garanta a crossfly-lib no
java.library.path. (Lembre: no WebGL a nativa não é carregada.)
(Desktop · Cap. 23)
:lwjgl3:run não encontra a MainWindow
Causa: o classname não aponta para a sua classe.
Correção: configure cmdline["classname"] (no launcher) ou sobrescreva getMainWindow().
(Anatomia de projeto)
Assets/fontes (roboto/fontawesome/material) não carregam
Causa: não empacotados no módulo. Correção: verifique o diretório de assets do launcher (as fontes base são carregadas no bootstrap).
Alvo Web (TeaVM) falha ao transpilar
Causa: uso de API não suportada no TeaVM. Correção: isole o código não-web (atrás de checagens de plataforma / abstração de serviço). (Web (TeaVM))