# 安装与要求

> 准备好 JDK 和 Gradle，并将 CrossFly 添加到项目中——从桌面端开始。

Source: https://crossfly.dev/zh/docs/get-started/installation — CrossFly documentation. Full docs as one file: https://crossfly.dev/llms-full.txt

# 安装与要求

只需几分钟，你就能准备好在**桌面端**运行的环境——这是最快的
上手途径（快速迭代，无需模拟器）。

## 前置条件
- **JDK 17**（LTS）。请验证：
  ```bash
  java -version
  ```
- **Gradle** —— 或者直接使用项目中自带的 *wrapper*（`gradlew`）：
  ```bash
  ./gradlew --version
  ```

## 项目结构
一个 CrossFly 应用是一个 **Gradle 多模块**项目：一个 **`core`** 模块（你的 UI 和逻辑）+ 一个
**按平台划分的启动器**。将 CrossFly 依赖添加到 `core`，并包含你要运行的目标平台的启动器：
```
:core     → seu código (Windows, componentes) + dependência do CrossFly
:lwjgl3   → launcher desktop (comece por aqui)
:android  :ios  :web   → demais alvos
```
依赖（`dev.crossfly:crossfly-core` + 版本）和启动器的确切坐标来自
模板项目的 `build.gradle` —— 请按照仓库模板保持它们不变。

## 各平台要求
| 目标平台 | 需要 |
|---|---|
| 🖥️ 桌面（LWJGL3） | 只需 JDK —— **从这里开始** |
| 🤖 Android | Android SDK/NDK |
| 🍎 iOS | **macOS + Xcode** |
| 🌐 Web（TeaVM） | 一个浏览器（WebGL2） |

> **原生库：** 每个平台都会打包 `crossfly-lib`（JNI），在启动时加载（WebGL
> 除外）。在桌面端，它需要位于 `java.library.path` 中（见 [桌面](/docs/platforms/desktop-lwjgl3)）。

## 为什么从桌面端开始
桌面端提供**最短的编译→运行周期**（几秒，无需模拟器）。你在那里验证 UI，只有
当界面就绪后才转向移动端。

## 下一步
→ [快速开始：约 10 分钟完成 Hello World](/docs/get-started/quickstart)

## 另请参阅
- 权威来源：第 4 章 —— 引导与生命周期 · [平台](/docs/platforms)