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 vers 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/oneclick.png

Dépannage

Android

If you can't see the device in the list of devices when running the adb devices command in a terminal, it will not be visible by Godot either. To resolve this:

  • Check if USB debugging is enabled and authorized on the device. Try unlocking your device and accepting the authorization prompt if you see any. If you can't see this prompt, running adb devices on your PC should make the authorization prompt appear on the device.

  • Try revoking the debugging authorization in the device's developer settings, then follow the steps again.

  • Try using USB debugging instead of wireless debugging or vice versa. Sometimes, one of those can work better than the other.

  • On Linux, you may be missing the required udev rules for your device to be recognized.