Android kaynak ağacı, Google tarafından barındırılan bir Git deposunda bulunur. Git deposu, kaynakta yapılan değişiklikler ve değişikliklerin ne zaman yapıldığı dahil olmak üzere Android kaynağı için meta verileri içerir. Bu sayfada, belirli bir Android kod satırı için kaynak ağacının nasıl indirileceği açıklanmaktadır.
Kaynağı indirmek yerine belirli bir cihaz için fabrika görüntüsüyle başlamak için bkz.Bir cihaz yapısı seçme .
Bir Repo istemcisini başlatmak
Repo Launcher'ı kurduktan sonra, istemcinizi Android kaynak deposuna erişecek şekilde ayarlayın:
Çalışma dosyalarınızı tutmak için boş bir dizin oluşturun. MacOS kullanıyorsanız, bunun büyük / küçük harfe duyarlı bir dosya sisteminde olması gerekir. İstediğiniz adı verin:
mkdir WORKING_DIRECTORY
cd WORKING_DIRECTORY
Git'i gerçek adınız ve e-posta adresinizle yapılandırın. Gerrit kod inceleme aracını kullanmak için, kayıtlı bir Google hesabına bağlı bir e-posta adresine ihtiyacınız vardır. Bunun mesajları alabileceğiniz canlı bir adres olduğundan emin olun. Burada sağladığınız ad, kod gönderimlerinize ilişkin atıflarda görünür.
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
En son hata düzeltmeleriyle Repo'nun en son sürümünü almak için
repo init
çalıştırın. Manifest için, Android kaynağında bulunan çeşitli havuzların çalışma dizininizde nereye yerleştirileceğini belirten bir URL belirtmelisiniz.repo init -u https://android.googlesource.com/platform/manifest
Not:
repo init
macOS'ta bir sertifika hatası nedeniyle başarısız olursa, önce şunu çalıştırmanız gerekebilir:# macOS only open /Applications/Python\ 3.6/Install\ Certificates.command
Ana dalı kontrol etmek için:
repo init -u https://android.googlesource.com/platform/manifest -b master
Master dışında bir dalı teslim almak için,
-b
ile belirtin. Dalların listesi için bkz. Kaynak kod etiketleri ve derlemeler .
Git sürüm 2.19 veya --partial-clone
kullanıyorsanız, Git'in her şeyi indirmek yerine yalnızca gerektiğinde Git nesnelerini indiren kısmi klonlama yeteneğinden yararlanacak olan repo init
gerçekleştirirken --partial-clone
belirtebilirsiniz. Kısmi klonların kullanılması, birçok işlemin sunucuyla iletişim kurması gerektiği anlamına geldiğinden, bu, düşük gecikmeli bir ağ kullanan geliştiriciler için önerilir:
repo init -u https://android.googlesource.com/platform/manifest -b master --partial-clone --clone-filter=blob:limit=10M
Başarılı bir başlatma, Repo'nun çalışma dizininizde başlatıldığını belirten bir mesajla sona erer. İstemci dizininiz artık, manifest gibi dosyaların .repo
bir .repo
dizini içermelidir.
Android kaynak ağacını indirme
Android kaynak ağacını, varsayılan bildirimde belirtildiği gibi depolardan çalışma dizininize indirmek için şunu çalıştırın:
repo sync
Eşitlemeyi hızlandırmak için, bunun yerine -c
(geçerli dal) ve -j threadcount
bayraklarını -j threadcount
:
repo sync -c -j8
Android kaynak dosyaları, proje adları altında çalışma dizininize indirilir.
Çıkışı bastırmak için -q
(sessiz) bayrağını -q
. Tüm seçenekler için Repo Komut Referansına bakın.
Kimlik doğrulama kullanma
Varsayılan olarak, Android kaynak koduna erişim anonimdir. Sunucuları aşırı kullanıma karşı korumak için her IP adresi bir kota ile ilişkilendirilir.
Bir IP adresini diğer kullanıcılarla paylaşırken (örneğin, kaynak depolarına bir NAT güvenlik duvarının ötesinden erişirken), kotalar normal kullanım kalıpları için bile tetiklenebilir (örneğin, birçok kullanıcı yeni istemcileri bir IP adresinden aynı IP adresinden senkronize ederse) kısa süre).
Bu durumda, kimliği doğrulanmış erişimi kullanabilirsiniz, bu daha sonra IP adresinden bağımsız olarak her kullanıcı için ayrı bir kota kullanır.
İlk adım olan bir parola oluşturmak için şifre üreteci ve şifre üreteci sayfadaki yönergeleri izleyin.
İkinci adım, https://android.googlesource.com/a/platform/manifest
bildirim URL'sini kullanarak kimliği doğrulanmış erişimi zorlamaktır. /a/
dizin önekinin zorunlu kimlik doğrulamasını nasıl tetiklediğine dikkat edin. Aşağıdaki komutla mevcut bir istemciyi zorunlu kimlik doğrulamasını kullanacak şekilde dönüştürebilirsiniz:
repo init -u https://android.googlesource.com/a/platform/manifest
Ağ sorunlarını giderme
Bir proxy'nin arkasından indirirken (bazı kurumsal ortamlarda yaygındır), daha sonra Repo tarafından kullanılacak proxy'yi açıkça belirtmeniz gerekebilir:
export HTTP_PROXY=http://<proxy_user_id>:<proxy_password>@<proxy_server>:<proxy_port>
export HTTPS_PROXY=http://<proxy_user_id>:<proxy_password>@<proxy_server>:<proxy_port>
Daha nadiren, Linux istemcileri bağlantı sorunları yaşar ve indirmelerin ortasında sıkışıp kalır (tipik olarak nesneleri alırken ). TCP / IP yığını ayarlarını değiştirmenin ve paralel olmayan komutları kullanmanın durumu iyileştirebileceği bildirildi. TCP ayarını değiştirmek için root erişimine ihtiyacınız var:
sudo sysctl -w net.ipv4.tcp_window_scaling=0
repo sync -j1
Yerel bir ayna kullanma
Birkaç istemci kullanırken, özellikle bant genişliğinin kıt olduğu durumlarda, tüm sunucu içeriğinin yerel bir yansımasını oluşturmak ve istemcileri bu yansıtmadan senkronize etmek (ağ erişimi gerektirmez) daha iyidir. Tam aynanın indirilmesi, iki istemcinin indirilmesinden daha küçüktür ve daha fazla bilgi içerir.
Bu talimatlar, aynanın /usr/local/aosp/mirror
içinde oluşturulduğunu varsayar. İlk olarak, aynanın kendisini oluşturun ve senkronize edin. Yalnızca yeni bir istemci oluştururken belirtebileceğiniz --mirror
bayrağına dikkat edin:
mkdir -p /usr/local/aosp/mirror
cd /usr/local/aosp/mirror
repo init -u https://android.googlesource.com/mirror/manifest --mirror
repo sync
Ayna senkronize edildiğinde, ondan yeni istemciler oluşturabilirsiniz. Mutlak bir yol belirlemenin önemli olduğunu unutmayın:
mkdir -p /usr/local/aosp/master
cd /usr/local/aosp/master
repo init -u /usr/local/aosp/mirror/platform/manifest.git
repo sync
Son olarak, bir istemciyi sunucuya karşı senkronize etmek için yansıtmayı sunucuya, ardından istemciyi yansıtmaya karşı senkronize edin:
cd /usr/local/aosp/mirror
repo sync
cd /usr/local/aosp/master
repo sync
Yansımayı bir LAN sunucusunda depolamak ve ona NFS, SSH veya Git üzerinden erişmek mümkündür. Ayrıca çıkarılabilir bir sürücüde saklamak ve bu sürücüyü kullanıcılar veya makineler arasında geçirmek de mümkündür.
Git etiketlerini doğrulama
Aşağıdaki genel anahtarı GnuPG anahtar veritabanınıza yükleyin. Anahtar, sürümleri temsil eden ek açıklamalı etiketleri imzalamak için kullanılır.
gpg --import
Aşağıdaki anahtarı kopyalayıp yapıştırın, ardından girişi bitirmek ve tuşları işlemek için EOF
( Ctrl-D ) yazın.
-----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v1.4.2.2 (GNU/Linux) mQGiBEnnWD4RBACt9/h4v9xnnGDou13y3dvOx6/t43LPPIxeJ8eX9WB+8LLuROSV lFhpHawsVAcFlmi7f7jdSRF+OvtZL9ShPKdLfwBJMNkU66/TZmPewS4m782ndtw7 8tR1cXb197Ob8kOfQB3A9yk2XZ4ei4ZC3i6wVdqHLRxABdncwu5hOF9KXwCgkxMD u4PVgChaAJzTYJ1EG+UYBIUEAJmfearb0qRAN7dEoff0FeXsEaUA6U90sEoVks0Z wNj96SA8BL+a1OoEUUfpMhiHyLuQSftxisJxTh+2QclzDviDyaTrkANjdYY7p2cq /HMdOY7LJlHaqtXmZxXjjtw5Uc2QG8UY8aziU3IE9nTjSwCXeJnuyvoizl9/I1S5 jU5SA/9WwIps4SC84ielIXiGWEqq6i6/sk4I9q1YemZF2XVVKnmI1F4iCMtNKsR4 MGSa1gA8s4iQbsKNWPgp7M3a51JCVCu6l/8zTpA+uUGapw4tWCp4o0dpIvDPBEa9 b/aF/ygcR8mh5hgUfpF9IpXdknOsbKCvM9lSSfRciETykZc4wrRCVGhlIEFuZHJv aWQgT3BlbiBTb3VyY2UgUHJvamVjdCA8aW5pdGlhbC1jb250cmlidXRpb25AYW5k cm9pZC5jb20+iGAEExECACAFAknnWD4CGwMGCwkIBwMCBBUCCAMEFgIDAQIeAQIX gAAKCRDorT+BmrEOeNr+AJ42Xy6tEW7r3KzrJxnRX8mij9z8tgCdFfQYiHpYngkI 2t09Ed+9Bm4gmEO5Ag0ESedYRBAIAKVW1JcMBWvV/0Bo9WiByJ9WJ5swMN36/vAl QN4mWRhfzDOk/Rosdb0csAO/l8Kz0gKQPOfObtyYjvI8JMC3rmi+LIvSUT9806Up hisyEmmHv6U8gUb/xHLIanXGxwhYzjgeuAXVCsv+EvoPIHbY4L/KvP5x+oCJIDbk C2b1TvVk9PryzmE4BPIQL/NtgR1oLWm/uWR9zRUFtBnE411aMAN3qnAHBBMZzKMX LWBGWE0znfRrnczI5p49i2YZJAjyX1P2WzmScK49CV82dzLo71MnrF6fj+Udtb5+ OgTg7Cow+8PRaTkJEW5Y2JIZpnRUq0CYxAmHYX79EMKHDSThf/8AAwUIAJPWsB/M pK+KMs/s3r6nJrnYLTfdZhtmQXimpoDMJg1zxmL8UfNUKiQZ6esoAWtDgpqt7Y7s KZ8laHRARonte394hidZzM5nb6hQvpPjt2OlPRsyqVxw4c/KsjADtAuKW9/d8phb N8bTyOJo856qg4oOEzKG9eeF7oaZTYBy33BTL0408sEBxiMior6b8LrZrAhkqDjA vUXRwm/fFKgpsOysxC6xi553CxBUCH2omNV6Ka1LNMwzSp9ILz8jEGqmUtkBszwo G1S8fXgE0Lq3cdDM/GJ4QXP/p6LiwNF99faDMTV3+2SAOGvytOX6KjKVzKOSsfJQ hN0DlsIw8hqJc0WISQQYEQIACQUCSedYRAIbDAAKCRDorT+BmrEOeCUOAJ9qmR0l EXzeoxcdoafxqf6gZlJZlACgkWF7wi2YLW3Oa+jv2QSTlrx4KLM= =Wi5D -----END PGP PUBLIC KEY BLOCK-----
Anahtarları içe aktardıktan sonra, aşağıdakilerle herhangi bir etiketi doğrulayabilirsiniz:
git tag -v TAG_NAME
Özel mülk ikili dosyalar edinin
AOSP yalnızca saf kaynak kodundan kullanılamaz ve donanım grafik hızlandırma gibi donanımla ilgili ek özel kitaplıkların çalıştırılmasını gerektirir. İndirme bağlantıları ve ek kaynaklar için Aygıt ikili dosyaları için aşağıdaki bölümlere bakın.
Tescilli ikili dosyaları indirin
Etiketli AOSP sürüm şubelerini çalıştıran desteklenen cihazlar için resmi ikili dosyaları Google'ın sürücülerinden indirebilirsiniz. Bu ikili dosyalar, açık kaynak olmayan kodla ek donanım özelliklerine erişim sağlar. AOSP ana dalını oluşturmak için bunun yerine İkili Dosyalar Önizlemesini kullanın. Bir aygıt için ana dalı oluştururken, en son numaralı sürüm veya en son tarih için ikili dosyaları kullanın.
Tescilli ikili dosyaları ayıklayın
Her ikili dosya kümesi, sıkıştırılmış bir arşivde kendiliğinden açılan bir komut dosyası olarak gelir. Her arşivi açın, kaynak ağacının kökünden içerilen kendi kendine açılan komut dosyasını çalıştırın, ardından ekteki lisans sözleşmesinin koşullarını kabul ettiğinizi onaylayın. İkililer ve bunlarla eşleşen makefile'lar kaynak ağacının vendor/
hiyerarşisine kurulacaktır.
Temizlemek
Yeni kurulan ikili dosyaların çıkarıldıktan sonra uygun şekilde dikkate alınmasını sağlamak için, önceki derlemelerin mevcut çıktılarını şunu kullanarak silin:
make clobber