Tester des pull requests

De nombreuses personnes développent de nouvelles fonctionnalités ou corrigent des bogues sur GitHub. Pour aider au développement du moteur, il peut vous être demandé de tester ces pull requests avec un build Godot qui inclut le code de la pull request en question.

Grâce aux GitHub Actions, toutes les pull requests ont des builds continus disponibles. Ces builds vous permettent d'essayer les pull requests sans avoir à compiler quoi que ce soit à partir des sources.

Téléchargement d'une version compilée

Vous pouvez télécharger les builds des pull requests depuis GitHub Actions. Étant donné que seuls les utilisateurs connectés peuvent télécharger des builds directement à partir des actions GitHub, la procédure varie selon que vous ayez un compte GitHub ou non.

Note

En raison d'une limitation des actions GitHub, les builds ne sont disponibles que pendant 90 jours après la dernière mise à jour de la pull request. Si vous souhaitez toujours essayer une pull request localement, vous pouvez à la place compiler la branche de pull request à partir de la source.

Si vous avez un compte GitHub

  • Ouvrez la page de pull request. Cliquez sur l'onglet Checks en haut de la page :

../../_images/testing_pull_requests_access_checks.png

  • Dans la liste des plateformes qui apparaît à gauche, sélectionnez votre plateforme en cliquant dessus puis choisissez le type de build dont vous avez besoin (éditeur ou modèle d'exportation). En cas de doute, choisissez un build éditeur :

../../_images/testing_pull_requests_checks_platforms.png

  • Cliquez sur le menu déroulant Artifacts à droite de la page puis cliquez sur le nom de l'artefact pour le télécharger :

../../_images/testing_pull_requests_checks_artifacts.png

  • Extrayez l'archive ZIP puis exécutez l'exécutable. Notez que les binaires Windows et macOS ne sont pas signés. Cela signifie que vous devrez peut-être contourner un avertissement de sécurité avant de pouvoir exécuter l'exécutable. Si vous testez fréquemment les builds de pull request, il peut être préférable de désactiver Windows SmartScreen ou disable macOS Gatekeeper de manière permanente.

Si vous n'avez pas de compte GitHub

Si vous n'avez pas de compte GitHub et ne pouvez pas en créer un, vous pouvez utiliser le service tiers nightly.link pour générer un lien de téléchargement universel.

  • Ouvrez la page de pull request. Cliquez sur le nom de la branche du fork en haut de la page :

../../_images/testing_pull_requests_access_fork.png

  • Maintenant que vous êtes sur la page de la branche du fork, cliquez sur le dossier .github en haut de la liste des fichiers. Ensuite, cliquez sur le dossier workflows (qui se trouve à l'intérieur du dossier .github). Cliquez sur le fichier de workflow correspondant à la plateforme pour laquelle vous souhaitez télécharger des artefacts. Après avoir cliqué sur le fichier (ce qui ouvre la vue du fichier), copiez l'URL de la page dans la barre d'adresse de votre navigateur.

  • Ouvrez le site nightly.link et collez l'URL que vous venez de copier dans le champ de texte situé sous le titre Paste a GitHub link, get a nightly.link!. Après avoir collé l'URL, cliquez sur Get links sur la droite. Si le format de l'URL que vous avez collé est correct, une page comme celle-ci devrait s'afficher :

../../_images/testing_pull_requests_nightly_link.png

  • Cliquez sur l'URL de l'artefact que vous souhaitez télécharger.

  • Extrayez l'archive ZIP puis exécutez l'exécutable. Notez que les binaires Windows et macOS ne sont pas signés. Cela signifie que vous devrez peut-être contourner un avertissement de sécurité avant de pouvoir exécuter l'exécutable. Si vous testez fréquemment les builds de pull request, il peut être préférable de désactiver Windows SmartScreen ou disable macOS Gatekeeper de manière permanente.

Compilation d'une branche de pull request à partir de la source

Cette approche peut être nécessaire pour les pull requests dont la dernière mise à jour remonte à plus de 90 jours, ou pour tester des plateformes et des configurations qui ne sont pas prises en charge par la configuration des actions GitHub de Godot.

  • Ouvrez la page de pull request. Cliquez sur le nom de la branche du fork en haut de la page :

../../_images/testing_pull_requests_access_fork.png

  • Maintenant que vous êtes sur la page de la branche du fork, cliquez sur le bouton vert Code à droite de la page puis choisissez Download ZIP dans la liste déroulante :

../../_images/testing_pull_requests_fork_zip.png

  • Extrayez l'archive ZIP et suivez les instructions de compilation pour votre système d'exploitation.