安装 Godot 并针对 Android 配置项目

本指南将介绍如何执行以下步骤：

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

选择一个版本

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

下载并运行 Godot

访问 Godot 下载页面，下载适用于您的首选环境的游戏引擎。

Godot 在其下载页面上提供两种版本：标准版和 Mono 版。这两种版本皆可用于针对 Android 开发应用。对于 C# 开发，则需要使用 Mono 版本。

Godot 作为独立应用进行分发。它不要求执行安装流程；提取下载归档文件后，您便可以按原样运行它。

配置 Android 支持

配置 Android Studio SDK 设置

  1. 下载并安装最新的稳定版 Android Studio（如果您尚未这样做）。
  2. 启动 Android Studio。
  3. 在“Welcome to Android Studio”窗口中，打开 Configure 下拉菜单，然后选择 SDK Manager。
  4. 在窗口顶部，记下您计算机上的 Android SDK Location。您将需要在 Godot 编辑器中指定该位置。
  5. 在 SDK Platforms 标签页中，找到 Android 11.0 R 的列表条目。 选中该项（如果尚未选中的话）。
  6. 在 SDK Tools 标签页中，找到 NDK (Side by side)、Android SDK 命令行工具和 CMake 的列表项。选中它们（如果尚未选中的话）。
  7. 如果有任何列表项的状态设置为 Update Available，请选中其复选框以更新到最新版本。
  8. 点击 OK 按钮。确认下载并接受许可协议，以完成安装。

创建调试密钥库

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. 在“Welcome to Android Studio”窗口中，选中 Import an Android Code Sample 选项。
  3. 从列表中选择 Ndk -> Hello GL2 示例，然后点击 Next 按钮。
  4. 为项目选择一个位置，然后点击 Finish 按钮。
  5. 等待项目加载并与 Gradle 同步，然后从 Android Studio 菜单栏中依次选择 Build -> Make Project。
  6. 等待构建完成，然后验证相应目录中是否创建了 debug.keystore 文件。

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

  1. 启动 Godot 编辑器。
  2. 创建或打开项目。
  3. 从 Editor 菜单栏中依次选择 Editor -> Editor Settings...。
  4. 在 Editor Settings 窗口中，依次选择左侧面板中的 Export -> Android 项。
  5. 在右侧面板中，转到 Android Sdk Path 所对应的文本框，然后输入 Android SDK 的路径。
  6. 在 Debug Keystore 所对应文本框中，输入 debug.keystore 文件的路径。
Godot 编辑器设置中的 Android SDK 路径设置
图 1. Editor Settings 中的 Android SDK Path 字段

设置 Mono

安装 MSBuild

Mono 版本的 Godot 要求具有 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. 从“Editor”菜单栏中依次选择 Editor -> Editor Settings…。
  2. 在 Editor Settings 窗口中，依次选择左侧面板中的 Mono -> Editor 项。
  3. 从 External Editor 下拉菜单中选择所需的编辑器。
Godot“Editor Settings”中的“External Editor”设置
图 2：Editor Settings（编辑器设置）中的 External Editor 字段

适用于 Godot 的 C# 编辑器插件