Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Utiliser l’éditeur Android

En 2023, nous avons ajouté un port Android de l'éditeur qui peut être utilisé pour créer, développer et exporter des projets 2D et 3D sur des appareils Android.

L'application peut être téléchargée à partir de la page de téléchargement de Godot ou du Google Play Store.

Note

Cet éditeur Android est en bêta-test, pendant que nous continuons à raffiner l'expérience. Voir Limitations et problèmes connus ci-dessous.

Support des appareils Android

L'éditeur Android nécessite des appareils fonctionnant sous Android 5 Lollipop ou supérieur, avec au moins le support d'OpenGL 3. Cela comprend (non exhaustif) :

Tablettes Android, téléphones grands et pliables
Netbooks gérés par Android
Les Chromebooks supportant des applications Android

Permissions pendant l'exécution

Permission d'accès à tous les fichiers : Permet à l'éditeur de créer, d'importer et de lire des fichiers de projet à partir de tous les emplacements de fichiers sur l'appareil. Sans cette autorisation, l'éditeur est toujours fonctionnel, mais a un accès limité aux fichiers et répertoires de l'appareil.
REQUEST_INSTALL_PACKAGES : Permet à l'éditeur d'installer les APKs du projet exporté.
RECORD_AUDIO <https://developer.android.com/reference/android/Manifest.permission#RECORD_AUDIO> '_ : Demandé lorsque le paramètre `audio/driver/enable_input est activé.

Trucs & Astuces

Entrée

Pour la meilleure expérience et un haut niveau de productivité, connecter un clavier et une souris bluetooth est recommandé pour interagir avec l'éditeur Android. L'éditeur Android prend en charge tous les raccourcis et contrôles habituels.
Lors de l'interaction en clavier-souris, vous pouvez réduire la taille de la barre de défilement en utilisant le paramètre d'éditeur interface/touchscreen/increase_scrollbar_touch_area.
For 2D projects, the block coding plugin can provide a block-based visual alternative to composing scripts when lacking a connected hardware keyboard.

Multi-tasking

Sur les petits appareils, activer et utiliser le mode image dans l'image (PiP) permet de facilement passer entre l'Éditeur et la fenêtre Jouer.
- Le mode image dans l'image peut être activé via le paramètre d'éditeur run/window_placement/play_window_pip_mode.
- The run/window_placement/android_window editor setting can be used to specify whether the Play window should always launch in PiP mode.
- Note : En mode image dans l'image, la fenêtre Jouer n'a pas d'accès aux entrées.

Projects sync

La synchronisation des projets via Git peut être faite en téléchargeant un client Android Git. Nous recommandons le terminal Termux, un émulateur de terminal Android qui fournit l'accès aux utilitaires terminaux communs tels que Git et SSH.
- Note : Pour utiliser Git avec le terminal Termux, vous devrez accorder une autorisation WRITE au terminal. Ceci peut être fait en exécutant la commande suivante à l'intérieur du terminal : termux-setup-storage

Plugins

Les plugins GDExtension fonctionnent comme prévu, mais requirent au développeur de plugin de fournir des binaires Android natives.

Limitations et problèmes connus

Voici les limites connues et les problèmes de l'éditeur Android :

Pas de support C#/Mono.
Editeurs de scripts externes non-supporté.
Bien qu'il soit disponible, le rendu Forward+ n'est pas recommandé en raison de graves problèmes de performance.
UX non optimisée pour les facteurs de forme de téléphones Android.
Les appareils Android Go ne disposent pas de la permission Accès à tous les fichiers requise pour l'accès en écriture/lecture du périphérique. En tant que solution temporaire, lors de l'utilisation d'un appareil Android Go, il est recommandé de créer de nouveaux projets seulement dans les répertoires Android Documents ou Téléchargements.
L'éditeur ne reprend pas correctement quand Ne gardez pas les activités est activé dans les Options pour les développeurs.
Il y a un bug avec le clavier Samsung qui provoque l'insertion d'entrées aléatoires lors de l'écriture de scripts. Il est recommandé d'utiliser le clavier Google (Gboard) à la place.

Voir aussi

Voir la liste des issues ouvertes sur GitHub liées à l'éditeur Android pour une liste des bogues connus.