Auf dieser Seite wird beschrieben, wie Sie ein SDV-Dienst-Bundle erstellen, es im APEX-Dateiformat verpacken und auf einem virtuellen Cuttlefish-Gerät ausführen. Die primären Einheiten der Codeausführung auf dem SDV-System sind die Dienst-Bundles. Dienst-Bundles bieten Lebenszyklusmethoden, die das System ausführt, wenn sich der Systemstatus ändert.
Build-Umgebung einrichten
Führen Sie in Ihrem Arbeitsverzeichnis das Skript
envsetup.shaus, um Ihre Build-Umgebung einzurichten, Cuttlefish als Build-Ziel festzulegen und den Codegeneratorvsidlczu erstellen:source build/envsetup.sh lunch sdv_core_cf-aosp_current-userdebug m vsidlcDefinieren Sie Ihre Architektur, indem Sie einen Ordner mit dem Namen
my_catalogmit den folgenden Dateien erstellen:tire.proto: Definiert die Datenstruktur, die Sie senden:syntax = "proto3"; package com.android.sdv.sample.quickstart; import "google/protobuf/empty.proto"; import "sdv/vsidl/v1/annotations.proto"; message TirePressure { uint32 pressure = 1; } message TireInfoResponse { string serial_number = 1; uint32 max_pressure = 2; } service TireService { rpc GetTireInfo(google.protobuf.Empty) returns (TireInfoResponse); }architecture.vsidl: Definiert die Dienst-Bundles und ihre Kommunikation (Informationen zur Syntaxhervorhebung, Validierung und automatischen Vervollständigung in Android Studio for Platform finden Sie unter VSIDL-Dateien bearbeiten):package: "com.android.sdv.sample.quickstart" service_bundle { name: "Manager" publisher { message: "TirePressure" topic: "pressure" capacity: 8 } server { service: "TireService" channel: "tire-service" } } service_bundle { name: "Monitor" subscriber { message: "TirePressure" topic: "pressure" } client { service: "TireService" channel: "tire-service" } }Android.bp: Definiert den Build-Prozess:rust_protobuf { name: "libquickstart_sample_tire_proto", crate_name: "quickstart_sample_tire_proto", protos: [ "tire.proto", ], source_stem: "quickstart_sample_tire_proto_source", rustlibs: [ "libvsidl_v1_stdlib_proto_rs", ], proto_flags: [ "-I external/protobuf/src", ], vendor_available: true, product_available: true, apex_available: [ "//apex_available:platform", "//apex_available:anyapex", ], min_sdk_version: "35", } filegroup { name: "vsidl_quickstart_catalog", srcs: ["**/*"], }
Generieren Sie eine Skelettimplementierung und Konfigurationsdateien, indem Sie Folgendes ausführen:
vsidlc -c /path/to/catalog -o /path/to/output --services --apexDie Rust-Implementierung für jedes Dienst-Bundle finden Sie in
/path/to/output/services/ServiceBundleName/src/main.rs.Standardmäßig werden bei der generierten Implementierung Nachrichten mit Standardwerten erstellt und zwischen Publishern und Abonnenten oder RPC-Clients und -Servern gesendet. Wenn Sie dieses Verhalten ändern möchten, suchen Sie in
main.rsnach denTODO-Kommentaren und passen Sie sie an Ihre Anforderungen an. Beispiel:rust async fn handle_tire_pressure_pressure_publisher(publisher: sdv::mw::Publisher<TirePressure>) { loop { // TODO: Modify the frequency of publishing messages here. sleep(Duration::from_secs(1)).await; // TODO: Modify the message content here. let message = TirePressure::default(); info!("Publishing on TirePressure#PRESSURE"); publisher.publish(&message).unwrap(); } }Wenn Sie Ihr Bundle in das System-Image aufnehmen möchten, fügen Sie den generierten APEX-Modulnamen Ihrem Produkt-Makefile hinzu.
Öffne das Makefile deines Produkts (z. B.
device/google/sdv/sdv_core_base/sdv_samples_core_services.mk).Fügen Sie das Modul zu
PRODUCT_PACKAGEShinzu:PRODUCT_PACKAGES += com.android.sdv.sample.quickstart PRODUCT_PACKAGES += com_android_sdv_sample_quickstart_orchestration_configurations
Erstellen Sie das Image:
mNachdem das System-Image die APEX-Datei (oder den zum Signieren verwendeten Schlüssel) enthält, können Sie iterative Änderungen auch direkt über das
apex/Android.bp-Symbol in der Seitenleiste in Android Studio for Platform erstellen und bereitstellen. Weitere Informationen finden Sie unter SDV-Dienst-Bundles bereitstellen.Führen Sie das Dienst-Bundle aus und prüfen Sie die Ausführung:
Starten Sie ein virtuelles Cuttlefish-Gerät:
sdv-cf create --instance_name=instance1Führen Sie das Dienst-Bundle aus, wenn das System gestartet wird:
Manuell:
adb wait-for-device adb root adb shell sdv_service_bundle start local-vm:com.android.sdv.sample.quickstart.Manager/instance adb shell sdv_service_bundle start local-vm:com.android.sdv.sample.quickstart.Monitor/instanceMit dem Orchestrator:
adb wait-for-device adb root # Apply global orchestration configuration by setting system property adb shell setprop persist.sdv.orchestrator_config_path "etc/orch/vm_quickstart_orch_config.textproto" adb reboot
Prüfen Sie die Ausführung des Dienst-Bundles:
adb logcat *:F com_android_sdv_sample_quickstart_Manager_instance:* com_android_sdv_sample_quickstart_Monitor_instance:*Mit diesem Befehl werden Logs angezeigt, die den Nachrichtenaustausch der Dienst-Bundles zeigen:
03-30 13:41:31.505 967 976 I com_android_sdv_sample_quickstart_Manager_instance: sdv_lm_manager: Publishing on TirePressure#PRESSURE 03-30 13:41:31.505 983 991 I com_android_sdv_sample_quickstart_Monitor_instance: sdv_lm_monitor: Received message on TirePressure#PRESSURE: [TirePressure { pressure: 0, special_fields: SpecialFields { unknown_fields: UnknownFields { fields: None }, cached_size: CachedSize { size: 0 } } }] 03-30 13:41:31.626 983 991 I com_android_sdv_sample_quickstart_Monitor_instance: sdv_lm_monitor: Sending request on Monitor/TireService 03-30 13:41:31.627 967 976 I com_android_sdv_sample_quickstart_Manager_instance: sdv_lm_manager: Received request on Manager/TireService: Empty { special_fields: SpecialFields { unknown_fields: UnknownFields { fields: None }, cached_size: CachedSize { size: 0 } } } 03-30 13:41:31.627 983 991 I com_android_sdv_sample_quickstart_Monitor_instance: sdv_lm_monitor: Received response on Monitor/TireService: TireInfoResponse { serial_number: "", max_pressure: 0, special_fields: SpecialFields { unknown_fields: UnknownFields { fields: None }, cached_size: CachedSize { size: 0 } } }
Nächste Schritte
Weitere Informationen zur Vehicle Services Interface Definition Language (VSIDL) und dazu, wie Sie eigene Dienstpakete von Grund auf definieren.