Android Studio for Platform (ASfP) unterstützt Sie beim Einrichten Ihrer Entwicklungsumgebung für das Open-Source-Projekt für Android (AOSP). ASfP basiert auf dem IntelliJ-Arbeitsbereichmodell und unterstützt sowohl die manuelle Konfiguration als auch freigabefähige Teamvorlagen.
Einrichtungsassistenten für Projekte starten
Sie haben zwei Möglichkeiten, den Einrichtungsassistenten für Projekte zu starten:
- Über den Begrüßungsbildschirm: Klicken Sie auf Neues Projekt oder ASfP-Projekt importieren.
- Über ein geöffnetes Projekt: Wählen Sie im Hauptmenü ASfP > Projekt > Neues Projekt oder ASfP-Projekt importieren aus.
Aus Vorlage importieren
Wenn Ihr Team eine Standardkonfigurationsdatei für .asfp-project verwendet, können Sie Ihren Arbeitsbereich direkt aus dieser Vorlage initialisieren:
- Wählen Sie im Einrichtungsassistenten für Projekte die Option Aus Vorlage importieren aus.
- Suchen Sie nach der freigegebenen
.asfp-project- oder.asfp-template-YAML-Datei und wählen Sie sie aus. - Nachdem der Assistent die Projekteinstellungen aus der Vorlage übernommen hat, überprüfen Sie den lokalen Pfad für Repo-Checkout und klicken Sie dann auf Fertigstellen.
Manuell konfigurieren
So erstellen Sie eine neue Projektkonfiguration:
Wählen Sie im Einrichtungsassistenten für Projekte aus, dass das Projekt manuell konfiguriert werden soll, und geben Sie die Projektdetails ein:
- Repo-Checkout (Modulpfade): Geben Sie den absoluten Pfad zum Stammverzeichnis Ihres lokalen AOSP-Quellcode-Checkouts an, z. B.
/path/to/aosp. - Mittagsziel: Geben Sie das Mittagsziel ein, das Sie für den Build verwenden (z. B.
aosp_cf_x86_64_phone-aosp_current-userdebug). - Projektname: Geben Sie Ihrem Projekt einen aussagekräftigen Namen.
- Verzeichnisse und Module: Hier werden die ersten Verzeichnisse oder Soong-Module aufgeführt, die in Ihr Projekt aufgenommen werden sollen (relativ zum Repository-Stammverzeichnis, z. B.
frameworks/baseoderpackages/apps/Settings). - Sprachen: Wenn Ihr Workflow C-, C++- oder Rust-Plattformcode enthält, wählen Sie C oder C++ oder Rust aus. Java, Kotlin und
Android.bpsind standardmäßig enthalten. - Umgebungsvariablen und Build-Optionen: Fügen Sie im Assistenten im Feld Umgebungsvariablen benutzerdefinierte Umgebungsvariablen wie
SOONG_ALLOW_MISSING_DEPENDENCIES=truehinzu und aktivieren Sie optional das Kästchen Soong Partial Compile (SOONG_PARTIAL_COMPILE) für schnellere inkrementelle Builds.
- Repo-Checkout (Modulpfade): Geben Sie den absoluten Pfad zum Stammverzeichnis Ihres lokalen AOSP-Quellcode-Checkouts an, z. B.
Klicken Sie auf Fertig. ASfP erstellt die Projektstruktur, generiert die
.asfp-project-Konfigurationsdatei im Stammverzeichnis des Projekts und führt die erste Synchronisierung aus.
Projektkonfiguration freigeben oder anpassen
Nach der Ersteinrichtung können Sie Ihr Projekt jederzeit anpassen, indem Sie die Datei .asfp-project bearbeiten (ASfP > Projekt > Konfiguration öffnen):
- Verzeichnisse und Soong-Module hinzufügen oder ausschließen
- Zusätzliche Sprachen aktivieren (
cpp,rust). - Benutzerdefinierte Soong-Flags und Umgebungsvariablen konfigurieren
Wenn Sie Ihre Konfiguration für Teammitglieder exportieren möchten, rechtsklicken Sie auf den Tab .asfp-project und wählen Sie Als Vorlage exportieren aus.
Weitere Informationen zu .asfp-project-Parametern, Synchronisierungsmodi und Android.bp-Aktionen im Editor finden Sie unter Projekte – Übersicht und Soong-Workflows.