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
- Muat Git Source Editor di browser.
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
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
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.
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
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.
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.
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.
Di Pencarian Kode Android (cs.android.com), navigasikan ke file yang ingin Anda edit.
Klik Edit kode .
Gambar 12. Pencarian Kode Android Tombol Edit kode
Git Source Editor terbuka dengan file yang telah dipilih sebelumnya untuk diedit.
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.
Lanjutkan pengeditan seperti dijelaskan di bagian Melakukan Pengeditan .
Anda dapat membuka file tambahan untuk diedit seperti dijelaskan di bagian Memuat file
Selesaikan konflik
Untuk menyelesaikan konflik:
Di Editor Sumber, navigasikan ke perubahan. Setelah perubahan dimuat, file konflik akan dicantumkan di bagian bawah layar. Misalnya Gambar 14 menunjukkan bahwa file
Android.pbmengalami konflik.
Gambar 14. Konflik editor sumber
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
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.
Klik Buat Perubahan untuk membuat perubahan baru. Dialog Buat Perubahan muncul.
Gambar 16. Membuat perubahan
Ketik deskripsi perubahan dan klik Buat .
Kirim masukan
Gunakan tombol bug
di pojok kanan atas untuk memberikan masukan tentang Git Source Editor.