Kaynak kontrol araçları

Android koduyla çalışmak, hem Git'in (açık kaynaklı bir sürüm kontrol sistemi) hem de Repo'nun (Git'in üzerinde çalışan, Google tarafından oluşturulmuş bir depo yönetimi aracı) kullanılmasını gerektirir. Değişiklikleri incelenmek üzere yüklemek gibi gerçekleştirebileceğiniz düzenli eylemlerin bir özeti için Kaynak Kontrolü İş Akışı sayfasına bakın.

Git

Git, birden fazla depoya dağıtılan büyük projeleri yönetir. Android, yerel dallanma, taahhütler, farklar ve düzenlemeler gibi yerel işlemler için Git'i kullanır. Android projesinin kurulumundaki zorluklardan biri, amatör topluluktan kitlesel pazara yönelik tüketici cihazları üreten büyük OEM'lere kadar dışarıdaki topluluğun en iyi şekilde nasıl destekleneceğini belirlemekti. Google, bileşenlerin değiştirilebilir olmasını ve ilginç bileşenlerin Android dışında kendilerine ait bir yaşam sürmesini istiyordu. Google önce dağıtılmış bir revizyon kontrol sistemi seçti, ardından bunu Git'e kadar daralttı.

Git hakkında daha fazla ayrıntı için bu Git Belgelerine bakın.

Repo

Repo, gerektiğinde Git depolarını birleştirir, Gerrit revizyon kontrol sistemine yüklemeler gerçekleştirir ve Android geliştirme iş akışının bazı bölümlerini otomatikleştirir.

Repo Başlatıcı, bir ödemeyi başlatan ve ikinci bölüm olan tam Repo aracını indiren bir Python betiği sağlar. Repo aracının tamamı Android kaynak kodu ödemesine dahil edilmiştir. Varsayılan olarak $SRCDIR/.repo/repo/... konumunda bulunur ve indirilen Repo Başlatıcısından iletilen komutları alır.

Repo Git'in yerini almaz, yalnızca Android bağlamında Git ile çalışmayı kolaylaştırır. Repo, Git projelerini Android süper projesine toplamak için bildirim dosyalarını kullanır. Yürütülebilir bir Python betiği olan repo komutunu yolunuzun herhangi bir yerine koyabilirsiniz. Android kaynak dosyalarıyla çalışırken, tek bir Repo çalışma dizini gibi ağ çapındaki işlemler için Repo'yu kullanabilirsiniz.

Çoğu durumda Repo yerine Git'i kullanabilir veya karmaşık komutlar oluşturmak için Repo ve Git komutlarını karıştırabilirsiniz. Ancak ağlar arası temel işlemler için Repo'yu kullanmak işinizi çok daha basit hale getirir. Repo hakkında daha fazla ayrıntı için Repo Komut Referansı , Repo README , Repo'da etkinleştirilebilen Ön Yükleme Kancaları (testler) ve AOSP'deki genel belgelere bakın.

Repo Başlatıcısını git-repo-downloads adresinden indirip yüklemek için bkz . Repo Kurulumu .

Gerrit

Gerrit , Git kullanan projelere yönelik web tabanlı bir kod inceleme sistemidir. Gerrit, tüm yetkili kullanıcıların değişiklikleri göndermesine izin vererek Git'in daha merkezi kullanımını teşvik eder; bu değişiklikler, kod incelemesini geçmeleri durumunda otomatik olarak birleştirilir. Ayrıca Gerrit, değişiklikleri tarayıcıda yan yana görüntüleyerek ve satır içi yorumları etkinleştirerek incelemeyi kolaylaştırır.

Android Gerrit inceleme arayüzünü android-review.googlesource.com adresinde ve kod gezinme arayüzünü android.googlesource.com adresinde bulabilirsiniz.

Android Kod Arama, hiçbir şey indirmeden AOSP'de arama yapmanızı sağlar. AOSP kaynak kodunu görüntülemek, açık kaynak dalları arasında geçiş yapmak ve çapraz referanslarda gezinmek için Kod Arama'yı kullanabilirsiniz. Daha fazla bilgi için Kod arama dokümantasyonu için Google Developers sitesine bakın.

Diğer Aletler

Android Studio, Android uygulama geliştirmeye yönelik resmi entegre geliştirme ortamıdır (IDE).

Android Hata Ayıklama Köprüsü (ADB), paketleri yükleyebilmeniz ve değişikliklerinizi değerlendirebilmeniz için geliştirme iş istasyonunuzu doğrudan Android cihazınıza bağlamanıza olanak tanır.

AOSP geliştirme için Android Studio for Platform'u (ASfP) kullanın.

Repo'yu Yükleme

Repo'yu yüklemek için şu adımları izleyin.

  1. Linux dağıtımınızdaki resmi paketi kullanmak için şu komutları çalıştırın:
      sudo apt-get update
  sudo apt-get install repo
    Bu komutlar sisteminizde işe yaramadıysa; örneğin, paket sürümünün güncel olmadığını veya sisteminizde resmi bir paket bulunmadığını gördüyseniz Linux dağıtımı, aşağıdaki komutları kullanarak Repo'yu manuel olarak yükleyin:
    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo

    2. Bu komutlar geçici bir dosya oluşturur, repoyu bu dosyaya indirir ve sağlanan anahtarın gerekli anahtarla eşleştiğini doğrular. Bunlar başarılı olursa kurulum devam eder.

    Kurulumdan sonra, repo version normal bir dizinde çalışırken aşağıdakine benzer bir şey bildirdiğini doğrulayın. (Normal bir dizin, bir repo istemcisinin parçası değildir; örneğin, bu sizin ana dizininizdir.)

  2. Bu komutu çalıştırın:
    3. repo version
  3. Buna benzer bir rapor bekliyoruz:
    4. <repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)
    • repo launcher version numarasının 2.15 veya üzeri olarak raporlanması, doğru sürüm numarasını ve düzgün kurulumu gösterir.
    • (from /usr/bin/repo) bir paketten kurulumu belirtir.
    • (from /home/<>/bin/repo) manuel kurulumu belirtir.

