This documentation is currently available in Portuguese. English and other languages are on the way.
Troubleshooting
Troubleshooting
Common CrossFly errors and how to resolve them — symptom, cause and fix, grouped by phase.
How-to🟡
Compilation errors (removed/renamed APIs 2026)
cannot find symbol / package does not exist — the legacy → current fix-up table.
How-to🟡
Runtime errors
Exceptions and failures at execution — MainWindow, FrameBuffer, background thread, UI in the constructor.
How-to🟡
Rendering problems
The screen doesn't reflect the code — on-demand render, alpha, layout invalidation, weak GPU.
How-to🟡
Build and Gradle
Failures before the app comes up — dependency, native library, classname, assets, Web/TeaVM.
How-to🟡
Platform-specific
"Works on desktop, breaks on the phone" — status bar, keyboard, permissions, BLE stub, density.