Prima di scaricare e creare il ramo main
dell'origine Android, assicurati che l'hardware soddisfi i requisiti necessari e che il software richiesto sia installato correttamente. Dovresti anche conoscere i seguenti termini:
- Git
- Git è un sistema di controllo della versione distribuito, senza costi e open source. Android utilizza Git per le operazioni locali come branching, commit, diff e modifiche. Per informazioni su come utilizzare Git, consulta la documentazione di Git.
- Repo
- Repo è un wrapper Python per Git che semplifica l'esecuzione di operazioni complesse su più repository Git. Repo non sostituisce Git per tutte le operazioni di controllo della versione, ma semplifica solo le operazioni di Git complesse. Repo utilizza i file manifest per aggregare i progetti Git nel superprogetto Android.
- File manifest
- Un file manifest è un file XML che specifica dove sono posizionati i vari progetti Git nel codice sorgente di Android all'interno di una struttura ad albero del codice sorgente AOSP.
Soddisfare i requisiti hardware
La workstation di sviluppo deve soddisfare o superare i seguenti requisiti hardware:
Un sistema x86 a 64 bit.
Almeno 400 GB di spazio libero su disco per il check-out e la compilazione del codice (250 GB per il check-out + 150 GB per la compilazione).
Almeno 64 GB di RAM. Google utilizza macchine con 72 core e 64 GB di RAM per compilare Android. Con questa configurazione hardware, sono necessari circa 40 minuti per una build completa di Android e solo pochi minuti per una build incrementale di Android. Al contrario, sono necessarie circa 6 ore per una compilazione completa con una macchina a 6 core con 64 GB di RAM.
Soddisfare i requisiti del sistema operativo
La workstation di sviluppo deve eseguire qualsiasi distribuzione Linux a 64 bit con GNU C Library (glibc) 2.17 o versioni successive.
Installa i pacchetti richiesti
Per compilare Android 11 o versioni successive, devi utilizzare Ubuntu 18.04 o versioni successive. Per installare i pacchetti obbligatori per Ubuntu 18.04 o versioni successive, esegui il seguente comando:
sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig
Tra i pacchetti installati, questo comando installa Git, che viene utilizzato per scaricare il codice sorgente di AOSP.
Installa il software necessario
Prima di poter lavorare con AOSP, devi installare OpenJDK, Make, Python 3 e Repo. Il ramo principale AOSP di Android include versioni predefinite di OpenJDK, Make e Python 3, quindi non sono necessari passaggi di installazione aggiuntivi. La sezione seguente spiega come installare Repo.
Installa Repo
Segui questi passaggi per installare il repository:
Scarica le informazioni sul pacchetto corrente:
sudo apt-get update
Esegui il seguente comando per installare il programma di lancio del repository:
sudo apt-get install repo
Il programma di lancio di Repo fornisce uno script Python che inizializza un controllo e scarica lo strumento Repo completo.
Se l'operazione è andata a buon fine, vai al passaggio 4.
(Facoltativo) Installa manualmente Repo utilizzando la seguente serie di comandi:
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
I primi tre comandi configurano un file temporaneo, scaricano il repository nel file e verificano che la chiave fornita corrisponda a quella richiesta. Se questi comandi vanno a buon fine, il comando finale installa il programma di lancio del repository.
Verifica la versione di Avvio app repository:
repo version
L'output dovrebbe indicare una versione 2.4 o successiva, ad esempio:
repo launcher version 2.45
Imposta una directory di output alternativa
Per impostazione predefinita, l'output di ogni build viene archiviato nella sottodirectory out/
della
struttura di origine corrispondente. Puoi sostituire questa directory esportando la variabile di ambiente OUT_DIR
. Ad esempio, se vuoi memorizzare l'output su un'altra unità, puoi indirizzare OUT_DIR
a quell'unità:
export OUT_DIR=my_other_drive
Passaggi successivi
- Per scaricare il codice sorgente, vai a Scaricare il codice sorgente di Android.
- Per informazioni su come utilizzare Git, consulta la documentazione di Git.
- Per ulteriore documentazione su Repo, consulta il file README di Repo.
- Per un elenco di tutti i comandi Repo, consulta il riferimento ai comandi Repo.