Jeu vidéo

Exporter un jeu Godot 4 vers Android : APK et AAB

Par Jérôme Stéphan · 15 novembre 2026 · Lecture : 7 min

Lire en : Español · English · Français

Exporter un jeu Godot 4 vers Android : APK et AAB

Exporter un jeu Godot vers Android n'a rien de difficile, mais il faut faire les choses dans l'ordre, et les exigences de Google Play changent chaque année. Ce guide suit le chemin que j'emprunte pour mes propres jeux sous Godot 4.7.2 (novembre 2026) : un APK pour tester sur le téléphone, puis un AAB signé pour Google Play. Il complète mon guide général pour créer un jeu Android avec Godot.

Chrono Trotter sur un téléphone Android : combat contre l'Hydre
Le résultat : Chrono Trotter, exporté depuis Godot 4.7, sur un téléphone Android.

1. Ce qu'il faut installer

La documentation officielle donne cette commande pour tout installer d'un coup :

sdkmanager --sdk_root=<android_sdk_path> "platform-tools" "build-tools;35.0.1" "platforms;android-35" "cmdline-tools;latest" "cmake;3.10.2.4988404" "ndk;28.1.13356709"
Attention aux versions. La documentation de la 4.7 liste encore la série 35 du SDK, mais le modèle de compilation de Godot 4.7.2 compile avec l'API 36. Sur mon PC sont installés Build-Tools 36.1.0 et la plateforme Android 36, sans NDK ni CMake, et c'est avec cela que j'exporte mes jeux.

2. Dire à Godot où tout se trouve

Dans Éditeur > Paramètres de l'éditeur > Exporter > Android, deux chemins sont à renseigner :

Depuis Godot 4.3, il n'y a plus à créer la clé de débogage à la main : l'éditeur la génère tout seul dès qu'il connaît le chemin de Java.

3. Un APK pour tester sur le téléphone

Dans Projet > Exporter, ajoutez un profil « Android ». Par défaut, il exporte un APK pour la seule architecture arm64-v8a, celle de presque tous les téléphones actuels. La seule chose à changer est le nom unique du paquet, au format de domaine inversé : uniquement des minuscules, des chiffres, des tirets bas et des points, et chaque partie doit commencer par une lettre.

Choisissez bien ce nom. Sur Google Play, il est définitif : il ne peut être ni modifié ni réutilisé, et un paquet portant un autre nom est considéré comme une autre application.

Pour tester, activez le mode développeur et le débogage USB sur le téléphone, puis branchez-le : une icône Android apparaît en haut à droite de l'éditeur, qui exporte, installe et lance le jeu en un clic. Si le téléphone n'apparaît pas, vérifiez d'abord que adb devices le voit.

4. Un AAB signé pour Google Play

Google Play n'accepte que le format AAB pour les nouvelles applications, et Godot ne le produit qu'avec une compilation Gradle. Dans mes projets, j'utilise un second profil d'exportation, « Google Play », distinct de celui de test.

  1. Installer le modèle de compilation. Menu Projet > « Installer le modèle de compilation Android ». Il crée un projet Android dans res://android/build, auquel on n'a pas besoin de toucher.
  2. Activer « Use Gradle Build » dans le profil et choisir le format AAB.
  3. Créer une clé de signature avec la commande de la documentation :
keytool -v -genkey -keystore mygame.keystore -alias mygame -keyalg RSA -validity 10000
  1. Remplir les trois champs du profil : Release (le chemin du fichier), Release User (l'alias) et Release Password. La clé et le magasin de clés doivent avoir le même mot de passe, et mieux vaut n'utiliser que des lettres et des chiffres.
  2. Décocher « Export With Debug » au moment d'exporter.
  3. Augmenter le code de version (version/code) à chaque envoi : Google Play refuse un numéro déjà utilisé.
Gardez cette clé en lieu sûr. C'est votre clé d'importation : avec Play App Signing, Google signe avec sa propre clé les fichiers que reçoivent les utilisateurs, et peut réinitialiser la vôtre si vous la perdez. La perdre signifie quand même des démarches et des jours d'attente.

La première compilation Gradle prend plusieurs minutes, le temps de télécharger ses dépendances. Les suivantes sont bien plus rapides.

5. Les exigences de Google Play en 2026

6. Exporter en ligne de commande

Une fois que les profils fonctionnent dans l'éditeur, plus besoin de l'ouvrir. J'ai deux fichiers .bat par jeu, avec ces commandes :

godot --headless --path . --export-debug "Android" build/game.apk
adb install -r build/game.apk

godot --headless --path . --export-release "Google Play" build/game.aab

La première fabrique l'APK de test et l'installe sur le téléphone branché. La seconde fabrique l'AAB que j'envoie sur la Play Console. Si le disque système est plein, la variable d'environnement GRADLE_USER_HOME permet de déplacer le cache de Gradle sur un autre disque.

7. Les erreurs les plus fréquentes

Les messages sont donnés ici en anglais, comme dans le code de Godot.

MessageSolution
Android build template not installed in the projectProjet > Installer le modèle de compilation Android.
Android build version mismatchAprès une mise à jour de Godot, réinstaller le modèle depuis le même menu.
A valid Java SDK path is required in Editor SettingsIndiquer le dossier d'OpenJDK 17 dans les paramètres de l'éditeur.
Missing 'build-tools' directory!Installer les Build-Tools du SDK et vérifier le chemin du SDK.
"Export AAB" is only valid when "Use Gradle Build" is enabledActiver la compilation Gradle dans le profil.
Release keystore incorrectly configured in the export presetRemplir les trois champs de la clé, ou aucun.
ETC2/ASTC texture compression is requiredParamètres du projet > Rendering > Textures : activer « Import ETC2 ASTC ».
Could not install to deviceDésinstaller du téléphone l'application de même nom de paquet signée avec une autre clé.

Et ensuite ?

Une fois l'AAB en main, il reste deux étapes, que j'explique à part : préparer la fiche Google Play (images, textes et formulaires) et, avec un compte personnel récent, le test fermé avec 12 testeurs pendant 14 jours. C'est le chemin que suit Chrono Trotter. Pour vos propres projets, voir mon offre de logiciel sur mesure.

Un projet de jeu ou d'application ?

Parlons-en : je vous propose l'architecture, les délais et un prix clair.

Demander mon devis gratuitÉcrivez-moi sur WhatsApp
WhatsApp