Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Berkontribusi pada proyek WebRTC

Perjanjian lisensi

WebRTC menyambut baik tambalan / tarikan 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 selesaikan perjanjian untuk individu atau perusahaan yang sesuai.

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

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

Instruksi

Berkontribusi pada Patch Pertama Anda

Anda harus melakukan beberapa persiapan untuk mengupload CL pertama Anda:

  • Lihat dan buat 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 login dengan akun email Anda. Ini harus akun yang sama seperti yang dikembalikan oleh git config user.email
  • Kemudian, jalankan: git cl creds-check . Jika Anda mendapatkan kesalahan, mintalah bantuan di diskusikan-webrtc

Anda tidak perlu mengulangi hal di atas. Setelah semua itu, Anda siap untuk mengupload:

Mengupload Patch Pertama Anda

Sekarang setelah akun Anda disiapkan, Anda dapat melakukan pengunggahan yang sebenarnya:

  • Melakukan hal ini:

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

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

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

      Isi entri bug dengan benar. Harap 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, tambahkan saja None .

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

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

  • Klik Link CL ini

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

  • Klik Mulai Tinjauan dan tambahkan pengulas. Anda dapat menemukan peninjau di file PEMILIK di sekitar repositori (pilih yang paling dekat dengan perubahan Anda)

  • Tangani umpan balik pengulas:

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

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

Trybots

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

Untuk menjalankan tryjob, unggah CL seperti dijelaskan di atas dan klik CQ dry run atau Pilih Trybots di Gerrit UI. Anda perlu mencoba hak untuk ini. Jika tidak, minta peninjau Anda untuk memulai bot untuk Anda.