Mengunduh sumbernya

Pohon sumber Android terletak di repositori Git yang dihosting oleh Google. Repositori Git menyertakan metadata untuk sumber Android, termasuk perubahan pada sumber dan waktu perubahan dilakukan. Halaman ini menjelaskan cara mengunduh pohon sumber untuk baris kode Android tertentu.

Untuk memulai dengan image pabrik untuk perangkat tertentu alih-alih mengunduh sumbernya, lihat Memilih versi perangkat .

Menginisialisasi klien Repo

Setelah menginstal Repo Launcher , siapkan klien Anda untuk mengakses repositori sumber Android:

  1. Buat direktori kosong untuk menyimpan file kerja Anda. Berikan nama apa pun yang Anda suka:

    mkdir WORKING_DIRECTORY
cd WORKING_DIRECTORY

  2. Konfigurasikan Git dengan nama asli dan alamat email Anda. Untuk menggunakan alat peninjauan kode Gerrit, Anda memerlukan alamat email yang terhubung dengan akun Google yang terdaftar . Pastikan ini adalah alamat aktif tempat Anda dapat menerima pesan. Nama yang Anda berikan di sini muncul dalam atribusi untuk pengiriman kode Anda.

    git config --global user.name Your Name
git config --global user.email you@example.com

  3. Jalankan repo init untuk mendapatkan Repo versi terbaru dengan perbaikan bug terbaru. Anda harus menentukan URL untuk manifes, yang menentukan lokasi penempatan berbagai repositori yang termasuk dalam sumber Android dalam direktori kerja Anda.

    repo init -u https://android.googlesource.com/platform/manifest

    Untuk memeriksa cabang utama:

    repo init -u https://android.googlesource.com/platform/manifest -b main

    Untuk memeriksa cabang selain main , tentukan dengan -b . Untuk daftar cabang, lihat Tag dan build kode sumber .

    Untuk Python 2

    Untuk Python 3

    Jika Anda mendapatkan pesan kesalahan " /usr/bin/env 'python' no such file or directory ", gunakan salah satu solusi berikut:

    Jika Ubuntu 20.04.2 LTS Anda adalah versi Linux yang baru diinstal (vs. ditingkatkan): 

    sudo ln -s /usr/bin/python3 /usr/bin/python

    Jika menggunakan Git versi 2.19 atau lebih tinggi, Anda dapat menentukan --partial-clone saat menjalankan repo init . Hal ini memanfaatkan kemampuan kloning parsial Git untuk hanya mengunduh objek Git saat diperlukan, alih-alih mengunduh semuanya. Karena menggunakan klon parsial berarti banyak operasi harus berkomunikasi dengan server, gunakan yang berikut ini jika Anda seorang pengembang dan menggunakan jaringan dengan latensi rendah:

    repo init -u https://android.googlesource.com/platform/manifest -b main --partial-clone --clone-filter=blob:limit=10M

    Hanya untuk OS Windows: jika Anda mendapatkan pesan kesalahan yang menyatakan bahwa tautan simbolis tidak dapat dibuat, sehingga menyebabkan repo init gagal, rujuk dokumentasi Tautan Simbolik GitHub untuk membuatnya, atau untuk mengaktifkan dukungannya. Untuk non-administrator, lihat bagian Mengizinkan non-administrator membuat tautan simbolik .

Inisialisasi yang berhasil diakhiri dengan pesan yang menyatakan bahwa Repo diinisialisasi di direktori kerja Anda. Direktori klien Anda sekarang berisi direktori .repo tempat file seperti manifes disimpan.

Mengunduh pohon sumber Android

Untuk mendownload pohon sumber Android ke direktori kerja Anda dari repositori seperti yang ditentukan dalam manifes default, jalankan:

repo sync

Untuk mempercepat sinkronisasi, teruskan flag -c (cabang saat ini) dan -j threadcount :

repo sync -c -j8

File sumber Android diunduh di direktori kerja Anda dengan nama proyeknya.

Untuk menekan keluaran, berikan tanda -q (tenang). Lihat Referensi Perintah Repo untuk semua opsi.

Menggunakan otentikasi

Secara default, akses ke kode sumber Android bersifat anonim. Untuk melindungi server dari penggunaan berlebihan, setiap alamat IP dikaitkan dengan kuota.

Saat berbagi alamat IP dengan pengguna lain (misalnya, saat mengakses repositori sumber dari luar firewall NAT), kuota dapat terpicu bahkan untuk pola penggunaan reguler (misalnya, jika banyak pengguna menyinkronkan klien baru dari alamat IP yang sama dalam satu periode singkat).

Dalam hal ini, Anda dapat menggunakan akses terautentikasi, yang kemudian menggunakan kuota terpisah untuk setiap pengguna, apa pun alamat IP-nya.

