安装 Godot 并为 Android 配置项目

本指南将涵盖以下步骤

  • 选择 Godot 的版本和发布版。
  • 下载并安装 Godot。
  • 为 Android 开发配置 Godot。
  • 为 C# 开发和导出配置您的系统（仅限 Godot 的 Mono 发布版）。

选择版本

尽可能使用最新稳定的 Godot 版本。对于 Android 开发，请使用 3.3 或更高版本。

下载并运行 Godot

访问Godot 下载页面以下载您首选环境的游戏引擎。

Godot 在其下载页面上提供了两个版本：标准版和 Mono 版。两者均可用于开发 Android 应用。Mono 版是 C# 开发所必需的。

Godot 作为独立应用程序分发。它不需要安装过程；解压缩下载存档后，您可以直接运行它。

配置 Android 支持

配置 Android Studio SDK 设置

  1. 如果您尚未这样做，请下载并安装最新稳定的 Android Studio 版本。
  2. 启动 Android Studio。
  3. 在“欢迎使用 Android Studio”窗口中，打开“配置”下拉菜单，然后选择“SDK 管理器”。
  4. 在窗口顶部，记下您计算机上的“Android SDK 位置”。您需要在 Godot 编辑器中指定该位置。
  5. 在“SDK 平台”选项卡中，找到“Android 11.0 R”的列表条目。如果该条目未选中，请选中它。
  6. 在“SDK 工具”选项卡中，找到“NDK（并排）”、“Android SDK 命令行工具”和“CMake”的列表条目。如果它们未选中，请选中它们。
  7. 如果任何列表条目的状态设置为“有更新可用”，请启用其复选框以更新到最新版本。
  8. 单击“确定”按钮。确认下载并接受许可协议以完成安装。

创建调试密钥库

Android 应用必须进行数字签名才能在设备上运行。对于本地测试，可以使用调试密钥库文件对应用进行签名。Android Studio 将自动创建一个默认的调试密钥库。如果您之前使用 Android Studio 的调试配置构建过应用，则debug.keystore文件应位于以下目录中

  • Microsoft Windows：C:\Users\$username\.android\debug.keystore
  • Linux/macOS：~\.android\debug.keystore

如果debug.keystore文件不存在，请执行以下步骤创建一个

  1. 启动 Android Studio。
  2. 在“欢迎使用 Android Studio”窗口中，选择“导入 Android 代码示例”选项。
  3. 从列表中选择“Ndk -> Hello GL2”示例，然后单击“下一步”按钮。
  4. 为项目选择一个位置，然后单击“完成”按钮。
  5. 等待项目加载并与 Gradle 同步，然后从 Android Studio 菜单栏中选择“构建 -> 构建项目”。
  6. 等待构建完成，然后验证debug.keystore文件是否已在相应目录中创建。

在 Godot 编辑器中设置 Android SDK 和调试密钥库位置

  1. 启动 Godot 编辑器。
  2. 创建或打开一个项目。
  3. 从“编辑器”菜单栏中选择“编辑器 -> 编辑器设置…”。
  4. 在“编辑器设置”窗口中，选择左侧面板中的“导出 -> Android”项。
  5. 在右侧面板中，转到“Android Sdk 路径”的文本框，然后输入 Android SDK 的路径。
  6. 在“调试密钥库”的文本框中，输入debug.keystore文件的路径。
Android SDK path setting in Godot editor settings
图 1. 编辑器设置中的Android Sdk 路径字段

设置 Mono

安装 MSBuild

Godot 的 Mono 版本需要 MSBuild 来构建和导出使用 C# 的项目。要安装 MSBuild，请执行以下操作

Linux 和 macOS

Microsoft Windows

配置 C# 编辑器

Godot 对编辑 C# 代码的支持非常有限。强烈建议使用外部编辑器来编辑 C# 文件。Godot 支持以下 C# 编辑器

  • Microsoft Visual Studio/Visual Studio for Mac
  • Microsoft Visual Studio Code
  • JetBrains Rider
  • MonoDevelop

要配置外部 C# 编辑器，请在 Godot 编辑器中打开一个项目，然后执行以下步骤

  1. 从编辑器菜单栏中选择“编辑器 -> 编辑器设置…”。
  2. 在“编辑器设置”窗口中，选择左侧面板中的“Mono -> 编辑器”项。
  3. 从“外部编辑器”下拉菜单中选择所需的编辑器。
External editor setting in Godot editor settings
图 2：编辑器设置中的外部编辑器字段

Godot 的 C# 编辑器插件