Участие в проекте WebRTC

Лицензионное соглашение

WebRTC приветствует патчи/расширения для функций и исправлений ошибок!

Для участников, не входящих в Google, следуйте инструкциям, приведенным в Лицензионном соглашении с индивидуальным участником Google . Во всех случаях участники должны подписать лицензионное соглашение, прежде чем вклад может быть принят. Пожалуйста, заполните соглашение для физического или юридического лица в зависимости от обстоятельств.

Предоставление образцов

Если вы планируете добавить новый образец или внести существенные изменения в существующий образец, мы рекомендуем вам начать с создания новой проблемы , где мы сможем обсудить детали.

При создании нового образца или обновлении существующего убедитесь, что вы также создали или обновили все существующие тесты. Все тесты в этом репозитории реализованы как тесты пользовательского интерфейса Nightwatch.JS, поэтому используйте тот же дизайн в своих собственных.

инструкции

Вклад вашего первого патча

Вы должны сделать некоторую подготовку, чтобы загрузить свой первый CL:

Проверьте и создайте код
Заполнить Контрибьюторское соглашение (см. выше)
Если вы никогда раньше не отправляли код, вы должны добавить свое имя (или имя вашей организации, если соглашение об участии подписано вашей организацией) и контактную информацию в файле AUTHORS .
Перейдите на страницу https://webrtc.googlesource.com/new-password и войдите в свою учетную запись электронной почты. Это должна быть та же учетная запись, которую возвращает git config user.email
Затем запустите: git cl creds-check . Если вы получаете какие-либо ошибки, обратитесь за помощью на обсуждение-webrtc

Вам не придется повторять вышеописанное. После всего этого вы готовы к загрузке:

Загрузка вашего первого патча

Теперь, когда вы настроили свою учетную запись, вы можете выполнить фактическую загрузку:

Сделай это:
- Предполагая, что вы находитесь в основной ветке:
  - git checkout -b my-work-branch
- Вносите изменения, стройте локально, запускайте тесты локально
  - git commit -am "Changed x, and it is working"
  - git cl upload
  Это откроет текстовый редактор, показывающий все локальные сообщения фиксации, что позволит вам изменить его до того, как оно станет описанием CL.
  Правильно заполните запись об ошибке. Укажите префикс системы отслеживания проблем и номер проблемы, разделенные двоеточием, например, webrtc:123 или chromium chromium:12345 . Если у вас нет префикса системы отслеживания проблем и номера проблемы, просто добавьте None .
  Сохраните и закройте файл, чтобы продолжить загрузку на сервер проверки кода WebRTC.
  Команда напечатает ссылку вида https://webrtc-review.googlesource.com/c/src/+/53121 . если все пойдет хорошо.
Нажмите на эту ссылку CL
Если вы не вошли в систему, нажмите кнопку «Войти» в правом верхнем углу и войдите, используя свой адрес электронной почты.
Нажмите «Начать проверку» и добавьте рецензента. Вы можете найти рецензентов в файлах OWNERS по всему репозиторию (выберите того, кто ближе всего к вашим изменениям)
Отвечайте на любые отзывы рецензентов:
- Вносите изменения, стройте локально, запускайте тесты локально
  - git commit -am "Fixed X and Y"
  - git cl upload
После того, как рецензент утвердит (одобрит) патч, попросите его поставить его в очередь на фиксацию.

ВНИМАНИЕ. В Windows вам нужно будет запустить вышеуказанное в оболочке Git bash, чтобы gclient нашел файл .gitcookies .

Триботы

Если вы много работаете в WebRTC, вы можете подать заявку на пробные права . Это означает, что вы можете запускать trybots , которые запускают все тесты на всех платформах. Для этого отправьте сообщение об ошибке на bugs.webrtc.org и попросите команду EngProd предоставить вам права на пробную версию.

Чтобы запустить пробную работу, загрузите CL, как описано выше, и нажмите пробный запуск CQ или выберите Trybots в пользовательском интерфейсе Gerrit. Для этого у вас должны быть права на попытку. В противном случае попросите вашего рецензента запустить ботов для вас.