Внесение вклада в V8
Информация на этой странице объясняет, как внести вклад в проект V8. Пожалуйста, внимательно прочитайте ее перед отправкой своего вклада.
Получение кода
См. Как загрузить исходный код V8.
Перед внесением вклада
Запросите рекомендации в почтовой рассылке V8
Перед началом работы над значительным вкладом в V8 сначала свяжитесь с нами через список рассылки для участников проекта V8, чтобы мы могли оказать помощь и, возможно, дать рекомендации. Координация заранее значительно облегчает избегание возможных трудностей в будущем.
Подпишите CLA
Прежде чем мы сможем использовать ваш код, вам необходимо подписать Лицензионное соглашение Google для индивидуальных участников, что можно сделать онлайн. Это необходимо, так как вы остаётесь владельцем авторских прав на свои изменения, даже после того как ваш вклад станет частью нашей базы кода, и нам требуется ваше разрешение на использование и распространение вашего кода. Также нам нужно быть уверенными в ряде других вещей, например, что вы уведомите нас, если ваш код нарушает патенты других людей. Вам не нужно делать это до отправки кода на ревью и его одобрения участником проекта, но это должно быть сделано перед добавлением вашего кода в нашу базу.
Вклады, сделанные корпорациями, регулируются другим соглашением — Лицензионным соглашением о предоставлении программного обеспечения и участии корпораций.
Подпишите их онлайн здесь.
Отправка вашего кода
Исходный код V8 следует Стилевому руководству Google для C++, поэтому вам следует ознакомиться с этими рекомендациями. Перед отправкой кода необходимо пройти все наши тесты и успешно выполнить предварительные проверки:
git cl presubmit
Скрипт предварительных проверок использует линтер от Google, cpplint.py. Он является частью инструментария depot_tools и должен находиться в вашем PATH. Если у вас есть depot_tools в PATH, все должно работать.
Загрузка в инструмент кодревью V8
Все отправляемые изменения, включая изменения участников проекта, требуют проверки. Мы используем те же инструменты и процессы кодревью, что и проект Chromium. Чтобы отправить патч, вам нужно получить depot_tools и следовать инструкциям по запросу проверки (используя вашу рабочую область V8 вместо рабочей области Chromium).
Следите за сбоями или регрессиями
После получения одобрения на кодревью вы можете добавить свой патч с помощью очереди коммитов. Она запускает серию тестов и выполняет коммит, если все тесты прошли успешно. После того как ваше изменение будет закоммичено, рекомендуется следить за консолью, пока бот не завершит выполнение тестов и статус не станет зеленым после вашего изменения, так как консоль запускает несколько дополнительных тестов по сравнению с очередью коммитов.