Editor Sumber Git

Ringkasan

Git Source Editor (ci.android.com/edit) adalah alat berbasis browser untuk mengedit file di Android Open Source Project (AOSP) dan mengunggah perubahan ke Gerrit. Ini dimaksudkan untuk membuat perubahan kecil pada sejumlah kecil file, dan memberikan alur kerja yang lebih cepat daripada mengunduh pohon sumber Android . Anda harus terbiasa dengan proses lengkap mengirimkan perubahan ke AOSP menggunakan Git, Repo, dan Gerrit sebelum menggunakan Editor Sumber Git.

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

Masuk

  1. Muat Editor Sumber Git di browser.

  2. Klik Masuk untuk masuk ke akun Anda.

    tombol masuk

    Gambar 1. Tombol masuk

Mengedit file dan perubahan

Git Source Editor memiliki alur kerja utama ini:

  • Edit satu atau lebih 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, editan Git Source Editor Anda akan ditambal ke dalam perubahan sebagai tambalan baru.
    • Jika orang lain membuat perubahan, editan Editor Sumber Git Anda membuat perubahan baru yang Anda miliki, berdasarkan perubahan yang Anda muat.

Memuat apa 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/ubah jalur di bagian atas halaman.

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

  2. Klik Muat file atau ubah .

    Memuat file atau mengubah

    Gambar 2. Memuat file atau mengubah

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

    File dimuat ke panel pengeditan Gambar 3. File 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 muncul sebagai tab di baris di atas panel pengeditan. Klik tab untuk membuka file itu di panel pengeditan.

Tab untuk file yang dimuat

Gambar 4. Tab untuk file yang dimuat

Memuat perubahan

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

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

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

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

Membuat suntingan Anda

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

Mengirimkan perubahan

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

Membuat dan memublikasikan perubahan

Ikuti prosedur ini untuk membuat dan memublikasikan 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.

    Buat kotak dialog Ubah

    Gambar 5. Buat kotak dialog Ubah

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

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

    Kotak ini dipilih secara default.

    Jika kotak ini dipilih saat Anda membuat perubahan, perubahan akan 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 Terbitkan saat buat , perubahan juga dipublikasikan di Gerrit. Perubahan ditautkan dalam pemberitahuan di bagian atas layar.

    Ubah notifikasi yang dibuat

    Gambar 6. Ubah notifikasi yang dibuat

Melacak persetujuan perubahan di Gerrit

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

Melacak perubahan status pengiriman di Gerrit

Gambar 7. Melacak perubahan status pengajuan di Gerrit

Melihat 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 ada.

Melihat perbedaan file

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 pengembalian mengembalikan perubahan hanya di Git Source Editor. Mereka TIDAK akan memperbarui perubahan di Gerrit.

Kembalikan satu file

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

Bagian 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.

Kembalikan semua file tombol

Gambar 10. Tombol Kembalikan semua file

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

Kembalikan semua kotak dialog konfirmasi file

Gambar 11. Kembalikan semua kotak dialog konfirmasi file

Mengedit halaman langsung dari Pencarian Kode Android

Anda dapat membuka file di Git Source Editor langsung dari Android Code Search . 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 .

    Pencarian Kode Android Tombol edit kode

    Gambar 12. Pencarian Kode Android Tombol Edit kode

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

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

    Memilih cabang Git untuk diedit

    Gambar 13. Memilih cabang Git untuk diedit

    File terbuka di panel pengeditan.

  4. Lanjutkan pengeditan seperti yang dijelaskan di bagian Membuat Pengeditan Anda .

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

Menyelesaikan konflik

Untuk menyelesaikan konflik:

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

    Konflik Sumber Editor

    Gambar 14. Konflik editor sumber

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

    Penanda Konflik

    Gambar 15. Penanda konflik editor sumber

  3. Perbaiki konflik dengan mengedit file dan secara manual menghapus penanda konflik di sekitar konten yang ingin Anda simpan. Selain itu, hapus konten dan penanda konflik untuk konten yang tidak ingin Anda simpan.

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

    Buat perubahan

    Gambar 16. Buat perubahan

  5. Ketik deskripsi perubahan dan klik Buat .

Mengirim umpan balik

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