一、快速入门

本篇文章省略了IOS和HTML部分，如果需要可以点击官方文档进行查看。

搭建开发环境

在开始使用 libGDX 之前，需要有一个 IDE (集成开发环境)。java 开发中任何一款IDE都可以。如果您已经安装了 IDE，可以跳到下一步。

在Java 开发中，有着许多不同的 IDE。它们都有一些小的优点和缺点，但是最终它们都完成了自己的工作，所以你可以自由选择你最喜欢的IDE。

1. Android Studio 对于那些不仅希望开发桌面应用，还希望开发移动平台的开发者，推荐使用 Android Studio。

   • JDK：由 Android Studio 提供。
   • IDE: Android Studio
   • Android：开箱即用。
   • IOS: RoboVM

2. IDEA

   • JDK 8+: 有不同的发行版，但是Adoptium 应该适合你的需要

   目前，libGDX 项目不支持 JDK 16，因为 Gretty 还不支持 Gradle 7。因此，建议您使用 JDK 8-15！

   • IDE: IEDA 社区版
   • Android: Android SDK
   • IOS: RoboVM

3. Eclipse

   • JDK 8+: 有不同的发行版，但是 Adoptium 应该适合你的需要

   目前，libGDX 项目不支持 JDK 16，因为 Gretty 还不支持 Gradle 7。因此，建议您使用 JDK 8-15！

   • IDE: Eclipse
   • Android: 虽然没有得到官方的支持，但是你可以使用 Andmore 或者修改一个老版本的 ADT
   • IOS: RoboVM

4. NetBeans

   • JDK 8+: 有不同的发行版，但是 Adoptium 应该适合你的需要

   目前，libGDX 项目不支持 JDK 16，因为 Gretty 还不支持 Gradle 7。因此，建议您使用 JDK 8-15！

   • IDE: NetBeans & NetBeans Gradle Plugin
   • Android: 没有得到官方的支持。
   • IOS: 没有得到官方的支持

5. 不想用IDE 也可以完全不使用任何 IDE 来开发 libGDX 应用程序，只需使用记事本或 Vim 之类的简单文本编辑器。一般不推荐这样做，因为 ide 提供了一些非常方便的特性，比如代码完成和错误检查。但是，如果您坚持这样做: libGDX 应用程序是 Gradle 应用程序，因此可以通过命令行构建和执行它们。

   • JDK 8+: 有不同的发行版，但是 Adoptium 应该适合你的需要

   目前，libGDX 项目不支持 JDK 16，因为 Gretty 还不支持 Gradle 7。因此，建议您使用 JDK 8-15！

   • Android: Android SDK
   • 设置ANDROID_HOME环境变量或者使用gradle.properties配置文件。

创建一个工程

现在您已经有了一个开发环境，可以创建您的第一个 libGDX 项目。libGDX 为此提供了一个设置工具，可以生成所有必需的文件。

1. 下载libGdx Project Setup Tool: 点击 stable Release 下载
2. 打开命令行，执行：

	java -jar ./gdx-setup_latest.jar

gdx-setup_latest.jar为下载的工具。运行后打开如下界面：

。

• Name: 游戏应用程序的名称; 推荐用“-”号隔开的小写字母，例如：my-gdx-game。
• Package: Java的包名，例如：com.badlogic.mygame。
• Game class: 游戏运行的主类，例如：MyGdxGame。
• Destination: 生成的项目存储路径。
• Android SDK: Android SDK 的安装位置。如果安装了Android Studio，可以启动 Android Studio 并单击“ Configure”-> “ SDK Manager”，即可查看其Android SDK 的安装位置。
• Sub Project: libGDX 是跨平台的。目前包含了Desktop, Android, Ios, Html四个模块(Ios,Html没试过，这里我就勾Desktop和Android两个模块，如果没有勾Android的话上面就不需要选择Android SDK的目录的，如果选择了，那就必须选择Android SDK的目录)
• Extensions: libgdx提供的扩展模块。
  • Bullet：一款3D物理引擎库
  • FreeType：字体相关的包，libgdx只能显示英文，如果需要适配其他语言，比如中文，则可以使用freetype。但是要注意，它不支持html平台。
  • Tools：一套工具，包括: 粒子编辑器(2d/3d) ，位图字体和图像纹理包装器。
  • Controllers: 处理控制器(例如 xbox360控制器)
  • Box2d: Box2d物理引擎。
  • Box2dlights: 二维灯光框架，使用 box2d 进行光线投射，使用 OpenGL ES 2.0进行渲染。
  • Ashley: 一个用 Java 编写的微型实体框架。
  • Ai: 人工智能框架。
• Show Third Party Extensions按钮：点击这里可以选择其他第三方提供的模块。
• Advance按钮：高级设置，可以设置maven的mirror url, 是否使用kotline等相关信息。
• Generate按钮：生成，点击后就可以生成创建项目了。 当点击Generate按钮后，出现如下信息，则项目已经创建成功了。

目录结构

其目录结构如下：

导入

1. IntelliJ IDEA or Android Studio：你可以选择打开 build.gradle 文件，然后选择“ Open as Project”开始。
2. Eclipse：选择File -> Import... -> Gradle -> Existing Gradle Project(确保在当前workspace中不包括新生成的项目)。
3. NetBeans：File -> Open Project。

如果某些依赖项尚未下载，则可能需要在初始导入之后刷新 Gradle 项目。 以下我用eclipse和Android Studio导入(其他IDE都差不多，为了篇幅这里就不写上了)：

1. Eclipse

2. Android Studio

运行

1. eclipse

2. Android Studio