Editor sumber Git

Ringkasan

Editor sumber Git (ci.android.com/edit) adalah alat berbasis browser untuk mengedit file di Proyek Sumber Terbuka Android (AOSP) dan mengunggah perubahan ke Gerrit. Ini dimaksudkan untuk membuat perubahan kecil pada sejumlah kecil file, dan memberikan alur kerja yang lebih cepat dibandingkan mengunduh pohon sumber Android . Anda harus memahami proses lengkap pengiriman perubahan ke AOSP menggunakan Git, Repo, dan Gerrit sebelum menggunakan editor sumber Git.

Saat Anda mengedit file menggunakan editor sumber Git, semua pekerjaan terjadi di mesin lokal Anda, hingga Anda mengunggah perubahan untuk membuat daftar perubahan Gerrit.

Gabung

1. Muat Git Source Editor di browser.

2. Klik Masuk untuk masuk ke akun Anda.

   

   Gambar 1. Tombol login

Edit file dan perubahan

Git Source Editor memiliki alur kerja utama berikut:

• Edit satu atau lebih file pilihan Anda, di cabang yang Anda pilih.
• Edit perubahan. Saat Anda mengedit perubahan, hasilnya bergantung pada siapa yang membuat perubahan:
  • Jika Anda membuat perubahan, hasil edit Git Source Editor Anda akan ditambal ke dalam perubahan sebagai set tambalan baru.
  • Jika orang lain yang membuat perubahan, hasil edit Git Source Editor Anda akan membuat perubahan baru milik Anda, berdasarkan perubahan yang Anda muat.

Muat apa yang ingin Anda edit

Mulai sesi pengeditan dengan memuat file atau perubahan.

Muat file

1. Masukkan URL file yang ingin Anda edit di kotak file/ubah jalur di bagian atas halaman.

   Contoh jalur file: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md

2. Klik Muat file atau ubah .

   

   Gambar 2. Memuat file atau perubahan

   File dimuat di panel editor. Panel navigasi di sebelah kiri panel editor adalah browser file, yang membuka repo, dengan file Anda dimuat sebelumnya.

   

   Gambar 3. File dimuat ke panel pengeditan

Anda dapat menggunakan panel navigasi untuk membuka lebih banyak file dalam repo yang sama. Jika Anda membuka banyak file, setiap file muncul sebagai tab pada baris di atas panel pengeditan. Klik tab untuk membuka file tersebut di panel pengeditan.

Gambar 4. Tab untuk file yang dimuat

Muat perubahan

Navigasikan ke perubahan yang ingin Anda edit dengan memasukkan URL daftar perubahan Gerrit ke dalam kotak file/jalur perubahan di bagian atas halaman (lihat Gambar 2).

Tautan perubahan contoh: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

File dalam perubahan terbuka di panel pengeditan (lihat Gambar 3).

Jika perubahan mencakup beberapa file, setiap file akan muncul sebagai tab pada baris di atas panel pengeditan (lihat Gambar 4). Klik tab untuk membuka file tersebut di panel pengeditan.

Lakukan pengeditan

Edit file menggunakan panel pengeditan teks. File yang Anda edit muncul di daftar Perubahan tertunda di bawah panel pengeditan. Jika Anda secara tidak sengaja menutup tab file yang sedang diedit, Anda dapat membuka kembali file yang masih utuh dengan mengklik namanya di daftar Perubahan tertunda.

Kirim perubahan

Anda membuat dan mempublikasikan perubahan Anda ke Gerrit di Git Source Editor. Kemudian Anda melacak persetujuan perubahan di Gerrit.

Buat dan publikasikan perubahannya

Ikuti prosedur ini untuk membuat dan mempublikasikan perubahan yang Anda buat.

1. Klik tombol yang sesuai:

   • Klik Buat perubahan jika Anda membuat perubahan baru.
   • Klik Perbarui perubahan jika Anda memperbarui perubahan yang ada.

   Sebuah kotak dialog terbuka.

   

   Gambar 5. Kotak dialog Buat Perubahan

2. Masukkan deskripsi perubahan, yang akan menjadi deskripsi perubahan di Gerrit. Deskripsi ini diperlukan. Jika Anda mengedit perubahan yang sudah ada, Anda dapat mengedit deskripsinya jika diinginkan.

