Android Studio for Platform (ASfP) ist die empfohlene integrierte Entwicklungsumgebung (IDE) für die Entwicklung von Software-Defined Vehicle (SDV)-Plattformen für Android Automotive OS (AAOS). ASfP unterstützt alle Sprachen, die die AAOS-SDV-Plattform verwendet, einschließlich Rust für SDV-Dienstpakete.
Auf dieser Seite wird nur die SDV-spezifische Einrichtung beschrieben. Weitere Informationen zu allgemeinen ASfP-Funktionen und ‑Workflows finden Sie unter Android Studio for Platform.
ASfP kann nur unter 64-Bit-Linux mit x86-64-CPUs ausgeführt werden. Sie können es auf einer lokalen Linux-Workstation oder in der Cloud verwenden. Weitere Informationen zur Cloud-Einrichtung finden Sie unter Cloud-Entwicklung.
ASfP installieren
ASfP verwendet standardmäßig eine maximale Heap-Größe von 30 GB. Das Indexieren eines Plattform-Checkouts verbraucht viel Arbeitsspeicher, insbesondere wenn Sie auch Cuttlefish-Geräte mit mehreren VMs auf demselben Computer ausführen. Beschränken Sie Ihr Projekt auf die Verzeichnisse, an denen Sie arbeiten, und passen Sie bei Bedarf die maximale Heap-Größe in den ASfP-Speichereinstellungen an.
ASfP unterstützt automatische Updates in der IDE. Weitere Informationen finden Sie unter Android Studio für die Plattform aktualisieren. Weitere Informationen zum Herunterladen und Installieren von ASfP und zum Prüfen der Systemanforderungen finden Sie unter Android Studio for Platform installieren.
SDV-Projekt erstellen
Initialisieren, synchronisieren und erstellen Sie Ihren AAOS-SDV-Checkout, bevor Sie beginnen. Weitere Informationen zum Einrichten der Kasse finden Sie unter Code-Speicherort und Herunterladen, erstellen und ausführen.
So erstellen Sie ein SDV-Projekt:
- Erstellen Sie ein neues Projekt in ASfP und wählen Sie das Stammverzeichnis Ihres AAOS-SDV-Check-outs als Repository-Check-out aus. Weitere Informationen zu den Schritten des Assistenten finden Sie unter Projekt erstellen oder importieren.
- Nachdem ASfP das Projekt erstellt hat, wählen Sie ASfP > Projekt > Konfiguration öffnen aus, um die Datei
.asfp-projectzu öffnen. Ersetzen Sie den Inhalt der Datei durch das folgende Beispiel und legen Sie für
repoden Pfad zu Ihrem Checkout fest:repo: /path/to/sdv_source lunch: sdv_core_cf-aosp_current-userdebug directories: include: - system/software_defined_vehicle/samples other_languages: - rustAktualisieren Sie
lunchunddirectoriesfür den Bereich, an dem Sie arbeiten. Damit die Indexierung und Synchronisierung schnell bleiben, sollten Sie nur die Verzeichnisse einbeziehen, die Sie aktiv ändern. In der folgenden Tabelle sind gängige SDV-Ziele und -Verzeichnisse aufgeführt:Entwicklungsschwerpunkt SDV lunchZieldirectoriesempfohlenSDV-Servicepakete sdv_core_cf-aosp_current-userdebugIhr Service Catalog und Ihr Bundle-Verzeichnis, z. B. system/software_defined_vehicle/samplesIntegration der SDV-Kernplattform sdv_core_cf-aosp_current-userdebugsystem/software_defined_vehicle/middleware,system/software_defined_vehicle/automotive_services,device/google/sdvSDV-Gateway auf SDV-IVI sdv_ivi_cf-aosp_current-userdebugsystem/software_defined_vehicle/sdv_gateway,system/software_defined_vehicle/samples/sdv_gateway,packages/services/CarDisplay Safety on SDV Media sdv_media_har_cf-aosp_current-userdebugpackages/services/display_safety,device/google/sdv_display_safetyDisplay Safety on SDV IVI sdv_ivi_cf_ds-aosp_current-userdebugpackages/apps/Car/DriverUI,packages/services/display_safety/serviceWenn für Ihren Bezahlvorgang ein
trunk_staging-Manifest verwendet wird, ersetzen Sie-aosp_current-userdebugdurch-trunk_staging-userdebug. Wenn Sie auch nativen Plattformcode durchsuchen möchten, fügen Siecppzuother_languageshinzu. Weitere Informationen zu allen Konfigurationsoptionen finden Sie unter Konfigurationsparameter.Wählen Sie ASfP > Synchronisieren > Projekt synchronisieren aus, um die Änderungen zu übernehmen. Weitere Informationen zu Synchronisierungsmodi (vollständige Synchronisierung, teilweise Synchronisierung und Synchronisierung ohne Build) und zum Exportieren oder Importieren von freigebbaren
.asfp-project-Vorlagen für Ihr Team finden Sie unter Synchronisierungsmodi und Soong-Toolfenster und Freigebbare Projektvorlagen (Export und Import).
SDV-Dienst-Bundles bereitstellen
ASfP enthält ein SDV-Plug-in, mit dem ein APEX mit Ihren Dienst-Bundles direkt auf einem laufenden SDV-Gerät bereitgestellt wird. Das Plug-in ist standardmäßig deaktiviert. Wenn Sie es verwenden möchten, aktivieren Sie das SDV-Plug-in unter Einstellungen > Plug-ins. Weitere Informationen zur APEX-Paketerstellung finden Sie unter Dienst-Bundles erstellen und bereitstellen.
Wie du die Bereitstellung vornimmst, hängt davon ab, ob die APEX-Datei bereits auf dem Gerät vorhanden ist:
- Wenn APEX bereits installiert ist, können Sie Ihre Änderungen direkt über ASfP bereitstellen.
- Wenn die APEX-Datei neu ist, musst du zuerst das System-Image neu erstellen und starten oder ein System-Image verwenden, das den Schlüssel enthält, der zum Signieren der APEX-Datei verwendet wurde. Anschließend können Sie die Bereitstellung über ASfP vornehmen.
So stellen Sie ein APEX-Dienst-Bundle bereit:
- Starten Sie Ihr SDV-Gerät mit dem Cuttlefish-Plug-in. Weitere Informationen findest du unter SDV-Geräte auf Cuttlefish ausführen.
- Öffnen Sie die Datei
apex/Android.bpIhres Dienst-Bundles und klicken Sie auf das Symbol Ausführen im Bund neben dem Blockapex {. - Wählen Sie im Menü, das sich öffnet, „Deploy APEX_NAME“ ausführen aus. Sie können die APEX auch erstellen, ohne sie bereitzustellen, oder die Ausführungskonfiguration im selben Menü ändern.
SDV-Geräte auf Cuttlefish ausführen
ASfP enthält ein Cuttlefish-Plug-in, mit dem lokale Cuttlefish-Geräte erstellt und ausgeführt werden können. Das Plug-in benötigt den Cuttlefish-Host-Orchestrator. Wenn der Host-Orchestrator nicht verfügbar ist, zeigt ASfP eine Anleitung zum Einrichten an.
So erstellen Sie ein SDV-Gerät:
- Wählen Sie Tools > Gerätemanager aus, klicken Sie auf + und wählen Sie Cuttlefish-Gerät erstellen aus.
- Wenn Sie eine Einrichtung mit mehreren VMs erstellen möchten, wählen Sie Aus kanonischer Konfiguration aus und erstellen oder importieren Sie eine Konfiguration für Ihre Einrichtung, z. B. SDV Core mit SDV IVI oder SDV Media mit SDV IVI für Display Safety. Wenn Sie eine einzelne VM erstellen möchten, wählen Sie stattdessen Aus lokalem Android-Quellbaum-Checkout aus.
Wenn Sie alle VM-Anzeigen auf einem einzigen Bildschirm sehen und auf zusätzliche Geräteoptionen zugreifen möchten, verwenden Sie das Toolfenster Cuttlefish. Wählen Sie zum Öffnen das Symbol ... in der Seitenleiste und dann Cuttlefish aus oder suchen Sie unter Hilfe > Aktion suchen nach Cuttlefish. Sie können sich auch einzelne Displays unter Running Devices ansehen. Da SDV Core ohne Display ausgeführt wird, verwenden Sie Logcat und das Terminal, um es zu prüfen.
Fehler beheben und testen
ASfP enthält einen integrierten LLDB-Debugger für C++- und Rust-Code. Weitere Informationen zum Debuggen und Testen in ASfP finden Sie unter Plattformcode debuggen, Rust-Code debuggen, Plattformcode mit atest testen und cc_test- und rust_test-Ziele unter LLDB debuggen.
Wenn Sie den Debugger an ein Dienst-Bundle anhängen, hängen Sie ihn an den Prozess an, der es hostet. Prozessnamen haben das Format <bundle_name>:<instance_name>, z. B. OrchestratorSampleRustServiceBundle:sample-main-no-conditions. Mit dem folgenden Befehl werden übereinstimmende Prozesse und ihre Prozess-IDs aufgelistet:
adb shell ps -A | grep <bundle_name>
Weitere Informationen zu SDV-Debugging-Workflows, z. B. zum Herstellen einer Verbindung zu mehreren Geräten und zum Aufrufen von Logs, finden Sie unter SDV debuggen.
VSIDL-Dateien bearbeiten
ASfP enthält den VSIDL-Language-Server (vsidl-lsp). Weitere Informationen zum Einrichten Ihres Katalogs für den Language-Server finden Sie unter Automatische Katalogaktualisierungen und LSP-Integration. Wenn Ihr Katalog eine CATALOG_UPDATE-Datei enthält, bietet der Editor die folgenden Funktionen für .vsidl-Dateien:
- Live-Validierung: Der Editor hebt VSIDL-Schlüsselwörter hervor und zeigt Syntaxfehler, nicht aufgelöste Typen und VSIDLC-Validierungsfehler im Fenster Probleme an. Weitere Informationen zu den Validierungsregeln und ihren Fehlercodes finden Sie in der VSIDL-Sprachspezifikation.
- Automatische Vervollständigung und Dokumentation: Sie können Strg + Leertaste drücken, um Vorschläge für Schlüsselwörter, Nachrichten, Dienste, Themen und Kanäle zu erhalten. Mit Strg + Q können Sie Dokumentationskommentare aufrufen.
- Navigation und Formatierung: Sie können Strg + B drücken, um zu
.vsidl- oder.proto-Definitionen zu gelangen, Alt + Umschalttaste + F7, um Referenzen zu finden, Strg + F12, um die Dateistruktur aufzurufen, und Strg + Alt + L, um die Datei zu formatieren.
SDV-Kontext für KI-Assistenten hinzufügen
ASfP umfasst KI in Android Studio und einen integrierten Agenten mit Soong-Build- und atest-Tools. Da AGENTS.md-Dateien zusammen mit Ihrem Quellcode in der Versionsverwaltung gespeichert werden, können Sie dieselben SDV-Regeln für den integrierten Agenten von ASfP und für Befehlszeilen- oder containerbasierte Coding-Agenten verwenden, die AGENTS.md lesen. Wenn Sie einen Prompt senden, während eine Datei in ASfP geöffnet ist, lädt der Agent AGENTS.md-Dateien aus dem Verzeichnis dieser Datei und den übergeordneten Verzeichnissen (es sei denn, eine GEMINI.md-Datei im selben Verzeichnis hat Vorrang). Sie können aktive Dateien im Chatbereich unter Kontext im Bereich AGENTS.md-Dateien prüfen. Weitere Informationen finden Sie unter Android Studio for Platform und Agent mit AGENTS.md-Dateien anpassen.
Die folgenden Vorlagen bieten Ausgangspunkte für die Workflows unter SDV-Projekt erstellen.
SDV-Dienstpakete
Legen Sie diese AGENTS.md-Datei im Bundle-Verzeichnis in .asfp-project ab, das die Ordner catalog/, services/ und apex/ enthält. Weitere Informationen finden Sie unter Middleware generieren, Dienst-Bundles erstellen und bereitstellen, SOME/IP-Zuordnungsdatei schreiben und Übersicht über die Autorisierung der SDV-Kommunikation.
# AAOS SDV service bundle and VSIDL rules
## Build and test
- Initialize the build environment (`source build/envsetup.sh` and
`lunch sdv_core_cf-aosp_current-userdebug`) when running outside ASfP, build
modules with Soong (`m <module_name>`), and run tests with
`atest <TestModuleName>` (`rust_test`, `rust_test_host`, `cc_test`, or
`python_test_host`), without creating `Cargo.toml` files or running `cargo`
- In catalog `Android.bp` files, avoid `defaults` on `rust_protobuf` modules
(`vsidlc` uses a regex parser), include each `.proto` file in at most one
`rust_protobuf` target, and cover all catalog files in the first `filegroup`
(`srcs: ["**/*"]`)
## Protobuf, VSIDL, and AUTOSAR SOME/IP mapping conventions
- Keep `.proto` files limited to `message`, `enum`, and RPC `service` schemas
(using `sdv/vsidl/v1/annotations.proto` only for field size bounds), without
topic names, channel names, or queue capacities
- Write `.vsidl` files in TextProto `VsidlEntry` syntax (`package: "..."`,
`service_bundle { name: "..." }`, `publisher` or `subscriber` with `message`
and `topic`, and `server` or `client` with `service` and `channel`, without
`import` statements; RPCs support unary, client-streaming, and
server-streaming methods, not bidirectional streaming), and isolate
`some_ip_mapping` (`sdv_type_mapping` and `someip_service_mapping` for
AUTOSAR electronic control unit (ECU) `ARXML` or `vsomeip` IDs) or
`vhal_mapping` rules in dedicated `.vsidl` mapping files so core bundles stay
transport-independent
- Use `PascalCase` for `service_bundle` names (avoiding Rust, C++, and Java
keywords), `snake_case` for `build_cfg.target_name`, a globally unique
lowercase `package` with at least four segments (`com.<org>.sdv.<domain>`;
never reuse platform-reserved `com.android.sdv.*` or sample `com.sdv.*`
names), and lowercase dash-case starting with a letter (no consecutive or
trailing hyphens, underscores, or slashes) for `topic`, `channel`, and
instance names
- Set `capacity` on every `publisher` to an even integer greater than or equal
to 2, and pair every `subscriber` and RPC `client` with a matching
`publisher` or `server` in the catalog or its `-d` dependency catalogs
## Code generation, authorization, and APEX packaging
- Export `ANDROID_BUILD_TOP`, check `CATALOG_UPDATE` for catalog-relative
`output_path` (such as `".."`), `dependency_catalog_paths` (`-d`), and
`vsidlc_gen_args`, and run `vsidlc -c <catalog_dir> -o <output_dir>`; omit
`--services` from `vsidlc_gen_args` and avoid `-p` (`--purge`) or
`regenerator` when `output_path` holds handwritten `services/` code
- Leave generated files in `generated_rs/`, `apex/`, and `configs/` unmodified,
and implement Rust logic in `services/<ServiceBundleName>/src/main.rs` (even
though the initial `vsidlc --services` skeleton header says not to edit; C++
bundles do not use `vsidlc` C++ codegen and instead use
`libsdv_lifecycle_client_cpp`, `libsdv_comms_cpp`, and
`sdv_service_bundle_metadata` with `native_library_path: "lib64/lib<so>.so"`
in `sdv_service_bundles_manifest.textproto`)
- Keep communications authorization `.textproto` policies in `configs/` aligned
with every `publisher`, `subscriber`, `server`, and `client` unit (omitting
`capacity` inside manual authorization `.textproto` `publisher` entries) so
Service Discovery does not reject endpoints at runtime
- In Rust bundles, wait for publisher or RPC server availability before
creating subscribers or clients, stop active tasks in `on_stop`, and run
blocking work in `tokio::spawn_blocking`
- Generate Rust service bundle APEXes with `vsidlc --apex` (`updatable: true`,
`min_sdk_version: "35"`, and `product_specific: true` in `apex/Android.bp`,
never `vendor: true` or `soc_specific: true`, with matching unique `name` and
`version` >= 1 in `apex_manifest.json`), and do not set
`supportsRebootlessUpdate: true` or run `adb install --force-non-staged`
because SDV APEX updates require a reboot
SDV-Gateway auf SDV-IVI
Platziere diese AGENTS.md-Datei im Verzeichnis deines IVI-Clientmoduls oder unter system/software_defined_vehicle/sdv_gateway/. Weitere Informationen finden Sie unter SDV-Gateway auf IVI verwenden.
# AAOS SDV Gateway on SDV IVI rules
- Initialize the build environment (`source build/envsetup.sh` and
`lunch sdv_ivi_cf-aosp_current-userdebug`) when running outside ASfP, build
IVI modules with Soong (`m <module_name>`), and run verification with
`atest <TestModuleName>`
- For native C or C++ IVI clients (including vehicle hardware abstraction layer
(VHAL) integrations), link `libsdvgatewayclient`
(`#include "libsdvgatewayclient.h"`) or `ISdvGateway`; for in-tree system Java
or Kotlin clients, use `libsdvgatewayclient-java`,
`libsdvgatewayclient-java-sdk.stubs`, `libsdvgatewayclient-java-sdk`, and
`com.android.sdv.gateway.client`
- Start the Binder thread pool before calling `ASDVGateway_Client_new`, and
call `ASDVGateway_Client_initComms` (or `SdvGatewayClient.initComms`) before
any service discovery, data tunnel, or RPC calls
- Check `ASDVGateway_Client_isRpcAvailable` or
`ASDVGateway_Client_isProcessBoundToSdvRpcNetworkInterface` before opening
RPC sockets on early boot, treat `ASDVGateway_StatusCode_OK` with null
`ASDVGateway_RpcCredentials_t` as insecure `UNLOCKED` boot mode, and free
non-null credentials with `ASDVGateway_Client_deleteRpcCredentials`
- Grant `sdv_gateway_client_domain(<domain>)` in SELinux (do not add
`binder_use` on `/vendor` daemons, which violates Treble `neverallow`; add
`group inet` on native init services, and `INTERNET` plus
`CONNECTIVITY_USE_RESTRICTED_NETWORKS` privapp permissions for system Java
RPC clients)
Sicherheitshinweise zum Display
Legen Sie diese AGENTS.md-Datei in packages/services/display_safety/ oder im Verzeichnis Ihrer Kombiinstrument-App ab. Weitere Informationen finden Sie unter Erste Schritte mit Display Safety, HAR-Plattformabstraktionsschicht, Toolchain für Sicherheitsdesign und DriverUI.
# AAOS Display Safety partner integration rules
- Display Safety spans two guest VMs with separate `lunch` targets: keep
safety-critical telltales, gauges, camera views, chimes, and early-boot or
fallback placeholders in the Rust high availability renderer (HAR) and safety
monitor on SDV Media (`sdv_media_har_cf`), and build non-safety cluster UI on
SDV IVI (`sdv_ivi_cf_ds`) using `ClusterHomeManager` (`Cluster2` rather than
legacy `Cluster1`)
- Implement target OS and hardware subsystems (display, graphics, exterior view
system (EVS) cameras, audio, user input, and vehicle signals) in a dedicated
`har-platform-<target>` platform abstraction layer (PAL) crate implementing
`har-platform-api` traits rather than modifying core `harry` framework crates,
and verify PAL crates against the HAR platform test suite with `atest`
- Generate safety monitor configurations and telltale inspection artifacts from
the serialized Automotive Design for Compose document and safety JSON mapping
(`{"documents": [{"rootnode": "#...", "display_id": 1, "document_id": "...",`
`"states": {"<signal>": "#<node_id>"}}]}`) using the safety design compiler
rather than hardcoding telltale pixel coordinates
- Because the HAR display plane composites above Android IVI, ensure HAR clears
the cluster viewport region to `alpha = 0.0` while valid `HeartbeatRequest`
gRPC messages arrive from IVI, and set opaque pixels in custom HAR OpenGL ES
surfaces to `alpha = 1.0` (`0xFF`)
- Initialize the build environment (`source build/envsetup.sh` and `lunch`) when
running outside ASfP, integrate prebuilt cluster APKs into `sdv_ivi_cf_ds`
through `DriverUIPrebuilt` (`overrides: ["DriverUIStubApp"]`), launch dual-VM
Cuttlefish setups from ASfP or with `ds_toolkit launch`, pass `--user 0` to
`adb shell am` cluster commands, and note that
`adb shell dumpsys SurfaceFlinger` on SDV IVI inspects only Android layers
rather than the overlying HAR plane