Pertama, buat kata sandi dengan pembuat kata sandi dan ikuti instruksi di halaman pembuat kata sandi.

Berikutnya, paksa akses yang diautentikasi dengan menggunakan URI manifes https://android.googlesource.com/a/platform/manifest . Perhatikan bagaimana awalan direktori /a/ memicu otentikasi wajib. Anda dapat mengonversi klien yang sudah ada untuk menggunakan autentikasi wajib dengan perintah berikut:

repo init -u https://android.googlesource.com/a/platform/manifest

Memecahkan masalah jaringan

Saat mengunduh dari belakang proxy (yang umum terjadi di beberapa lingkungan perusahaan), Anda mungkin perlu secara eksplisit menentukan proxy yang akan digunakan Repo:

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>

Lebih jarang lagi, klien Linux mengalami masalah konektivitas, terjebak di tengah pengunduhan (biasanya saat menerima objek ). Menyesuaikan pengaturan tumpukan TCP/IP dan menggunakan perintah non-paralel dapat memperbaiki situasi. Anda harus memiliki akses root untuk mengubah pengaturan TCP:

sudo sysctl -w net.ipv4.tcp_window_scaling=0
repo sync -j1

Menggunakan cermin lokal

Saat menggunakan beberapa klien, Anda dapat membuat mirror lokal dari seluruh konten server dan menyinkronkan klien dari mirror tersebut (yang tidak memerlukan akses jaringan).

Instruksi ini mengasumsikan bahwa mirror dibuat di /usr/local/aosp/mirror . Pertama, buat dan sinkronkan cermin itu sendiri. Perhatikan flag --mirror , yang hanya dapat Anda tentukan saat membuat klien baru:

mkdir -p /usr/local/aosp/mirror
cd /usr/local/aosp/mirror
repo init -u https://android.googlesource.com/mirror/manifest --mirror
repo sync

Saat cermin disinkronkan, Anda dapat membuat klien baru darinya. Perhatikan bahwa Anda harus menentukan jalur absolut:

mkdir -p /usr/local/aosp/main
cd /usr/local/aosp/main
repo init -u /usr/local/aosp/mirror/platform/manifest.git
repo sync

Terakhir, untuk menyinkronkan klien dengan server, sinkronkan mirror dengan server, lalu klien dengan mirror:

cd /usr/local/aosp/mirror
repo sync
cd /usr/local/aosp/main
repo sync

Mirror dapat disimpan di server LAN dan diakses melalui NFS, SSH, atau Git. Dimungkinkan juga untuk menyimpannya di drive yang dapat dilepas dan meneruskan drive tersebut ke pengguna atau mesin.

Memverifikasi tag Git

Muat kunci publik berikut ke dalam basis data kunci GnuPG Anda. Kuncinya digunakan untuk menandatangani tag beranotasi yang mewakili rilis.

gpg --import

Salin dan tempel kunci di bawah ini, lalu ketik EOF ( Ctrl-D ) untuk mengakhiri input dan memproses kunci.

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

Setelah mengimpor kunci, Anda dapat memverifikasi tag apa pun dengan:

git tag -v TAG_NAME

Dapatkan biner berpemilik

AOSP tidak dapat digunakan hanya dari kode sumber murni dan memerlukan pustaka kepemilikan tambahan terkait perangkat keras untuk dijalankan, seperti untuk akselerasi grafis perangkat keras. Lihat bagian di bawah untuk tautan unduhan dan Biner perangkat untuk sumber daya tambahan.

Unduh binari berpemilik

Anda dapat mengunduh biner resmi untuk perangkat yang didukung yang menjalankan cabang rilis AOSP yang diberi tag dari driver Google . Biner ini menambahkan akses ke kemampuan perangkat keras tambahan dengan kode sumber non-terbuka. Untuk membangun cabang utama AOSP, gunakan Pratinjau Biner sebagai gantinya. Saat membangun cabang utama untuk suatu perangkat, gunakan biner untuk rilis bernomor terbaru atau dengan tanggal terbaru.

Ekstrak binari berpemilik

Setiap kumpulan biner hadir sebagai skrip yang mengekstraksi sendiri dalam arsip terkompresi. Buka kompresi setiap arsip, jalankan skrip ekstraksi mandiri yang disertakan dari akar pohon sumber, lalu konfirmasikan bahwa Anda menyetujui ketentuan perjanjian lisensi yang terlampir. Biner dan makefile yang cocok dipasang di vendor/ hierarki pohon sumber.

Membersihkan

Untuk memastikan biner yang baru diinstal diperhitungkan dengan benar setelah diekstraksi, hapus output yang ada dari build sebelumnya menggunakan:

make clobber