Up to date

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

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.webp

  • Click the Artifacts dropdown on the right of the page:

../../_images/testing_pull_requests_checks_artifacts.webp

  • In the dropdown, click the artifact's name to download it. Remember to scroll if you cannot see the name of the platform you're looking for:

../../_images/testing_pull_requests_checks_artifacts_list.webp

  • Extract the ZIP archive then run the executable. Note that Windows and macOS binaries are not code signed. This means you may have to bypass a security warning before you can run the executable. On Windows, if you frequently test pull request builds, it may be better to disable Windows SmartScreen permanently in the Windows security settings. On macOS, see Exécution des applications Godot sur macOS for instructions on bypassing Gatekeeper.

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.

  • Open the nightly.link website and paste the URL you just copied into the text field located below the heading Paste a GitHub link, get a nightly.link!. After pasting the URL, click Get links on the right. If the format of the URL you pasted is correct, you should be presented with a page like this:

../../_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.