Exportieren für Android

Das Exportieren für Android stellt weniger Anforderungen als das Kompilieren von Godot. In den folgenden Schritten wird detailliert beschrieben, was zum Einrichten des SDK und der Engine erforderlich ist.

Android-SDK herunterladen

Lade Android SDK herunten und installiere es: developer.android.com.

Wenn du Android Studio installierst, musst du es einmal ausführen, um das SDK-Setup abzuschließen.

OpenJDK 8 installieren

Lade OpenJDK 8 herunter und installiere es, neuere Versionen funktionieren nicht.

Create a debug.keystore

Android benötigt eine Debug-Keystore-Datei zur Installation auf Geräten und zur Verteilung von nicht freigegebenen APKs. Wenn du das SDK schon einmal benutzt und Projekte gebaut hast, hat ant oder eclipse wahrscheinlich eines für dich generiert (unter Linux und MacOS findest du es im Verzeichnis ~/.android).

Wenn du diese nicht finden kannst oder eine solche generieren musst, kann der Befehl keytool aus dem JDK dafür verwendet werden:

keytool -keyalg RSA -genkeypair -alias androiddebugkey -keypass android -keystore debug.keystore -storepass android -dname "CN=Android Debug,O=Android,C=US" -validity 9999 -deststoretype pkcs12

Dies wird eine debug.keystore Datei in deinem aktuellen Verzeichnis erzeugen. Du solltest sie an einen einprägsamen Ort wie z.B. %USERPROFILE%\.android\ verschieben, da du ihren Speicherort in einem späteren Schritt benötigen wirst. Weitere Informationen über die Verwendung von keytool findest du in diesem Q&A-Artikel.

Stelle sicher, dass du adb hast

Android Debug Bridge (adb) ist das Kommandozeilen-Werkzeug, das zur Kommunikation mit Android-Geräten verwendet wird. Es wird mit dem SDK installiert, aber du musst möglicherweise eine (beliebige) der Android-API-Ebenen installieren, damit es im SDK-Verzeichnis installiert wird.

Einrichtung in Godot

Rufe die Editoreinstellungen auf. Dieses Fenster enthält die Editor-Einstellungen für das Benutzerkonto im Computer (es ist unabhängig vom Projekt).

../../../_images/editorsettings.png

Scrolle nach unten zu dem Abschnitt, in dem sich die Android-Einstellungen befinden:

../../../_images/androidsdk.png

In diesem Fenster muss der Pfad zu 3 Dateien eingestellt werden:

  • Die adb ausführbare Datei (adb.exe unter Windows) - Sie kann normalerweise unter %LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe gefunden werden.
  • Die ausführbare Datei jarsigner (ab JDK 6 oder 8) - Unter Windows wird OpenJDK in ein Verzeichnis wie %PROGRAMFILES%\AdoptOpenJDK\jdk-8.0.252.09-hotspot\bin installiert. Unter Linux wird es normalerweise in ein Verzeichnis wie /usr/bin/jarsigner installiert. Der genaue Pfad kann je nach installiertem OpenJDK-Update und dem Betriebssystem deines Rechners variieren.
  • Die Debug-Datei .keystore` - Du findest sie in dem Ordner, in dem du die debug.keystore Datei abgelegt hast, die du oben erstellt hast.

Once that is configured, everything is ready to export to Android!

Providing launcher icons

Launcher icons are used by Android launcher apps to represent your application to users. Godot only requires high-resolution icons (for xxxhdpi density screens) and will automatically generate lower-resolution variants.

Godot benötigt zwei Arten von Symbolen:

  • Main Icon: The "classic" icon. This will be used on all Android versions up to Android 8 (Oreo), exclusive. Must be at least 192×192 px.
  • Adaptive Icons: Starting from Android 8 (inclusive), Adaptive Icons were introduced. Applications will need to include separate background and foreground icons to have a native look. The user's launcher application will control the icon's animation and masking. Must be at least 432×432 px.

Siehe auch

It's important to adhere to some rules when designing adaptive icons. Google Design has provided a nice article that helps to understand those rules and some of the capabilities of adaptive icons.

Vorsicht

The most important adaptive icon design rule is to have your icon critical elements inside the safe zone: a centered circle with a diameter of 66dp (264 pixels on xxxhdpi) to avoid being clipped by the launcher.

If you don't provide some of the requested icons, Godot will replace them using a fallback chain, trying the next in line when the current one fails:

  • Main Icon: Provided main icon -> Project icon -> Default Godot main icon.
  • Adaptive Icon Foreground: Provided foreground icon -> Provided main icon -> Project icon -> Default Godot foreground icon.
  • Adaptive Icon Background: Provided background icon -> Default Godot background icon.

It's highly recommended to provide all requested icons, and at least with the specified resolutions. Only this way your application will look great on all Android devices and versions.

Export für den Google Play Store

Uploading an APK to Google's Play Store requires you to sign using a non-debug keystore file; such file can be generated like this:

keytool -v -genkey -v -keystore mygame.keystore -alias mygame -keyalg RSA -validity 10000

This keystore and key are used to verify your developer identity, remember the password and keep it in a safe place! Use Google's Android Developer guides to learn more about APK signing.

Now fill in the following forms in your Android Export Presets:

../../../_images/editor-export-presets-android.png
  • Release: Enter the path to the keystore file you just generated.
  • Release User: Replace with the key alias.
  • Release Password: Key password. Note that the keystore password and the key password currently have to be the same.

Your export_presets.cfg file now contains sensitive information. If you use a version control system, you should remove it from public repositories and add it to your .gitignore file or equivalent.

Don't forget to uncheck the Export With Debug checkbox while choosing the APK's name.

../../../_images/export-with-debug-button.png

Optimizing the APK size

By default, the APK will contain native libraries for both ARMv7 and ARMv8 architectures. This increases its size significantly. To create a smaller APK, uncheck either Armeabi-v 7a or Arm 64 -v 8a in your project's Android export preset. This will create an APK that only contains a library for a single architecture. Note that applications targeting ARMv7 can also run on ARMv8 devices, but the opposite is not true.

Since August 2019, Google Play requires all applications to be available in 64-bit form. This means you cannot upload an APK that contains just an ARMv7 library. To solve this, you can upload several APKs to Google Play using its Multiple APK support. Each APK should target a single architecture; creating an APK for ARMv7 and ARMv8 is usually sufficient to cover most devices in use today.

Sie können die Größe weiter optimieren, indem Sie eine Android-Exportvorlage mit nur den Funktionen erstellen, die Sie benötigen. Weitere Informationen finden Sie unter: ref: doc_optimizing_for_size.