Scaricamento della fonte

L'albero dei sorgenti Android si trova in un repository Git ospitato da Google. Il repository Git include metadati per l'origine Android, comprese le modifiche all'origine e il momento in cui sono state apportate le modifiche. Questa pagina descrive come scaricare l'albero dei sorgenti per una specifica riga di codice Android.

Per iniziare con un'immagine di fabbrica per un dispositivo specifico invece di scaricare l'origine, consulta Selezione di una build del dispositivo .

Inizializzazione di un client Repo

Dopo aver installato Repo Launcher , configura il tuo client per accedere al repository di origine Android:

  1. Crea una directory vuota per contenere i tuoi file di lavoro. Dategli il nome che preferite:

    mkdir WORKING_DIRECTORY
cd WORKING_DIRECTORY

  2. Configura Git con il tuo vero nome e indirizzo email. Per utilizzare lo strumento di revisione del codice Gerrit, è necessario un indirizzo email collegato a un account Google registrato . Assicurati che questo sia un indirizzo attivo dove puoi ricevere messaggi. Il nome che fornisci qui viene visualizzato nelle attribuzioni per il codice inviato.

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

  3. Esegui repo init per ottenere l'ultima versione di Repo con le correzioni di bug più recenti. È necessario specificare un URL per il manifest, che specifica dove vengono posizionati i vari repository inclusi nell'origine Android all'interno della directory di lavoro.

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

    Per controllare il ramo principale:

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

    Per estrarre un ramo diverso da main , specificarlo con -b . Per un elenco dei rami, consulta Tag e build del codice sorgente .

    Per Python2

    Per Python3

    Se ricevi il messaggio di errore " /usr/bin/env 'python' no such file or directory ", utilizza una delle seguenti soluzioni:

    Se Ubuntu 20.04.2 LTS è una versione Linux appena installata (anziché aggiornata): 

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

    Se utilizzi Git versione 2.19 o successiva, puoi specificare --partial-clone quando esegui repo init . Questo sfrutta la capacità di clonazione parziale di Git per scaricare gli oggetti Git solo quando necessario, invece di scaricare tutto. Poiché l'utilizzo di cloni parziali implica che molte operazioni debbano comunicare con il server, utilizza quanto segue se sei uno sviluppatore e utilizzi una rete con bassa latenza:

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

    Solo per sistema operativo Windows: se ricevi un messaggio di errore che indica che non è stato possibile creare collegamenti simbolici, causando il fallimento repo init , fai riferimento alla documentazione di GitHub Symbolic Links per crearli o per abilitare il loro supporto. Per i non amministratori, vedere la sezione Consentire ai non amministratori di creare collegamenti simbolici .

Un'inizializzazione riuscita termina con un messaggio che informa che Repo è inizializzato nella directory di lavoro. La directory del tuo client ora contiene una directory .repo in cui vengono conservati file come il manifest.

Download dell'albero dei sorgenti Android

Per scaricare l'albero dei sorgenti Android nella directory di lavoro dai repository come specificato nel manifest predefinito, esegui:

repo sync

Per velocizzare le sincronizzazioni, passa i flag -c (ramo corrente) e -j threadcount :

repo sync -c -j8

I file sorgente Android vengono scaricati nella directory di lavoro con i nomi dei progetti.

Per sopprimere l'output, passare il flag -q (silenzioso). Vedere il riferimento al comando Repo per tutte le opzioni.

Utilizzando l'autenticazione

Per impostazione predefinita, l'accesso al codice sorgente Android è anonimo. Per proteggere i server da un utilizzo eccessivo, ad ogni indirizzo IP è associata una quota.

