Editor sumber Git

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Ringkasan

Editor sumber Git (ci.android.com/edit) adalah alat berbasis browser untuk mengedit file di Project Open Source Android (AOSP) dan mengupload perubahan ke Gerrit. Alat ini ditujukan untuk membuat perubahan kecil pada sejumlah kecil file, dan memberikan alur kerja yang lebih cepat daripada mendownload hierarki 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 akan dilakukan di komputer lokal, hingga Anda mengupload perubahan untuk membuat daftar perubahan Gerrit.

Login

1. Muat Git Source Editor di browser.

2. Klik Login untuk login ke akun Anda.

   

   Gambar 1. Tombol Login

Mengedit file dan perubahan

Editor Sumber Git memiliki alur kerja utama berikut:

• Edit satu atau beberapa file pilihan Anda, di cabang yang Anda pilih.
• Mengedit perubahan. Saat Anda mengedit perubahan, hasilnya bergantung pada siapa yang membuat perubahan:
  • Jika Anda membuat perubahan, pengeditan Editor Sumber Git akan di-patch ke dalam perubahan sebagai set patch baru.
  • Jika orang lain membuat perubahan, pengeditan Editor Sumber Git Anda akan membuat perubahan baru yang Anda miliki, berdasarkan perubahan yang Anda muat.

Memuat yang ingin Anda edit

Mulai sesi pengeditan dengan memuat file atau perubahan.

Memuat file

1. Masukkan URL file yang ingin Anda edit di kotak file/change path 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 akan dimuat di panel editor. Panel navigasi di sebelah kiri panel editor adalah file browser, yang membuka repo, dengan file Anda dimuat sebelumnya.

   

   Gambar 3. File yang dimuat ke panel pengeditan

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

Gambar 4. Tab untuk file yang dimuat

Memuat perubahan

Buka perubahan yang ingin diedit dengan memasukkan URL daftar perubahan Gerrit ke dalam kotak file/change path di bagian atas halaman (lihat Gambar 2).

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

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

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

Melakukan pengeditan

Edit file menggunakan panel pengeditan teks. File yang Anda edit akan muncul dalam daftar Perubahan tertunda di bawah panel pengeditan. Jika tidak sengaja menutup tab file yang berisi hasil edit, Anda dapat membuka kembali file dengan hasil edit yang utuh dengan mengklik namanya dalam daftar Perubahan tertunda.

Kirim Perubahan

Anda membuat dan memublikasikan perubahan ke Gerrit di Editor Sumber Git. Kemudian, Anda akan melacak persetujuan perubahan di Gerrit.

Membuat dan memublikasikan perubahan

Ikuti prosedur ini untuk membuat dan memublikasikan perubahan yang telah Anda buat.

1. Klik tombol yang sesuai:

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

   Kotak dialog akan terbuka.

   

   Gambar 5. Kotak dialog Create Change

2. Masukkan deskripsi perubahan, yang akan menjadi deskripsi perubahan di Gerrit. Deskripsi ini wajib diisi. Jika mengedit perubahan yang ada, Anda dapat mengedit deskripsinya jika mau.

3. Secara opsional, hapus centang atau centang kotak Publikasikan saat membuat.

   Kotak ini dipilih secara default.

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

4. Klik Create.

   Perubahan diupload ke Gerrit. Jika Anda memilih kotak centang Publikasikan saat membuat, perubahan juga akan dipublikasikan di Gerrit. Perubahan ini ditautkan dalam notifikasi di bagian atas layar.

   

   Gambar 6. Notifikasi perubahan dibuat

Melacak 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

Melihat perbedaan file

Centang kotak Diff di bawah panel pengeditan untuk melihat perbedaan hasil pengeditan yang telah Anda buat pada file yang aktif di panel pengeditan. Hal ini berguna saat mengubah file dan saat mengedit perubahan yang ada.

Gambar 8. Melihat perbedaan file

Mengembalikan file

Anda dapat mengembalikan perubahan dari satu file atau dari semua file dalam daftar perubahan yang tertunda. Kedua opsi pembatalan hanya akan mengembalikan perubahan di Editor Sumber Git. Perubahan tersebut TIDAK akan memperbarui perubahan di Gerrit.

Mengembalikan satu file

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

Gambar 9. Bagian perubahan yang tertunda

Kembalikan semua file

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

Gambar 10. Tombol Kembalikan semua file

Kotak dialog pop-up akan terbuka. Klik Kembalikan semua untuk mengembalikan perubahan di semua file yang tertunda, atau klik Batal untuk mempertahankan perubahan dan melanjutkan pengeditan.

Gambar 11. Kotak dialog konfirmasi Kembalikan semua file

Mengedit halaman langsung dari penelusuran kode Android

Anda dapat membuka file di Git Source Editor langsung dari penelusuran kode Android. Hal ini berguna jika Anda perlu menemukan file sebelum mengeditnya.

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

1. Di Android Code Search (cs.android.com), buka file yang ingin Anda edit.

2. Klik Edit kode.

   

   Gambar 12. Tombol Edit code Android Code Search

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

3. Pilih cabang Git tempat Anda ingin mengedit file dari menu dropdown Select a git branch, lalu klik Pick branch.

   

   Gambar 13. Memilih cabang Git yang akan diedit

   File akan terbuka di panel pengeditan.

4. Lanjutkan mengedit seperti yang dijelaskan di bagian Melakukan Pengeditan.

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

Menyelesaikan konflik

Untuk menyelesaikan konflik:

1. Di Editor Sumber, buka perubahan. Setelah perubahan dimuat, file yang bertentangan akan tercantum di bagian bawah layar. Misalnya, Gambar 14 menunjukkan bahwa fileAndroid.pb memiliki konflik.

   

   Gambar 14. Konflik editor sumber

2. Klik file yang bertentangan. 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 pertahankan. Selain itu, hapus konten dan penanda konflik untuk konten yang tidak ingin Anda simpan.

4. Klik Buat Perubahan untuk membuat perubahan baru. Dialog Create Change akan muncul.

   

   Gambar 16. Membuat perubahan

5. Ketik deskripsi perubahan, lalu klik Buat.

Kirim masukan

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

Dokumentasi terkait

• Penelusuran kode Android