Kurulumun tamamlanması

Sonraki: Tam Repo Aracı kurulumunuzu tamamlamak için Kaynak İndirme sayfasındaki Repo istemcisinin başlatılması konusuna bakın.

,

Android koduyla çalışmak, hem Git'in (açık kaynaklı bir sürüm kontrol sistemi) hem de Repo'nun (Git'in üzerinde çalışan, Google tarafından oluşturulmuş bir depo yönetimi aracı) kullanılmasını gerektirir. Değişiklikleri incelenmek üzere yüklemek gibi gerçekleştirebileceğiniz düzenli eylemlerin bir özeti için Kaynak Kontrolü İş Akışı sayfasına bakın.

Git

Git, birden fazla depoya dağıtılan büyük projeleri yönetir. Android, yerel dallanma, taahhütler, farklar ve düzenlemeler gibi yerel işlemler için Git'i kullanır. Android projesinin kurulumundaki zorluklardan biri, amatör topluluktan kitlesel pazara yönelik tüketici cihazları üreten büyük OEM'lere kadar dışarıdaki topluluğun en iyi şekilde nasıl destekleneceğini belirlemekti. Google, bileşenlerin değiştirilebilir olmasını ve ilginç bileşenlerin Android dışında kendilerine ait bir yaşam sürmesini istiyordu. Google önce dağıtılmış bir revizyon kontrol sistemi seçti, ardından bunu Git'e kadar daralttı.

Git hakkında daha fazla ayrıntı için bu Git Belgelerine bakın.

Repo

Repo, gerektiğinde Git depolarını birleştirir, Gerrit revizyon kontrol sistemine yüklemeler gerçekleştirir ve Android geliştirme iş akışının bazı bölümlerini otomatikleştirir.

Repo Başlatıcı, bir ödemeyi başlatan ve ikinci bölüm olan tam Repo aracını indiren bir Python betiği sağlar. Repo aracının tamamı Android kaynak kodu ödemesine dahil edilmiştir. Varsayılan olarak $SRCDIR/.repo/repo/... konumunda bulunur ve indirilen Repo Başlatıcısından iletilen komutları alır.

Repo Git'in yerini almaz, yalnızca Android bağlamında Git ile çalışmayı kolaylaştırır. Repo, Git projelerini Android süper projesine toplamak için bildirim dosyalarını kullanır. Yürütülebilir bir Python betiği olan repo komutunu yolunuzun herhangi bir yerine koyabilirsiniz. Android kaynak dosyalarıyla çalışırken, tek bir Repo çalışma dizini gibi ağ çapındaki işlemler için Repo'yu kullanabilirsiniz.

Çoğu durumda Repo yerine Git'i kullanabilir veya karmaşık komutlar oluşturmak için Repo ve Git komutlarını karıştırabilirsiniz. Ancak ağlar arası temel işlemler için Repo'yu kullanmak işinizi çok daha basit hale getirir. Repo hakkında daha fazla ayrıntı için Repo Komut Referansı , Repo README , Repo'da etkinleştirilebilen Ön Yükleme Kancaları (testler) ve AOSP'deki genel belgelere bakın.

Repo Başlatıcısını git-repo-downloads adresinden indirip yüklemek için bkz . Repo Kurulumu .

Gerrit

Gerrit , Git kullanan projelere yönelik web tabanlı bir kod inceleme sistemidir. Gerrit, tüm yetkili kullanıcıların değişiklikleri göndermesine izin vererek Git'in daha merkezi kullanımını teşvik eder; bu değişiklikler, kod incelemesini geçmeleri durumunda otomatik olarak birleştirilir. Ayrıca Gerrit, değişiklikleri tarayıcıda yan yana görüntüleyerek ve satır içi yorumları etkinleştirerek incelemeyi kolaylaştırır.

Android Gerrit inceleme arayüzünü android-review.googlesource.com adresinde ve kod gezinme arayüzünü android.googlesource.com adresinde bulabilirsiniz.

Android Kod Arama, hiçbir şey indirmeden AOSP'de arama yapmanızı sağlar. AOSP kaynak kodunu görüntülemek, açık kaynak dalları arasında geçiş yapmak ve çapraz referanslarda gezinmek için Kod Arama'yı kullanabilirsiniz. Daha fazla bilgi için Kod arama dokümantasyonu için Google Developers sitesine bakın.

Diğer Aletler

Android Studio, Android uygulama geliştirmeye yönelik resmi entegre geliştirme ortamıdır (IDE).

Android Hata Ayıklama Köprüsü (ADB), paketleri yükleyebilmeniz ve değişikliklerinizi değerlendirebilmeniz için geliştirme iş istasyonunuzu doğrudan Android cihazınıza bağlamanıza olanak tanır.

AOSP geliştirme için Android Studio for Platform'u (ASfP) kullanın.

Repo'yu Yükleme

Repo'yu yüklemek için şu adımları izleyin.

  1. Linux dağıtımınızdaki resmi paketi kullanmak için şu komutları çalıştırın:
      sudo apt-get update
  sudo apt-get install repo
    Bu komutlar sisteminizde işe yaramadıysa; örneğin, paket sürümünün güncel olmadığını veya sisteminizde resmi bir paket bulunmadığını gördüyseniz Linux dağıtımı, aşağıdaki komutları kullanarak Repo'yu manuel olarak yükleyin:
    export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo

    2. Bu komutlar geçici bir dosya oluşturur, repoyu bu dosyaya indirir ve sağlanan anahtarın gerekli anahtarla eşleştiğini doğrular. Bunlar başarılı olursa kurulum devam eder.

    Kurulumdan sonra, repo version normal bir dizinde çalışırken aşağıdakine benzer bir şey bildirdiğini doğrulayın. (Normal bir dizin, bir repo istemcisinin parçası değildir; örneğin, bu sizin ana dizininizdir.)

  2. Bu komutu çalıştırın:
    3. repo version
  3. Buna benzer bir rapor bekliyoruz:
    4. <repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)
    • repo launcher version numarasının 2.15 veya üzeri olarak raporlanması, doğru sürüm numarasını ve düzgün kurulumu gösterir.
    • (from /usr/bin/repo) bir paketten kurulumu belirtir.
    • (from /home/<>/bin/repo) manuel kurulumu belirtir.

Kurulumun tamamlanması

Sonraki: Tam Repo Aracı kurulumunuzu tamamlamak için Kaynak İndirme sayfasındaki Repo istemcisinin başlatılması konusuna bakın.