Quando si condivide un indirizzo IP con altri utenti (ad esempio, quando si accede ai repository di origine da oltre un firewall NAT), le quote possono attivarsi anche per modelli di utilizzo regolari (ad esempio, se molti utenti sincronizzano nuovi client dallo stesso indirizzo IP all'interno di un breve periodo).

In tal caso, puoi utilizzare l'accesso autenticato, che utilizza quindi una quota separata per ciascun utente, indipendentemente dall'indirizzo IP.

Innanzitutto, crea una password con il generatore di password e segui le istruzioni sulla pagina del generatore di password.

Successivamente, forza l'accesso autenticato utilizzando l'URI manifest https://android.googlesource.com/a/platform/manifest . Notare come il prefisso della directory /a/ attiva l'autenticazione obbligatoria. Puoi convertire un client esistente per utilizzare l'autenticazione obbligatoria con il seguente comando:

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

Risoluzione dei problemi di rete

Quando si effettua il download da dietro un proxy (cosa comune in alcuni ambienti aziendali), potrebbe essere necessario specificare esplicitamente il proxy da utilizzare per 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>

Più raramente, i client Linux riscontrano problemi di connettività, rimanendo bloccati nel mezzo dei download (in genere durante la ricezione di oggetti ). La regolazione delle impostazioni dello stack TCP/IP e l'utilizzo di comandi non paralleli possono migliorare la situazione. È necessario disporre dell'accesso root per modificare l'impostazione TCP:

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

Utilizzando un mirror locale

Quando si utilizzano più client, è possibile creare un mirror locale dell'intero contenuto del server e sincronizzare i client da quel mirror (che non richiede accesso alla rete).

Queste istruzioni presuppongono che il mirror sia creato in /usr/local/aosp/mirror . Innanzitutto, crea e sincronizza il mirror stesso. Nota il flag --mirror , che puoi specificare solo quando crei un nuovo client:

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

Quando il mirror è sincronizzato, puoi creare nuovi client da esso. Tieni presente che devi specificare un percorso assoluto:

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

Infine, per sincronizzare un client con il server, sincronizza il mirror con il server, quindi il client con il mirror:

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

È possibile archiviare il mirror su un server LAN e accedervi tramite NFS, SSH o Git. È anche possibile memorizzarlo su un'unità rimovibile e passare tale unità tra utenti o macchine.

Verifica dei tag Git

Carica la seguente chiave pubblica nel database delle chiavi GnuPG. La chiave viene utilizzata per firmare tag annotati che rappresentano le versioni.

gpg --import

Copia e incolla la chiave seguente, quindi digita EOF ( Ctrl-D ) per terminare l'input ed elaborare le chiavi.

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

Dopo aver importato le chiavi, puoi verificare qualsiasi tag con:

git tag -v TAG_NAME

Ottieni file binari proprietari

AOSP non può essere utilizzato solo dal codice sorgente puro e richiede l'esecuzione di librerie proprietarie aggiuntive relative all'hardware, ad esempio per l'accelerazione grafica hardware. Consulta le sezioni seguenti per i collegamenti di download e i file binari del dispositivo per risorse aggiuntive.

Scarica i binari proprietari

Puoi scaricare i file binari ufficiali per i dispositivi supportati che eseguono rami di rilascio AOSP contrassegnati dai driver di Google . Questi file binari aggiungono l'accesso a funzionalità hardware aggiuntive con codice non open source. Per creare il ramo principale AOSP, utilizzare invece l' anteprima binaria . Quando crei il ramo principale per un dispositivo, utilizza i file binari per la versione numerata più recente o con la data più recente.

Estrai file binari proprietari

Ogni set di file binari si presenta come uno script autoestraente in un archivio compresso. Decomprimi ciascun archivio, esegui lo script autoestraente incluso dalla radice dell'albero dei sorgenti, quindi conferma di accettare i termini del contratto di licenza allegato. I file binari e i relativi makefile corrispondenti vengono installati nella gerarchia vendor/ dell'albero dei sorgenti.

Ripulire

Per garantire che i file binari appena installati vengano presi in considerazione correttamente dopo essere stati estratti, eliminare l'output esistente di qualsiasi build precedente utilizzando:

make clobber