KorGE 游戏引擎使用教程
项目地址: https://gitcode.com/gh_mirrors/ko/korge KorGE 是一个现代的多平台游戏引擎，专为 Kotlin 设计。本教程旨在帮助开发者快速理解其基本架构，包括项目的目录结构、启动文件以及关键的配置文件。
1. 项目目录结构及介绍
KorGE 的仓库遵循了一个典型的 Kotlin 多模块工程布局，下面是其主要目录和组件的简要说明：
korlibs/korge
├── build.gradle.kts // 工程构建脚本
├── CODE_OF_CONDUCT.md // 代码行为准则
├── LICENSE // 许可证文件
├── README.md // 项目介绍和快速入门指南
├── gitignore // Git 忽略文件列表
├── editorconfig // 编辑器配置文件
├── gradle // Gradle 目录，包含自定义脚本等
│ ├── properties // Gradle 属性配置
│ └── wrapper // Gradle Wrapper 相关文件
├── settings.gradle.kts // 设置脚本，用于引入子项目
├── korge // 主项目源码，含有核心功能
├── korge-gradle-plugin // Gradle 插件相关，便于多平台编译
├── korge-sandbox // 示例/实验模块，用于快速测试和开发
├── ... 更多模块省略 ...
每个模块通常包含以下子目录，以 korge 模块为例：
- src
- commonMain：共享代码，适用于所有目标平台。
- androidMain, jvmMain, jsMain, iosMain 等：特定平台的代码实现。
- 对应的 test 目录存放各平台的测试代码。
2. 项目的启动文件介绍
KorGE 的启动逻辑通常分散在多个模块中，但开发或测试时，可以直接查看和运行 korge-sandbox 模块中的 src/commonMain/kotlin/Main.kt 文件，这是一个典型的起点。此文件可能包含了初始化游戏循环、加载资源和启动游戏逻辑的基本代码。通过命令行如 /gradlew :korge-sandbox:runJvm 可以运行 JVM 版本进行调试。
3. 项目的配置文件介绍
- build.gradle.kts: 工程主构建脚本，定义了整个项目的依赖关系、插件应用、编译目标等关键信息。它负责整个KorGE的构建逻辑，包括多平台编译设置。
- settings.gradle.kts: 控制哪些子项目被包含进这个多模块项目中。
- gradle.properties: 存储Gradle构建过程中的属性配置，例如版本号或者特殊的构建参数。
- korge-gradle-plugin 中的相关脚本：提供了定制化的Gradle插件，简化KorGE项目的构建流程，特别是处理多平台发布和配置。
请注意，实际操作时需参照仓库中的最新文件和注释来获取最准确的信息，因为上述内容是基于提供的概览性描述概括的。对于具体的配置细节和最新的使用方法，建议参考KorGE的官方文档和仓库中的最新版本说明。