将Godot项目导出到Android

本主题介绍如何将Godot项目导出为Android应用程序。Godot可以生成APK文件用于本地设备测试，以及Android应用程序包用于提交到Google Play商店。

安装Android构建模板

Godot使用构建模板作为起点来生成创建和构建Android应用程序所需的Gradle文件和其他数据。在导出Android构建之前，必须将构建模板导入到Godot项目中。每个版本的Godot都有其自己的模板。要将Android构建模板安装到项目中，请执行以下步骤

  1. 在Godot编辑器中打开项目。
  2. 在菜单栏中，选择**项目 -> 安装Android构建模板…**
  3. 单击**管理模板…**按钮。
  4. 在**导出模板管理器**窗口中，单击正在使用的Godot版本的**下载**按钮（当前版本）。
  5. 选择镜像位置下载文件。
  6. 下载完成后，单击**导出模板管理器**窗口中的**关闭**按钮。
  7. 在编辑器菜单栏中，选择**项目 -> 安装Android构建模板…**
  8. 将出现确认对话框。单击**安装**按钮。
Godot Export Template Manager
图1. **导出模板管理器**窗口

构建模板文件将存储在相对于项目根目录的android/build子目录中。由于此子目录的大小，您可能希望将其从项目的版本控制范围中省略。

添加Android导出预设

必须为项目创建一个Android导出预设。要创建预设，请执行以下步骤

  1. 在编辑器菜单栏中，选择**项目 -> 导出…**
  2. 在**导出**窗口中，选择**添加…**下拉菜单，然后选择**Android**选项，如下所示
Godot Export window
图2: **导出**窗口

自定义Android导出选项

为您的项目创建Android导出预设后，您可以通过在**导出**窗口中选择新的预设来配置导出选项。导出选项分组在**导出**窗口右侧的类别中。需要调整的常用选项包括

导出格式和使用自定义构建

**导出格式**选项指示是导出为APK文件还是Android应用程序包（.AAB）。对于开发期间在本地设备上的测试，APK文件更方便，因为它可以使用adb直接安装。对于您打算上传到Google Play的构建，请使用Android应用程序包。

**使用自定义构建**选项控制Godot是使用其自身的内部构建过程，还是使用传统的Gradle构建过程。如果选中**使用自定义构建**，Godot将执行Gradle构建。如果满足以下任何条件，则必须选中**使用自定义构建**

  • **导出格式**设置为Android应用程序包
  • 项目正在使用Godot Android插件系统
Export Format and Use Custom Build options
图3: **导出格式**和**自定义构建**选项

架构

**架构**部分指定要包含在构建中的CPU架构。导出包含多个架构的构建将增加导出的APK或AAB文件的大小，这会增加导出和部署到设备时的迭代时间。在开发过程中，您可以通过仅选择测试设备的架构来减少迭代时间。提交到Google Play时，应导出项目支持的所有可用架构。

Export Architectures options
图4: 导出**架构**选项

密钥库

**密钥库**部分是配置调试和发布密钥库文件的位置。这些在数字签名导出的应用程序时使用。**调试**和**发布**字段应为各自密钥库文件的路径。**调试用户**和**发布用户**字段应设置为密钥库中的别名。

Export Keystore options
图5: 导出**密钥库**选项

如果在全局**编辑器设置 -> 导出 -> Android**部分中已配置调试密钥库文件，则项目导出选项中的**调试**密钥库字段可以留空，并将使用全局调试密钥库文件作为默认值。

要创建用于上传到Google Play商店的构建，您可以使用Android Studio创建发布密钥库文件。

要为您的应用程序创建发布密钥库文件

  1. 启动Android Studio。
  2. 在**欢迎使用Android Studio**窗口中，选择**创建新项目**。
  3. 选择**无Activity**模板，然后单击**下一步**。
  4. 在**配置您的项目**屏幕中，单击**完成**以创建项目。
  5. 按照生成上传密钥和密钥库中的说明创建密钥库文件。
  6. 创建密钥库文件后，退出Android Studio并返回到Godot编辑器。
  7. 将密钥库文件添加到**发布**字段，并将**发布用户**和**发布密码**值分别输入到其各自的字段中。

版本和包

**版本**和**包**部分指定应用程序的版本代码、版本字符串、包标识符和包名称。**唯一名称**字段应设置为您的应用程序在Google Play控制台中使用的包标识符。

Export Version and Package options
图6: 导出**版本**和**包**选项

启动器图标

启动器图标部分指定用作应用程序图标的.png文件。如果未指定图标文件，Godot将使用默认图标文件。Godot支持指定旧版应用程序图标以及Android 8及更高版本中可用的自适应图标。有关创建自适应图标的技巧，请参阅自适应图标指南。

Export Launcher Icons options
图7: 导出**启动器图标**选项

导出构建

要导出构建，请按照以下步骤操作

  1. 从Godot菜单栏中选择**项目 -> 导出…**。
  2. 从预设列表中选择Android导出预设。
  3. 单击**导出**窗口底部的**导出项目**按钮。
  4. 在**保存文件**对话框中，为导出的文件选择一个名称。
  5. 取消选中**使用调试导出**复选框以创建发布版本。
  6. 单击**保存**以导出构建。
Export Save a File dialog
图7: 导出**保存文件**对话框

如果在导出预设中选中了**使用自定义构建**选项，则导出进度窗口的外观将有所不同。自定义构建显示Gradle构建过程的输出。