Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Вклад в проект 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 или webrtc:123 chromium:12345 . Если у вас нет префикса системы отслеживания проблем и номера проблемы, просто добавьте None .

      Сохраните и закройте файл, чтобы продолжить загрузку на сервер проверки кода WebRTC.

      Команда напечатает ссылку, такую ​​как https://webrtc-review.googlesource.com/c/src/+/53121 . если все будет хорошо.

  • Нажмите эту ссылку CL

  • Если вы не вошли в систему, нажмите кнопку «Вход» в правом верхнем углу и войдите, используя адрес электронной почты.

  • Нажмите Начать рецензию и добавьте рецензента. Вы можете найти рецензентов в файлах OWNERS вокруг репозитория (возьмите тот, который ближе всего к вашим изменениям)

  • Обращайтесь к любому отзыву рецензента:

    • Вносить изменения, строить локально, запускать тесты локально
      • git commit -am "Fixed X and Y"
      • git cl upload
  • После того, как рецензент LGTM (утвердит) патч, попросите его поместить его в очередь фиксации.

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

Trybots

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

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