为Android平台编译

为Android平台编译

注意

对于大多数情况,使用内置部署程序和导出模板就足够了.手动编译Android APK对于部署程序的自定义版本或自定义程序包最有用.

此外,在尝试构建自定义导出模板之前,您仍然需要按照为Android导出教程中提到的步骤进行操作.

需求

要在Windows、Linux或macOS下进行编译,需要以下内容:

Python 3.5+.
SCons 3.0+ 构建系统.
Android SDK (命令行工具就足够了).
- 所需的SDK组件将被自动安装.
- 在Linux上面,**不要使用发行版存储库提供的Android SDK,因为它通常会过时**.
Gradle(如果缺少,将自动下载并安装).
JDK 8 ( OpenJDK 或 Oracle JDK).
- 目前不支持JDK 9或更高版本.
- 您可以从 ojdkbuild 下载一个版本.

参见

有关Godot的SCons用法的一般概述,请参阅构建系统介绍.

设置构建系统

设置环境变量``ANDROID_SDK_ROOT``指向 Android SDK.如果你下载了Android命令行工具,这将是您提取ZIP存档内容的文件夹.
在此文件夹中安装必要的SDK组件:
- 通过运行以下命令接受SDK组件许可证,其中``android_sdk_path``是android SDK的路径,然后用``y``回答所有提示:
```
tools/bin/sdkmanager --sdk_root=<android_sdk_path> --licenses
```
- 运行以下命令完成安装,其中 ``android_sdk_path``是Android SDK的路径.
```
tools/bin/sdkmanager --sdk_root=<android_sdk_path> "platform-tools" "build-tools;30.0.3" "platforms;android-29" "cmdline-tools;latest" "cmake;3.10.2.4988404"
```

参见

要在Windows上设置环境变量,按 Windows + R,输入 “control system” ,然后在左侧窗格中点击 Advanced system settings ,然后在出现的窗口中点击 Environment .

参见

要在Linux或macOS上设置环境变量,使用 export ANDROID_SDK_ROOT=/path/to/android-sdk ,其中 /path/to/android-sdk 指向SDK目录的根目录.

构建导出模板

Godot需要两个Android导出模板:优化的”发布”模板(android_release.apk)和调试模板(android_debug.apk). 由于Google将要求所有APK从2019年8月开始包含ARMv8(64位)库,因此以下命令将构建包含ARMv7和ARMv8库的APK.

编译标准导出模板的方法是在Godot根目录下调用SCons,参数如下:

发布模板(在导出时未选中”启用调试”的情况下使用)

scons platform=android target=release android_arch=armv7
scons platform=android target=release android_arch=arm64v8
cd platform/android/java
# On Windows
.\gradlew generateGodotTemplates
# On Linux and macOS
./gradlew generateGodotTemplates

生成的APK将位于 bin/android_release.apk.

调试模板(用于在导出时选中”启用调试”的情况下使用)

scons platform=android target=release_debug android_arch=armv7
scons platform=android target=release_debug android_arch=arm64v8
cd platform/android/java
# On Windows
.\gradlew generateGodotTemplates
# On Linux and macOS
./gradlew generateGodotTemplates

生成的APK将位于 bin/android_debug.apk.

添加对x86设备的支持

如果你还想包括对x86和x86-64设备的支持,在用Gradle构建APK之前,用 android_arch=x86 和 android_arch=x86_64 参数第三次和第四次运行SCons命令.例如,对于发布模板:

scons platform=android target=release android_arch=armv7
scons platform=android target=release android_arch=arm64v8
scons platform=android target=release android_arch=x86
scons platform=android target=release android_arch=x86_64
cd platform/android/java
# On Windows
.\gradlew generateGodotTemplates
# On Linux and macOS
./gradlew generateGodotTemplates

这将创建一个适用于所有平台的胖二进制文件.导出项目的最终APK大小取决于您在导出时选择支持的平台；换句话说,未使用的平台将从APK中删除.

清理生成的导出模板

您可以使用以下命令删除生成的导出模板:

cd platform/android/java
# On Windows
.\gradlew cleanGodotTemplates
# On Linux and macOS
./gradlew cleanGodotTemplates

使用导出模板

作为Android的导出模板,Godot需根据与编辑器相同的版本/提交编译发布版和调试版APK.如果您使用官方二进制文件作为编辑器,请确保安装匹配的导出模板,或者从相同版本构建自己的模板.

导出游戏时,Godot将打开APK,更改其中的一些内容并添加文件.

安装模板

新编译的模板(android_debug.apk 和 android_release.apk)必须使用各自的名称复制到Godot的模板文件夹中.模板文件夹可以位于:

Windows: %APPDATA%\Godot\templates\<version>\
Linux: $HOME/.local/share/godot/templates/<version>/
macOS: $HOME/Library/Application Support/Godot/templates/<version>/

<version> 的格式为 major.minor[.patch].status ,使用Godot源代码库中 version.py 的值(例如 3.0.5.stable 或 3.1.dev).您还需要将此相同的版本字符串写入到导出模板旁边的 version.txt 文件中.

但是,如果要编写自定义模块或自定义C++代码,则可能需要在此处将APK配置为自定义导出模板: