Berkontribusi pada project WebRTC

Perjanjian Lisensi

WebRTC menerima patch/pull untuk fitur dan perbaikan bug.

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

Berkontribusi pada sampel

Jika Anda berencana menambahkan sampel baru atau membuat perubahan signifikan pada sampel yang ada, sebaiknya mulailah dengan membuat masalah baru tempat kami dapat membahas detailnya.

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

Petunjuk

Berkontribusi dengan Patch Pertama

Anda harus melakukan beberapa persiapan untuk mengupload CL pertama:

  • Melihat dan mem-build kode
  • Isi perjanjian Kontributor (lihat di atas)
  • Jika belum pernah mengirimkan kode, Anda harus menambahkan nama dan info kontak Anda (atau organisasi Anda jika perjanjian kontributor ditandatangani oleh organisasi Anda) ke file AUTHORS
  • Buka https://webrtc.googlesource.com/new-password dan login dengan akun email Anda. Akun ini harus sama dengan akun yang ditampilkan oleh git config user.email
  • Kemudian, jalankan: git cl creds-check. Jika Anda mendapatkan error, minta bantuan di discuss-webrtc

Anda tidak perlu mengulangi langkah-langkah di atas. Setelah semua itu, Anda siap mengupload:

Mengupload Patch Pertama

Setelah menyiapkan akun, Anda dapat melakukan upload yang sebenarnya:

  • Lakukan ini:

    • Dengan asumsi Anda berada di cabang utama:
      • git checkout -b my-work-branch

    • Membuat perubahan, mem-build secara lokal, menjalankan pengujian secara lokal

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

      Tindakan ini akan membuka editor teks yang menampilkan semua pesan commit lokal, sehingga Anda dapat mengubahnya sebelum menjadi deskripsi CL.

      Isi entri bug dengan benar. Harap tentukan awalan pelacak masalah dan nomor masalah, yang 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 upload ke server peninjauan kode WebRTC.

      Perintah ini akan mencetak link seperti https://webrtc-review.googlesource.com/c/src/+/53121. jika semuanya berjalan lancar.

  • Klik Link CL ini

  • Jika Anda belum login, klik tombol Login di kanan atas dan login dengan email Anda

  • Klik Mulai Peninjauan dan tambahkan peninjau. Anda dapat menemukan peninjau di file OWNERS di seluruh repositori (pilih yang paling dekat dengan perubahan Anda)

  • Atasi masukan peninjau:

    • Membuat perubahan, mem-build secara lokal, menjalankan pengujian secara lokal
      • git commit -am "Fixed X and Y"
      • git cl upload

  • Setelah peninjau LGTM (menyetujui) patch, minta mereka untuk memasukkannya ke dalam antrean commit

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

Trybots

Jika sering menggunakan WebRTC, Anda dapat mengajukan permohonan hak coba. Artinya, Anda dapat menjalankan trybots, yang menjalankan semua pengujian di semua platform. Untuk melakukannya, laporkan bug di bugs.webrtc.org dan minta tim EngProd untuk memberi Anda hak coba.

Untuk menjalankan tryjob, upload CL seperti yang dijelaskan di atas dan klik dry run CQ atau Pilih Trybot di UI Gerrit. Anda harus memiliki hak coba untuk melakukannya. Jika tidak, minta peninjau untuk memulai bot untuk Anda.