Google is committed to advancing racial equity for Black communities. See how.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Berkontribusi pada proyek WebRTC

Perjanjian lisensi

WebRTC menyambut tambalan / tarikan untuk fitur dan perbaikan bug!

Untuk kontributor di luar Google, ikuti instruksi yang diberikan dalam Perjanjian Lisensi Kontributor Google Individual . Dalam semua kasus, kontributor harus menandatangani perjanjian lisensi kontributor sebelum kontribusi dapat diterima. Harap lengkapi perjanjian untuk individu atau perusahaan jika perlu.

Jika Anda berencana untuk menambahkan sampel baru atau membuat perubahan signifikan pada sampel yang ada, kami sarankan Anda mulai dengan membuat masalah baru di mana kami dapat mendiskusikan detailnya.

Saat membuat sampel baru atau memperbarui yang sudah ada, pastikan Anda juga membuat, atau memperbarui tes yang ada. Semua tes dalam repositori ini diimplementasikan sebagai tes Nightwatch.JS UI, jadi silakan ikuti desain yang sama di Anda sendiri.

Instruksi

Berkontribusi Patch Pertama Anda

Anda harus melakukan beberapa persiapan untuk mengunggah CL pertama Anda:

  • Lihat dan bangun kodenya
  • Isi perjanjian Kontributor (lihat di atas)
  • Jika Anda belum pernah mengirimkan kode sebelumnya, Anda harus menambahkan nama Anda (atau organisasi Anda jika perjanjian kontributor ditandatangani oleh organisasi Anda) dan info kontak ke file AUTHORS
  • Buka https://webrtc.googlesource.com/new-password dan masuk dengan akun email Anda. Ini harus menjadi akun yang sama dengan yang dikembalikan oleh git config user.email
  • Kemudian, jalankan: git cl creds-check . Jika Anda mendapatkan kesalahan, mintalah bantuan untuk mendiskusikan-webrtc

Anda tidak harus mengulangi hal di atas. Setelah semua itu, Anda siap mengunggah:

Mengunggah Patch Pertama Anda

Sekarang setelah Anda mengatur akun, Anda dapat melakukan unggahan yang sebenarnya:

  • Melakukan hal ini:

    • Dengan asumsi Anda berada di cabang utama:
      • git checkout -b my-work-branch
    • Buat perubahan, buat secara lokal, jalankan tes secara lokal

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

      Ini akan membuka editor teks yang menunjukkan semua pesan komit lokal, memungkinkan Anda untuk memodifikasinya sebelum menjadi deskripsi CL.

      Isi entri bug dengan benar. Silakan tentukan awalan pelacak masalah dan nomor masalah, dipisahkan dengan titik dua, misalnya webrtc:123 atau chromium:12345 . Jika Anda tidak memiliki awalan pelacak masalah dan nomor masalah cukup tambahkan None .

      Simpan dan tutup file untuk melanjutkan pengunggahan ke server peninjau kode WebRTC.

      Perintah akan mencetak tautan seperti https://webrtc-review.googlesource.com/c/src/+/53121 . jika semuanya berjalan dengan baik.

  • Klik Tautan CL ini

  • Jika Anda tidak masuk, klik tombol Masuk di kanan atas dan masuk dengan email Anda

  • Klik Mulai Ulasan dan tambahkan resensi. Anda dapat menemukan pengulas dalam file PEMILIK di sekitar repositori (ambil yang terdekat dengan perubahan Anda)

  • Alamat setiap tanggapan resensi:

    • Buat perubahan, buat secara lokal, jalankan tes secara lokal
      • git commit -am "Fixed X and Y"
      • git cl upload
  • Setelah reviewer LGTM (menyetujui) tambalan, minta mereka untuk memasukkannya ke dalam antrian komit

PEMBERITAHUAN: Di Windows, Anda harus menjalankan yang di atas dalam shell bash Git agar gclient menemukan file .gitcookies .

Trybots

Jika Anda banyak bekerja di WebRTC, Anda dapat mengajukan hak mencoba . Ini berarti Anda dapat menjalankan trybots , yang menjalankan semua tes pada semua platform. Untuk melakukan ini, ajukan bug pada bugs.webrtc.org dan minta tim EngProd untuk memberi Anda hak mencoba.

Untuk menjalankan tryjob, unggah CL seperti dijelaskan di atas dan klik CQ dry run atau Choose Trybots di Gerrit UI. Anda harus memiliki hak coba untuk ini. Jika tidak, minta resensi Anda untuk memulai bot untuk Anda.