3. Secara opsional, kosongkan atau pilih kotak centang Publikasikan saat dibuat .

   Kotak ini dipilih secara default.

   Jika kotak ini dipilih saat Anda membuat perubahan, perubahan tersebut segera dipublikasikan ke Gerrit. Jika kotak tidak dipilih, perubahan diunggah ke Gerrit tetapi tidak dipublikasikan.

4. Klik Buat .

   Perubahan diunggah ke Gerrit. Jika Anda memilih kotak centang Publikasikan saat dibuat , perubahan juga dipublikasikan di Gerrit. Perubahan tersebut ditautkan dalam pemberitahuan di bagian atas layar.

   

   Gambar 6. Ubah notifikasi yang dibuat

Lacak persetujuan perubahan di Gerrit

Lacak status pengiriman perubahan secara langsung di Gerrit, seperti yang Anda lakukan pada perubahan lainnya.

Gambar 7. Melacak status pengiriman perubahan di Gerrit

Lihat perbedaan file

Pilih kotak centang Diff di bawah panel pengeditan untuk melihat perbedaan pengeditan yang Anda buat pada file yang aktif di panel pengeditan. Ini berguna saat mengubah file dan saat mengedit perubahan yang sudah ada.

Gambar 8. Melihat perbedaan file

Kembalikan file

Anda dapat mengembalikan perubahan dari satu file atau dari semua file dalam daftar perubahan yang tertunda. Kedua opsi pengembalian hanya mengembalikan perubahan di Git Source Editor. Mereka TIDAK akan memperbarui perubahan di Gerrit.

Kembalikan satu file

Untuk mengembalikan satu file, klik X di samping nama file dalam daftar Perubahan tertunda.

Gambar 9. Bagian perubahan yang menunggu keputusan

Kembalikan semua file

Untuk mengembalikan semua file sekaligus, klik Kembalikan semua file di bawah panel pengeditan.

Gambar 10. Tombol kembalikan semua file

Kotak dialog popup terbuka. Klik Kembalikan semua untuk mengembalikan perubahan pada semua file yang tertunda, atau klik Batal untuk menyimpan perubahan dan melanjutkan pengeditan.

Gambar 11. Kotak dialog konfirmasi pengembalian semua file

Edit halaman langsung dari pencarian kode Android

Anda dapat membuka file di Git Source Editor langsung dari pencarian kode Android . Ini berguna jika Anda perlu mencari file sebelum mengeditnya.

Ikuti prosedur ini untuk mengedit file langsung dari pencarian kode Android.

1. Di Pencarian Kode Android (cs.android.com), navigasikan ke file yang ingin Anda edit.

2. Klik Edit kode .

   

   Gambar 12. Pencarian Kode Android Tombol Edit kode

   Git Source Editor terbuka dengan file yang telah dipilih sebelumnya untuk diedit.

3. Pilih cabang Git tempat Anda ingin mengedit file dari daftar tarik-turun Pilih cabang git , lalu klik Pilih cabang .

   

   Gambar 13. Memilih cabang Git untuk diedit

   File terbuka di panel pengeditan.

4. Lanjutkan pengeditan seperti dijelaskan di bagian Melakukan Pengeditan .

5. Anda dapat membuka file tambahan untuk diedit seperti dijelaskan di bagian Memuat file

Selesaikan konflik

Untuk menyelesaikan konflik:

1. Di Editor Sumber, navigasikan ke perubahan. Setelah perubahan dimuat, file konflik akan dicantumkan di bagian bawah layar. Misalnya Gambar 14 menunjukkan bahwa file Android.pb mengalami konflik.

   

   Gambar 14. Konflik editor sumber

2. Klik file yang konflik. File memuat dan menampilkan blok konten yang bertentangan secara berurutan dan dalam penanda Git ( <<<<<<< dan >>>>>>> ).

   

   Gambar 15. Penanda konflik editor sumber

3. Perbaiki konflik dengan mengedit file dan menghapus penanda konflik secara manual di sekitar konten yang ingin Anda simpan. Hapus juga konten dan penanda konflik untuk konten yang tidak ingin Anda simpan.

4. Klik Buat Perubahan untuk membuat perubahan baru. Dialog Buat Perubahan muncul.

   

   Gambar 16. Membuat perubahan

5. Ketik deskripsi perubahan dan klik Buat .

Kirim masukan

Gunakan tombol bug di pojok kanan atas untuk memberikan masukan tentang Git Source Editor.

Dokumentasi terkait

• Pencarian kode Android