WebRTC projesine katkıda bulunma

Lisans Sözleşmesi

WebRTC, özellikler ve hata düzeltmeleri için yamalar/pull'leri memnuniyetle karşılar.

Google dışından katkıda bulunanlar için Google Bireysel Katkıda Bulunan Lisans Sözleşmesi'ndeki talimatları uygulayın. Katkıların kabul edilebilmesi için katkıda bulunanların her durumda bir katkıda bulunan lisans sözleşmesi imzalaması gerekir. Lütfen bireysel veya kuruluş için uygun sözleşmeyi tamamlayın.

Sana Özel'e içerik gönderme

Yeni bir örnek eklemeyi veya mevcut bir örnekte önemli değişiklikler yapmayı planlıyorsanız ayrıntıları tartışabileceğimiz bir yeni sorun oluşturarak başlamanızı öneririz.

Yeni bir örnek oluştururken veya mevcut bir örneği güncellerken lütfen mevcut testleri de oluşturduğunuzdan veya güncellediğinizden emin olun. Söz konusu depodaki tüm testler Nightwatch.JS kullanıcı arayüzü testleri olarak uygulandığından lütfen kendi testlerinizde de aynı tasarımı kullanın.

Talimatlar

İlk Yamanızı Gönderme

İlk CL'nizi yüklemek için bazı hazırlıkları yapmanız gerekir:

  • Kodu inceleyin ve derleyin
  • Katkıda Bulunan Sözleşmesi'ni doldurun (yukarıya bakın)
  • Daha önce hiç kod göndermediyseniz AUTHORS dosyasına adınızı (veya katkıda bulunan sözleşmesi kuruluşunuz tarafından imzalanmışsa kuruluşunuzun adını) ve iletişim bilgilerinizi eklemeniz gerekir.
  • https://webrtc.googlesource.com/new-password adresine gidip e-posta hesabınızla giriş yapın. Bu, git config user.email tarafından döndürülen hesapla aynı olmalıdır.
  • Ardından şu komutu çalıştırın: git cl creds-check. Hata alırsanız discuss-webrtc adresinden yardım isteyebilirsiniz.

Yukarıdakileri tekrarlamanız gerekmez. Bu adımları tamamladıktan sonra yüklemeye hazırsınız:

İlk yamayı yükleme

Hesabınızı oluşturduktan sonra gerçek yüklemeyi yapabilirsiniz:

  • Şunu yapın:

    • Ana dalda olduğunuzu varsayarak:
      • git checkout -b my-work-branch

    • Değişiklik yapma, yerel olarak derleme, yerel olarak test çalıştırma

      • git commit -am "Changed x, and it is working"
      • git cl upload

      Bu işlem, tüm yerel taahhüt mesajlarını gösteren bir metin düzenleyici açar. Böylece, CL açıklaması haline gelmeden önce mesajı değiştirebilirsiniz.

      Hata girişini doğru şekilde doldurun. Lütfen sorun izleyici ön ekini ve sorun numarasını iki nokta işaretiyle ayırarak belirtin (ör. webrtc:123 veya chromium:12345). Sorun izleyici ön ekiniz ve sorun numaranız yoksa None eklemeniz yeterlidir.

      WebRTC kod inceleme sunucusuna yükleme işlemine devam etmek için dosyayı kaydedip kapatın.

      Komut, her şey yolunda giderse https://webrtc-review.googlesource.com/c/src/+/53121 gibi bir bağlantı yazdırır.

  • Bu CL bağlantısını tıklayın

  • Oturum açmadıysanız sağ üstteki Oturum Aç düğmesini tıklayın ve e-posta adresinizle oturum açın.

  • İncelemeyi Başlat'ı tıklayın ve bir incelemeci ekleyin. İnceleme uzmanlarını, depoda bulunan OWNERS dosyalarında bulabilirsiniz (değişikliklerinize en yakın olanı seçin).

  • İnceleme uzmanının geri bildirimlerini yanıtlayın:

    • Değişiklik yapma, yerel olarak derleme, yerel olarak test çalıştırma
      • git commit -am "Fixed X and Y"
      • git cl upload

  • İnceleme uzmanı, yamayı LGTM (onay) olarak işaretledikten sonra, yamayı taahhüt kuyruğuna eklemesini isteyin.

NOT: Windows'ta, gclient'ın .gitcookies dosyasını bulabilmesi için yukarıdaki komutu bir Git bash kabuğunda çalıştırmanız gerekir.

Trybots

WebRTC ile çok çalışıyorsanız deneme hakları için başvurabilirsiniz. Bu sayede, tüm testleri tüm platformlarda çalıştıran trybots çalıştırabilirsiniz. Bunu yapmak için bugs.webrtc.org adresinde bir hata kaydı oluşturun ve EngProd ekibinden size deneme hakları vermesini isteyin.

Deneme işi çalıştırmak için yukarıda açıklandığı şekilde bir CL yükleyin ve CQ kuru çalıştırma'yı veya Gerrit kullanıcı arayüzünde Trybot'ları seç'i tıklayın. Bunun için deneme haklarına sahip olmanız gerekir. Aksi takdirde, inceleme uzmanınızdan botları sizin için başlatmasını isteyin.