Git kaynak düzenleyicisi

Genel Bakış

Git kaynak düzenleyicisi (ci.android.com/edit), Android Açık Kaynak Projesi'ndeki (AOSP) dosyaları düzenlemek ve değişiklikleri Gerrit'e yüklemek için kullanılan tarayıcı tabanlı bir araçtır. Az sayıda dosyada küçük değişiklikler yapmak için tasarlanmıştır ve Android kaynak ağacını indirmekten daha hızlı bir iş akışı sağlar. Git kaynak düzenleyicisini kullanmadan önce Git, Repo ve Gerrit kullanarak AOSP'ye değişiklik gönderme sürecinin tamamına aşina olmalısınız.

Git kaynak düzenleyicisini kullanarak bir dosyayı düzenlediğinizde, siz Gerrit değişiklik listesi oluşturmak için değişiklikleri yükleyene kadar tüm iş yerel makinenizde gerçekleşir.

Giriş yapmak

1. Git Source Editor'ı bir tarayıcıya yükleyin.

2. Hesabınıza giriş yapmak için Oturum aç'ı tıklayın.

   

   Şekil 1. Giriş butonu

Dosyaları ve değişiklikleri düzenleme

Git Source Editor'da şu ana iş akışları bulunur:

• Seçtiğiniz dalda, seçtiğiniz bir veya daha fazla dosyayı düzenleyin.
• Bir değişikliği düzenleyin. Bir değişikliği düzenlediğinizde sonuç, değişikliği kimin oluşturduğuna bağlıdır:
  • Değişikliği siz oluşturduysanız Git Kaynak Düzenleyicisi düzenlemeleriniz yeni bir yama seti olarak değişikliğe eklenir.
  • Değişikliği başka biri oluşturduysa Git Kaynak Düzenleyici düzenlemeleriniz, yüklediğiniz değişikliğe bağlı olarak sahip olduğunuz yeni bir değişiklik oluşturur.

Düzenlemek istediklerinizi yükleyin

Bir dosyayı veya değişikliği yükleyerek bir düzenleme oturumu başlatın.

Dosyaları yükle

1. Düzenlemek istediğiniz dosyanın URL'sini sayfanın üst kısmındaki dosya/yolu değiştir kutusuna girin.

   Örnek dosya yolu: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md

2. Dosya yükle veya değiştir'i tıklayın.

   

   Şekil 2. Dosya veya değişiklik yükleme

   Dosya düzenleyici bölmesine yüklenir. Düzenleyici bölmesinin solundaki gezinme bölmesi, dosyanız önceden yüklenmiş olarak depoyu açan bir dosya tarayıcısıdır.

   

   Şekil 3. Düzenleme bölmesine yüklenen bir dosya

Aynı depoda daha fazla dosya açmak için gezinme bölmesini kullanabilirsiniz. Birden fazla dosya açarsanız her dosya, düzenleme bölmesinin üzerindeki satırda bir sekme olarak görünür. İlgili dosyayı düzenleme bölmesinde açmak için bir sekmeyi tıklayın.

Şekil 4. Yüklenen dosyalar için sekmeler

Değişiklik yükle

Sayfanın üst kısmındaki dosya/yolu değiştir kutusuna Gerrit değişiklik listesinin URL'sini girerek düzenlemek istediğiniz değişikliğe gidin (bkz. Şekil 2).

Örnek değişiklik bağlantısı: https://android-review.googlesource.com/c/platform/build/soong/+/1284176

Değişiklikteki dosyalar düzenleme bölmesinde açılır (bkz. Şekil 3).

Değişiklik birden fazla dosya içeriyorsa her dosya, düzenleme bölmesinin üzerindeki satırda bir sekme olarak görünür (bkz. Şekil 4). İlgili dosyayı düzenleme bölmesinde açmak için bir sekmeye tıklayın.

Düzenlemelerinizi yapın

Metin düzenleme bölmesini kullanarak dosyaları düzenleyin. Düzenlediğiniz dosyalar, düzenleme bölmesinin altındaki Bekleyen değişiklikler listesinde görünür. Düzenlemeler içeren bir dosyanın sekmesini yanlışlıkla kapatırsanız, Bekleyen değişiklikler listesinde dosyanın adına tıklayarak dosyayı düzenlemeler bozulmadan yeniden açabilirsiniz.

Değişiklikleri gönder

Değişikliğinizi Git Kaynak Düzenleyicisi'nde oluşturup Gerrit'te yayınlayabilirsiniz. Daha sonra değişikliğin onayını Gerrit'te takip edersiniz.

Değişiklikleri oluşturun ve yayınlayın

Yaptığınız değişiklikleri oluşturmak ve yayınlamak için bu prosedürü izleyin.

1. Uygun düğmeye tıklayın:

   • Yeni bir değişiklik oluşturuyorsanız Değişiklik oluştur'a tıklayın.
   • Mevcut bir değişikliği güncelliyorsanız Değişikliği güncelle'ye tıklayın.

   Bir iletişim kutusu açılır.

   

   Şekil 5. Değişiklik Oluştur iletişim kutusu

2. Gerrit'te değişiklik açıklaması olacak bir değişiklik açıklaması girin. Bu açıklama gereklidir. Mevcut bir değişikliği düzenliyorsanız, isterseniz açıklamasını da düzenleyebilirsiniz.

