Тестування тягових запитів

Багато людей розробляють нові функції або виправляють помилки на GitHub. Щоб допомогти з розробкою механізму, вас можуть попросити перевірити ці запити на отримання за допомогою збірки Godot, яка містить код відповідного запиту.

Завдяки GitHub Actions усі запити на витягування <https://github.com/godotengine/godot/pulls>`__ мають безперервні збірки. Ці збірки дозволяють випробувати запити на витяг без необхідності компілювати що-небудь із джерела.

Завантаження скомпільованої збірки

Ви можете завантажити збірки запитів на отримання з GitHub Actions. Оскільки лише авторизовані користувачі можуть завантажувати збірки безпосередньо з GitHub Actions, процедура залежить від того, чи є у вас обліковий запис GitHub чи ні.

Примітка

Через обмеження GitHub Actions збірки доступні лише протягом 90 днів після останнього оновлення запиту на отримання. Якщо ви все ще бажаєте спробувати запит на витягування локально, ви можете натомість compile the pull request branch from source.

Якщо у вас є обліковий запис GitHub

  • Відкрийте сторінку запиту на отримання. Натисніть вкладку Чеки у верхній частині сторінки:

../../_images/testing_pull_requests_access_checks.webp

  • Натисніть спадне меню Артефакти праворуч на сторінці:

../../_images/testing_pull_requests_checks_artifacts.webp

  • У розкривному списку натисніть назву артефакту, щоб завантажити його. Не забудьте прокрутити, якщо ви не бачите назву платформи, яку шукаєте:

../../_images/testing_pull_requests_checks_artifacts_list.webp

  • Розпакуйте ZIP-архів і запустіть виконуваний файл. Зауважте, що двійкові файли Windows і macOS не підписані кодом. Це означає, що вам, можливо, доведеться обійти попередження безпеки, перш ніж ви зможете запустити виконуваний файл. У Windows, якщо ви часто тестуєте збірки запитів на отримання, можливо, краще назавжди вимкнути Windows SmartScreen у налаштуваннях безпеки Windows. У macOS перегляньте Запуск застосунків Godot на macOS інструкції щодо обходу Gatekeeper.

Якщо у вас немає облікового запису GitHub

Якщо у вас немає облікового запису GitHub і ви не можете його зареєструвати, ви можете скористатися сторонньою службою nightly.link, щоб створити універсальне посилання для завантаження.

  • Відкрийте сторінку запиту на отримання. Натисніть назву гілки fork у верхній частині сторінки:

../../_images/testing_pull_requests_access_fork.png

  • Тепер, коли ви перебуваєте на сторінці гілки форка, натисніть папку .github у верхній частині списку файлів. Потім клацніть папку workflows (яка знаходиться всередині папки .github). Клацніть файл робочого процесу для платформи, для якої ви хочете завантажити артефакти. Після натискання файлу (що відкриває перегляд файлу), скопіюйте URL-адресу сторінки з адресного рядка браузера.

  • Відкрийте веб-сайт nightly.link і вставте URL-адресу, яку ви щойно скопіювали, у текстове поле під заголовком Вставте посилання GitHub, отримайте nightly.link!. Вставивши URL-адресу, натисніть Отримати посилання праворуч. Якщо формат URL-адреси, який ви вставили, правильний, вам має бути представлена така сторінка:

../../_images/testing_pull_requests_nightly_link.png

  • Натисніть URL-адресу артефакту, який ви хочете завантажити.

  • Розпакуйте ZIP-архів і запустіть виконуваний файл. Зауважте, що двійкові файли Windows і macOS не підписані кодом. Це означає, що вам, можливо, доведеться обійти попередження безпеки, перш ніж ви зможете запустити виконуваний файл. Якщо ви часто тестуєте збірки запитів на підключення, можливо, краще назавжди вимкнути Windows SmartScreen або вимкнути macOS Gatekeeper.

Компіляція гілки запиту на отримання з джерела

Цей підхід може знадобитися для запитів на витягування, які востаннє оновлювалися понад 90 днів тому, або для тестування на платформах і конфігураціях, які не підтримуються налаштуваннями Godot GitHub Actions.

Завантаження заархівованої гілки запиту на отримання

  • Відкрийте сторінку запиту на отримання. Натисніть назву гілки fork у верхній частині сторінки:

../../_images/testing_pull_requests_access_fork.png

  • Тепер, коли ви перебуваєте на сторінці гілки форка, натисніть зелену кнопку Код праворуч на сторінці, а потім виберіть Завантажити ZIP у спадному списку:

../../_images/testing_pull_requests_fork_zip.png

  • Розпакуйте ZIP-архів і дотримуйтесь інструкцій compiling для вашої операційної системи.

Перевірка гілки запиту на отримання за допомогою git

Крім того, ви можете перевірити запит на отримання безпосередньо за допомогою git:

  • Відкрийте сторінку запиту на отримання. Зверніть увагу на номер запиту на отримання (PR_NUMBER) і назву гілки (BRANCH_NAME), але без імені користувача.

../../_images/testing_pull_requests_command_line_checkout.webp

  • Створіть команду за цим шаблоном:

git fetch upstream pull/PR_NUMBER/head:BRANCH_NAME

Отже, для наведеного вище запиту на витяг фактична команда буде такою:

# Fetch PR branch locally
git fetch upstream pull/48734/head:editor_file_dialog_filter_sort

  • Після завершення завантаження запиту на отримання перевірте його гілку:

git checkout editor_file_dialog_filter_sort

  • Дотримуйтесь інструкцій compiling для вашої операційної системи.