安装 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# 编辑器插件