libGDX 项目快速搭建与配置指南 - 使用 gdx-setup

柏纲墩Dean

于 2024-09-11 07:24:51 发布

阅读量548

点赞数 15

本文链接：https://blog.csdn.net/gitblog_00815/article/details/142114819

版权

libGDX 项目快速搭建与配置指南 - 使用 gdx-setup

gdx-setup :octocat: Alternative gdx-setup application - create your LibGDX projects with ease! 项目地址: https://gitcode.com/gh_mirrors/gd/gdx-setup

本指南将引导您通过 czyzby/gdx-setup 这一替代官方libGDX项目创建工具，来理解和构建您的LibGDX项目。我们将重点讲解三个核心部分：项目目录结构、启动文件以及配置文件，以便让您能够顺利开始开发。

1. 项目目录结构及介绍

当您使用gdx-liftoff（基于gdx-setup的分支或后续更新）生成项目后，您将会得到一个具有标准LibGDX项目结构的工程：

YourProjectName
├── assets       # 资源文件夹，存放所有游戏资产，如图像、音频、字体等。
│   └── ...
├── core         # 核心项目模块，包含了游戏逻辑，适用于所有平台。
│   ├── src      # 源代码文件夹，放置主游戏类和其他共享代码。
│   │   └── main
│   │       ├── kotlin 或 java  # 根据选择的语言，放置主类和其他业务逻辑。
│   │       └── resources        # 额外资源，如配置文件，非平台特定资源。
│   └── build.gradle.kts 或 build.gradle  # Gradle构建脚本。
├── android      # Android平台专属模块。
│   └── ... similary structured as core with platform specifics.
├── ios          # iOS（RoboVM）平台模块（如果启用）。
│   └── ...
├── html         # HTML/WebGL平台模块。
│   └── ...
├── desktop      # 桌面端平台模块。
│   └── ...
└── build.gradle # 主构建脚本，链接各子项目。

每个平台模块都含有自己的Gradle构建文件，确保可以独立编译和运行。

2. 项目的启动文件介绍

在core模块下的src/main/(kotlin/java)目录中，您会找到项目的主要入口点，通常是名为Main或您自定义的类。例如，在Java项目中，这个类通常扩展自com.badlogic.gdx.ApplicationAdapter或者更具体的，如果您选择了模板，可能直接继承了更丰富的基类。这是一个示例的启动类结构：

package io.github.some_example_name;

import com.badlogic.gdx.ApplicationAdapter;
import com.badlogic.gdx.Gdx;
import com.badlogic.gdx.graphics.GL20;
import com.badlogic.gdx.graphics.OrthographicCamera;
import com.badlogic.gdx.math.Rectangle;

public class Main extends ApplicationAdapter {
    private OrthographicCamera camera;

    @Override
    public void create() {
        camera = new OrthographicCamera();
        // 初始化其他游戏元素...
    }

    @Override
    public void render() {
        Gdx.gl.glClearColor(1, 0, 0, 1);
        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);
        // 渲染游戏逻辑...
    }
    
    // 其他生命周期方法略...
}

3. 项目的配置文件介绍

3.1 `build.gradle.kts` / `build.gradle`

这是项目的主构建脚本，控制了整个项目的依赖关系、构建规则等。它导入必要的库，定义了各个模块，并指定它们之间的依赖关系。对于Kotlin DSL版本的构建脚本，示例如下：

plugins {
    id("com.android.application") version "x.y.z" apply false
    id("com.android.library") version "x.y.z" apply false
    id("org.jetbrains.kotlin.jvm") version "1.5.31" apply false
}

subprojects {
    repositories {
        mavenCentral()
    }
    
    dependencies {
        implementation("com.badlogicgames.gdx:gdx:$gdxVersion")
        // 添加其他依赖...
    }
}