3. İsteğe bağlı olarak, Oluşturma sırasında yayımla onay kutusunun işaretini kaldırın veya seçin.

   Bu kutu varsayılan olarak seçilidir.

   Değişikliği oluştururken bu kutu seçilirse değişiklik anında Gerrit'e yayınlanır. Kutu seçili değilse değişiklik Gerrit'e yüklenir ancak yayınlanmaz.

4. Oluştur'u tıklayın.

   Değişiklik Gerrit'e yüklenir. Oluşturma sırasında yayınla onay kutusunu seçtiyseniz değişiklik Gerrit'te de yayımlanır. Değişiklik, ekranın üst kısmındaki bir bildirimle bağlantılıdır.

   

   Şekil 6. Oluşturulan bildirimi değiştirme

Gerrit'te değişiklik onayını izleme

Diğer değişikliklerde olduğu gibi değişiklik gönderim durumunu doğrudan Gerrit'te izleyin.

Şekil 7. Gerrit'te değişiklik gönderim durumunun izlenmesi

Dosya farklarını görüntüle

Düzenleme bölmesinde etkin olan dosyada yaptığınız düzenlemelerin farklarını görüntülemek için düzenleme bölmesinin altındaki Fark onay kutusunu seçin. Bu, bir dosyayı değiştirirken ve mevcut bir değişikliği düzenlerken kullanışlıdır.

Şekil 8. Dosya farklarını görüntüleme

Dosyaları geri döndür

Değişiklikleri tek bir dosyadan veya bekleyen değişiklik listesindeki tüm dosyalardan geri alabilirsiniz. Her iki geri alma seçeneği de değişiklikleri yalnızca Git Kaynak Düzenleyicisi'nde geri alır. Gerrit'teki değişikliği GÜNCELLEMEYECEKLER.

Tek bir dosyayı geri alma

Tek bir dosyayı geri döndürmek için Bekleyen değişiklikler listesinde dosya adının yanındaki X işaretini tıklayın.

Şekil 9. Bekleyen değişiklikler bölümü

Tüm dosyaları geri al

Tüm dosyaları bir kerede geri döndürmek için düzenleme bölmesinin altındaki Tüm dosyaları geri döndür'e tıklayın.

Şekil 10. Tüm dosyaları geri al düğmesi

Bir açılır iletişim kutusu açılır. Bekleyen tüm dosyalardaki değişiklikleri geri almak için Tümünü geri al'ı tıklayın veya değişiklikleri korumak ve düzenlemeye devam etmek için İptal'i tıklayın.

Şekil 11. Tüm dosyaları geri alma onayı iletişim kutusu

Bir sayfayı doğrudan Android kod aramasından düzenleyin

Git Source Editor'da bir dosyayı doğrudan Android kod aramasından açabilirsiniz. Düzenlemeden önce dosyayı bulmanız gerekiyorsa bu yararlı olur.

Bir dosyayı doğrudan Android kod aramasından düzenlemek için bu prosedürü izleyin.

1. Android Kod Arama'da (cs.android.com), düzenlemek istediğiniz dosyaya gidin.

2. Kodu düzenle'yi tıklayın.

   

   Şekil 12. Android Kod Arama Kodu düzenle düğmesi

   Git Source Editor, düzenleme için önceden seçilmiş dosyayla açılır.

3. Git şubesi seçin açılır listesinden dosyayı düzenlemek istediğiniz Git şubesini seçin ve ardından Şube seç öğesine tıklayın.

   

   Şekil 13. Düzenlemek için bir Git şubesi seçme

   Dosya düzenleme bölmesinde açılır.

4. Düzenlemelerinizi Yapma bölümünde anlatıldığı gibi düzenlemeye devam edin.

5. Dosyaları yükleme bölümünde açıklandığı gibi düzenlemek üzere ek dosyalar açabilirsiniz.

Çatışmaları çözme

Çatışmaları çözmek için:

1. Kaynak Düzenleyici'de değişikliğe gidin. Değişiklik yüklendikten sonra çakışan dosyalar ekranın alt kısmında listelenir. Örneğin Şekil 14, Android.pb dosyasında çakışma olduğunu göstermektedir.

   

   Şekil 14. Kaynak düzenleyici çakışması

2. Çakışan bir dosyayı tıklayın. Dosya, çakışan içerik bloklarını art arda ve Git işaretçileri ( <<<<<<< ve >>>>>>> ) içinde yükler ve gösterir.

   

   Şekil 15. Kaynak düzenleyici çakışma işaretleri

3. Dosyayı düzenleyerek ve saklamak istediğiniz içeriğin etrafındaki çakışma işaretlerini manuel olarak kaldırarak çakışmayı düzeltin. Ayrıca saklamak istemediğiniz içeriklerin içeriklerini ve çakışma işaretlerini de kaldırın.

4. Yeni bir değişiklik oluşturmak için Değişiklik Oluştur'a tıklayın. Değişiklik Oluştur iletişim kutusu görüntülenir.

   

   Şekil 16. Değişiklik oluştur

5. Bir değişiklik açıklaması yazın ve Oluştur'u tıklayın.

Geribildirim yolla

Hata butonunu kullanın Git Kaynak Düzenleyicisi hakkında geri bildirim sağlamak için sağ üst köşedeki.

İlgili belgeler

• Android kod arama