安装 Godot 并配置 Android 项目

本指南将涵盖以下步骤

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

选择版本

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

下载并运行 Godot

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

Godot 在其下载页面上提供了两个发布版：标准版和 Mono 版。这两个版本都可以用于 Android 开发。C# 开发需要 Mono 发布版。

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

配置 Android 支持

配置 Android Studio SDK 设置

  1. 如果您尚未安装，请下载并安装最新稳定版的 Android Studio。
  2. 启动 Android Studio。
  3. 在“欢迎使用 Android Studio”窗口中，打开 Configure 下拉菜单并选择 SDK Manager。
  4. 在窗口顶部，记下您的计算机上的 Android SDK Location（Android SDK 位置）。您将需要在 Godot 编辑器中指定该位置。
  5. 在 SDK Platforms 选项卡中，找到 Android 11.0 R 的列表条目。如果未勾选，请勾选该项。
  6. 在 SDK Tools 选项卡中，找到 NDK (Side by side)、Android SDK Command-line Tools 和 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. 在“欢迎使用 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 文件的路径。
Android SDK path setting in Godot editor settings
图 1. Editor Settings 中的 Android Sdk Path 字段

设置 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. 从编辑器菜单栏中选择 Editor -> Editor Settings…。
  2. 在 Editor Settings 窗口中，选择左侧面板中的 Mono -> Editor 项。
  3. 从 External Editor 下拉菜单中选择所需的编辑器。
External editor setting in Godot editor settings
图 2：Editor Settings 中的 External Editor 字段

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