Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Déploiement en un clic

Qu'est-ce que le déploiement en un clic ?

Le déploiement en un clic est une fonction qui est disponible une fois qu'une plate-forme est correctement configurée et qu'un périphérique pris en charge est connecté à l'ordinateur. Comme les choses peuvent mal tourner à plusieurs niveaux (la plate-forme peut ne pas être configurée correctement, le SDK peut être mal installé, le périphérique peut être mal configuré, etc.), il est bon de faire savoir à l'utilisateur qu'il existe.

Après avoir ajouté un préréglage d'exportation Android marqué comme Runnable, Godot peut détecter quand un périphérique USB est connecté à l'ordinateur et proposer à l'utilisateur d'exporter, d'installer et d'exécuter automatiquement le projet (en mode débogage) sur le périphérique. Cette fonctionnalité est appelée déploiement en un clic.

Note

Le déploiement en un clic n'est disponible que si vous avez ajouté un modèle d'exportation marqué comme Runnable dans la boîte de dialogue Export. Vous pouvez marquer plusieurs modèles d'exportation comme runnable, mais un seul modèle par plate-forme peut être marqué comme runnable. Si vous marquez un deuxième préréglage dans une plate-forme donnée comme étant runnable, l'autre préréglage ne sera plus marqué comme étant runnable.

Plateformes prises en charge

  • Android : Exporte le projet avec le débogage activé et l'exécute sur l'appareil connecté.

    • Veillez à suivre les étapes décrites dans Exportation pour Android. Sinon, le bouton de déploiement en un clic n'apparaîtra pas.

    • Si vous avez plus d'un appareil connecté, Godot vous demandera dans quel appareil le project sera exporté.

  • HTML5 : Démarre un serveur web local and lance le projet exporté en ouvrant le navigateur web par défaut.

Le support pour d'avantage de platformes comme IOS est prévu.

Utilisation du déploiement en un clic

  • Si vous déployez sur Android, activez le mode développeur sur votre appareil mobile puis activé le débogage USB dans les paramètres de l'appareil.

  • Après avoir activé le débogage USB, connectez l'appareil à votre PC en utilisant un câble USB.

    • Pour les utilisateurs avancés, il devrait également être possible d'utiliser l'ADB sans fil.

  • Assurez vous qu'il y ait un préréglage d'exportation marqué en tant que Runnable pour la platforme cible (Android ou HTML5).

  • Si tout est correctement configuré et qu'il n'y a pas d'erreurs, les icônes spécifiques aux plateformes apparaîtront dans le coin en haut à droite de l'éditeur.

  • Cliquez le bouton pour exporter sur la platforme désirée en un clique.

../../_images/remote_debug.webp

Dépannage

Android

Si vous ne pouvez pas voir le périphérique dans la liste des périphériques en exécutant la commande adb devices dans un terminal, il ne sera pas non plus visible par Godot. Pour résoudre ce problème :

  • Vérifiez si le débogage USB est activé et autorisé sur l'appareil. Essayez de déverrouiller votre appareil et d'accepter l'invite d'autorisation si vous en voyez une. Si vous ne voyez pas cette invite, l'exécution de adb devices sur votre PC devrait faire apparaître l'invite d'autorisation sur l'appareil.

  • Essayez de révoquer l'autorisation de débogage dans les paramètres du développeur de l'appareil, puis suivez à nouveau les étapes.

  • Essayez d'utiliser le débogage USB au lieu du débogage sans fil ou vice versa. Parfois, l'un des deux fonctionne mieux que l'autre.

  • Sous Linux, il se peut qu'il vous manque les `udev' règles<https://github.com/M0Rf30/android-udev-rules>`__ nécessaires pour que votre périphérique soit reconnu.