Bu sayfa, Cloud Translation API ile çevrilmiştir.

Git kaynak düzenleyicisi

Genel Bakış

Git kaynak düzenleyici (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üzenleyiciyi kullanmadan önce Git, Repo ve Gerrit'i kullanarak AOSP'ye değişiklik gönderme sürecinin tamamına hakim olmanız gerekir.

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

Giriş yapın

Tarayıcıda Git Kaynak Düzenleyici'yi yükleyin.
Hesabınıza giriş yapmak için Giriş yap'ı tıklayın.

Not: Düzenlemek istediğiniz dallar için Gerrit ayrıcalıklarına sahip hesapla giriş yaptığınızdan emin olun.

Şekil 1. Giriş düğmesi

Dosyaları ve değişiklikleri düzenleme

Git Kaynak Düzenleyici'nin ana iş akışları şunlardır:

Seçtiğiniz dalda, istediğiniz bir veya daha fazla dosyayı düzenleyebilirsiniz.
Değişikliği düzenleme 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üzenleyici düzenlemeleriniz, yeni bir yama grubu olarak değişiklikle birlikte yamaya eklenir.
- Değişikliği başka biri oluşturduysa Git kaynak düzenleyiciniz, yüklediğiniz değişikliğe göre size ait yeni bir değişiklik oluşturur.

Düzenlemek istediğiniz öğeyi yükleme

Bir dosya veya değişiklik yükleyerek düzenleme oturumu başlatın.

Dosya yükleme

Sayfanın üst kısmındaki dosya/değişiklik yolu kutusuna düzenlemek istediğiniz dosyanın URL'sini girin.

Örnek dosya yolu: https://android.googlesource.com/platform/build/+show/refs/heads/main/Changes.md
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ın önceden yüklenmiş olduğu repoyu 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. Bir sekmeyi tıklayarak ilgili dosyayı düzenleme bölmesinde açın.

Yüklenen dosyalar için sekmeler

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

Değişiklik yükleme

Sayfanın üst kısmındaki dosya/değişiklik yolu kutusuna bir 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 dosyayı kapsıyorsa her dosya, düzenleme bölmesinin üzerindeki satırda bir sekme olarak görünür (bkz. Şekil 4). Bir sekmeyi tıklayarak dosyayı düzenleme bölmesinde açın.

Düzenlemelerinizi yapın

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

Değişiklikleri gönder

Git Kaynak Düzenleyici'de değişikliğinizi oluşturup Gerrit'te yayınlarsınız. Ardından, Gerrit'te değişikliğin onayını takip edebilirsiniz.

Değişiklikleri oluşturma ve yayınlama

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

Uygun düğmeyi tıklayın:
- Yeni bir değişiklik oluşturuyorsanız Değişiklik oluştur'u tıklayın.
- Mevcut bir değişikliği güncelliyorsanız Değişikliği güncelle'yi tıklayın.
Bir iletişim kutusu açılır.

Şekil 5. Değişiklik oluştur iletişim kutusu
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üzenlerseniz dilerseniz açıklamasını da düzenleyebilirsiniz.
İsteğe bağlı olarak Oluşturma sırasında yayınla onay kutusunun işaretini kaldırın veya kutuyu işaretleyin.

Bu kutu varsayılan olarak seçilidir.

Değişikliği oluştururken bu kutu seçiliyse değişiklik hemen Gerrit'te yayınlanır. Kutu seçili değilse değişiklik Gerrit'e yüklenir ancak yayınlanmaz.
Oluştur'u tıklayın.

Değişiklik Gerrit'e yüklenir. Oluşturma sırasında yayınla onay kutusunu işaretlediyseniz değişiklik Gerrit'te de yayınlanır. Değişiklik, ekranın üst kısmındaki bir bildirime bağlanır.

Şekil 6. Değişiklik oluşturuldu bildirimi

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

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

Gerrit'te değişiklik gönderme durumunu izleme

Şekil 7. Gerrit'te değişiklik gönderme durumunu izleme

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

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 işaretleyin. Bu, bir dosyayı değiştirirken ve mevcut bir değişikliği düzenlerken yararlıdır.

Dosya karşılaştırmalarını görüntüleme

Şekil 8. Dosya karşılaştırmalarını görüntüleme

Dosyaları geri alma

Tek bir dosyadaki veya bekleyen değişiklik listesindeki tüm dosyalardaki değişiklikleri geri alabilirsiniz. Her iki geri alma seçeneği de yalnızca Git Kaynak Düzenleyici'deki değişiklikleri geri alır. Gerrit'teki değişikliği GÜNCELLEMEYECEKLER.

Tek bir dosyayı geri alma

Tek bir dosyayı geri almak için Beklemedeki değişiklikler listesinde dosya adının yanındaki X simgesini tıklayın.

Bekleyen değişiklikler bölümü

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

Tüm dosyaları geri alma

Tüm dosyaları aynı anda geri almak için düzenleme bölmesinin altındaki Tüm dosyaları geri al'ı tıklayın.

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

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

Tüm dosyaları geri alma onayı iletişim kutusu

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

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

Bir dosyayı doğrudan Android kod aramasından Git Kaynak Düzenleyici'de açabilirsiniz. Bu, dosyayı düzenlemeden önce bulmanız gerekiyorsa yararlıdır.

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

Android Code Search'te (cs.android.com) düzenlemek istediğiniz dosyaya gidin.
Kodu düzenle'yi tıklayın.

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

Git Kaynak Düzenleyici, düzenleme için önceden seçili olan dosyayla açılır.
Bir git dalı seçin açılır listesinden dosyayı düzenlemek istediğiniz Git dalını seçip Dal seç'i tıklayın.

Şekil 13. Düzenlenecek bir Git dalı seçme

Dosya, düzenleme bölmesinde açılır.
Düzenlemelerinizi yapma bölümünde açıklandığı şekilde düzenlemeye devam edin.
Dosya yükleme bölümünde açıklandığı şekilde düzenlemek için ek dosyalar açabilirsiniz.

Çakışmaları çözme

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

Kaynak Düzenleyici'de, değişiklik bölümüne gidin. Değişiklik yüklendikten sonra, çelişen dosyalar ekranın alt kısmında listelenir. Örneğin, Şekil 14'te Android.pb dosyasında çakışma olduğu gösterilmektedir.

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

Şekil 15. Kaynak düzenleyici çakışması işaretçileri
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çerikleri ve çakışan işaretçileri de kaldırın.
Yeni bir değişiklik oluşturmak için Değişiklik Oluştur'u tıklayın. Değişiklik Oluştur iletişim kutusu görünür.

Şekil 16. Değişiklik oluşturma
Değişiklik açıklaması yazın ve Oluştur'u tıklayın.