Für die AOSP-Entwicklung (9.0 oder höher) einrichten

Bevor du den neuesten Release-Zweig (android17-release) der Android-Quelle herunterlädst und erstellst, solltest du prüfen, ob deine Hardware die erforderlichen Voraussetzungen erfüllt und die erforderliche Software ordnungsgemäß installiert ist. Außerdem sollten Sie mit den folgenden Begriffen vertraut sein:

Git
Git ist ein kostenloses, verteiltes Open-Source-Versionsverwaltungssystem. Android verwendet Git für lokale Vorgänge wie Verzweigungen, Commits, Diffs und Bearbeitungen. Informationen zu Git finden Sie in der Git-Dokumentation.
Repo
Repo ist ein Python-Wrapper für Git, der die Ausführung komplexer Vorgänge in mehreren Git-Repositories vereinfacht. Repo ersetzt Git nicht für alle Versionsverwaltungsvorgänge, sondern vereinfacht nur komplexe Git-Vorgänge. Repo verwendet Manifestdateien, um Git-Projekte im Android-Superprojekt zusammenzufassen.
Manifestdatei
Eine Manifestdatei ist eine XML-Datei, die angibt, wo die verschiedenen Git-Projekte in der Android-Quelle innerhalb eines AOSP-Quellbaums platziert werden.

Meet-Hardwareanforderungen

Ihre Entwicklungs-Workstation sollte die folgenden Hardwareanforderungen erfüllen oder übertreffen:

  • Ein 64-Bit-x86-System.

  • Mindestens 400 GB freier Speicherplatz zum Auschecken und Erstellen des Codes (250 GB zum Auschecken + 150 GB zum Erstellen).

  • Mindestens 64 GB RAM. Google verwendet 72-Core-Maschinen mit 64 GB RAM, um Android zu erstellen. Mit dieser Hardwarekonfiguration dauert ein vollständiger Build von Android etwa 40 Minuten und ein inkrementeller Build von Android nur wenige Minuten. Im Gegensatz dazu dauert ein vollständiger Build mit einer 6-Kern-Maschine mit 64 GB RAM etwa 6 Stunden.

Anforderungen an das Betriebssystem erfüllen

Auf Ihrer Entwicklungs-Workstation muss eine 64-Bit-Linux-Distribution mit GNU C Library (glibc) 2.17 oder höher ausgeführt werden.

Erforderliche Pakete installieren

Wenn Sie Android 11 oder höher erstellen möchten, müssen Sie Ubuntu 18.04 oder höher verwenden. Führen Sie den folgenden Befehl aus, um die erforderlichen Pakete für Ubuntu 18.04 oder höher zu installieren:

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

Mit diesem Befehl wird unter anderem Git installiert, das zum Herunterladen der AOSP-Quelle verwendet wird.

Erforderliche Software installieren

Bevor du mit dem AOSP arbeiten kannst, musst du OpenJDK, Make, Python 3 und Repo installieren. Der neueste Release-Zweig von Android enthält vordefinierte Versionen von OpenJDK, Make und Python 3, sodass keine zusätzlichen Installationsschritte erforderlich sind. Im folgenden Abschnitt wird die Installation von Repo erläutert.

Repository installieren

So installieren Sie Repo:

  1. Laden Sie die aktuellen Paketinformationen herunter:

    sudo apt-get update
  2. Führen Sie den folgenden Befehl aus, um den Repo-Launcher zu installieren:

    sudo apt-get install repo

    Der Repo Launcher stellt ein Python-Script bereit, das einen Checkout initialisiert und das vollständige Repo-Tool herunterlädt.

    Wenn das funktioniert, fahre mit Schritt 4 fort.

  3. Optional: Installieren Sie Repo manuell mit den folgenden Befehlen:

    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

    Mit den ersten drei Befehlen wird eine temporäre Datei eingerichtet, Repo in die Datei heruntergeladen und geprüft, ob der bereitgestellte Schlüssel mit dem erforderlichen Schlüssel übereinstimmt. Wenn diese Befehle erfolgreich sind, wird mit dem letzten Befehl der Repo-Launcher installiert.

  4. Prüfen Sie die Version des Repo-Launchers:

    repo version

    In der Ausgabe sollte die Version 2.4 oder höher angezeigt werden, z. B.:

    repo launcher version 2.45
    

Alternatives Ausgabeverzeichnis festlegen

Standardmäßig wird die Ausgabe jedes Builds im Unterverzeichnis out/ des entsprechenden Quellbaums gespeichert. Sie können dieses Verzeichnis überschreiben, indem Sie die Umgebungsvariable OUT_DIR exportieren. Wenn Sie Ihre Ausgabe beispielsweise auf einem anderen Laufwerk speichern möchten, können Sie OUT_DIR auf dieses Laufwerk verweisen:

export OUT_DIR=my_other_drive

Nächste Schritte