Berkontribusi pada project WebRTC

Perjanjian Lisensi

WebRTC menyambut patch/tarikan untuk fitur dan perbaikan bug!

Untuk kontributor di luar Google, ikuti petunjuk yang diberikan dalam Perjanjian Lisensi Kontributor Perorangan Google. Apa pun kasusnya, kontributor harus menandatangani perjanjian lisensi kontributor sebelum kontribusi dapat diterima. Harap lengkapi perjanjian untuk perorangan atau korporasi sebagaimana sesuai.

Sampel yang berkontribusi

Jika Anda berencana menambahkan sampel baru atau membuat perubahan signifikan pada sampel yang ada, sebaiknya mulai dengan membuat masalah baru agar kami dapat mendiskusikan detailnya.

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

Petunjuk

Menyumbang Patch Pertama Anda

Anda harus melakukan beberapa persiapan untuk mengupload CL pertama:

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

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

Mengupload Patch Pertama Anda

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, yang memungkinkan Anda mengubahnya sebelum menjadi deskripsi CL.

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

      Simpan dan tutup file untuk melanjutkan proses upload ke server peninjauan kode WebRTC.

      Perintah tersebut 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 lalu login dengan email Anda

  • Klik Mulai Ulasan dan tambahkan pengulas. Anda dapat menemukan pengulas di file OWNERS di sekitar repositori (ambil yang paling dekat dengan perubahan Anda)

  • Tanggapi masukan dari 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 yang di atas di shell Git bash agar gclient dapat menemukan file .gitcookies.

Trybot

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

Untuk menjalankan uji coba, upload CL seperti yang dijelaskan di atas dan klik uji coba CQ atau Pilih Pilih bot di UI Gerrit. Anda harus memiliki hak coba untuk ini. Atau, minta peninjau untuk memulai bot.