构建与 Gradle

app 启动前的失败。格式：症状 → 原因 → 修复。

依赖无法解析

原因： 模块/坐标错误。 修复： 检查 core 中 CrossFly 的依赖 + settings.gradle/build.gradle 中的平台模块（lwjgl3/android/ios/web）。（安装）

原因： 该平台的原生模块没有被打包。 修复： 引入正确的 launcher/原生库；在桌面端，确保 crossfly-lib 位于 java.library.path 中。（记住：在 WebGL 上原生库不会被加载。）（桌面 · 第 23 章）

原因： classname 没有指向你的类。 修复： 配置 cmdline["classname"]（在 launcher 中）或重写 getMainWindow()。（项目结构剖析）

原因： 没有打包进模块。 修复： 检查 launcher 的资源目录（基础字体在 bootstrap 阶段加载）。

原因： 使用了 TeaVM 不支持的 API。 修复： 隔离非 web 代码（放在平台检查/服务抽象的背后）。（Web (TeaVM)）