Geschäftslogik implementieren

  1. Prüfen Sie, ob Ihr VSIDL-Katalogverzeichnis die erforderlichen Build-, Protobuf- und VSIDL-Dateien enthält. Wenn Sie mit einem vorhandenen Beispiel beginnen möchten, finden Sie unter /system/software_defined_vehicle/samples/vsidl/stable/catalog ein Beispiel für einen gültigen Katalogordner.

    Beispiel für Katalogstruktur:

    my_catalog/
├── Android.bp          # Defines rust_protobuf modules for .proto files
├── types.proto         # Protobuf message / RPC service definitions
└── architecture.vsidl  # VSIDL service bundle definitions

  2. Benutzerdefinierten Code schreiben, um Ihre Geschäftslogik zu implementieren:

    • RPC-Server: Implementieren Sie die Traits aus lib.rs.

    • Publish-and-Subscribe- und RPC-Clients: Rufen Sie die generierten Funktionen in service_bundle.rs auf, um mit anderen Diensten zu interagieren.

    Rost

    1. Generieren Sie mit folgendem Befehl eine Skelettimplementierung:

      vsidlc -c /path/to/catalog -o /path/to/output --services

      Wenn Sie vsidlc mit dem Flag --services ausführen, wird eine Boilerplate-Rust-Implementierung für jedes Dienstpaket generiert. Dadurch wird das erforderliche Gerüst bereitgestellt, einschließlich des Quellcodes (main.rs) und einer Build-Konfigurationsdatei (Android.bp) mit allen Abhängigkeiten. So können Sie sofort Standardnachrichten austauschen, während Sie sich auf die Implementierung der wichtigsten Geschäftslogik konzentrieren.

    2. Die Rust-Implementierung für jedes Dienst-Bundle finden Sie unter:

      /path/to/output/services/ServiceBundleName/src/main.rs.

    3. Standardmäßig werden in 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 die TODOKommentare in main.rs und passen Sie sie nach Bedarf an. Beispiel:

      async fn handle_tire_pressure_range_unique_publisher(
    publisher: sdv::mw::Publisher<TirePressureRange>,
) {
    loop {
        // TODO: Modify the frequency of publishing messages here.
        sleep(Duration::from_secs(1)).await;
        // TODO: Modify the message content here.
        let message = TirePressureRange::default();
        info!("Publishing on TirePressureRange#UNIQUE");
        publisher.publish(&message).unwrap();
    }
}

    4. Damit Ihre Änderungen an den generierten Dateien beim nächsten Ausführen von vsidlc nicht überschrieben werden, verschieben Sie den Ordner services aus dem Ordner /path/to/output.

    C++

    1. Erstellen Sie eine neue Headerdatei, src/lib.hpp, mit einer Klasse für Ihr Service-Bundle:

      #pragma once
#include <sdv/service_bundle.h>
#include <sdv/context.hpp>

namespace com::sdv::oem::service_bundle {

// Sample implementation of the service bundle interface.
class ServiceBundleName : public android::sdv::service_bundle::ServiceBundle {
public:
    ServiceBundleName(sdv_comms::ctx::Context context);
    ~ServiceBundleName();
    void onStart() override;
    void onStop() override;
};
}  // namespace com::sdv::oem::service_bundle

    2. Erstellen Sie eine neue Quelldatei, src/lib.cpp, mit der Klassenimplementierung:

      #include "src/lib.hpp"
#include <sdv/sb_macro.h>
#include <iostream>
using com::sdv::oem::service_bundle::ServiceBundleName;

// Register the new service bundle.
REGISTER_SERVICE_BUNDLE(ServiceBundleName);

// Sample implementation of the service bundle interface.
namespace com::sdv::oem::service_bundle {
// Creates a new instance of the ServiceBundleName.
// Called when service bundle is created by the system.
// Context object is provided as a parameter that gives access to the
// communication stack APIs.
ServiceBundleName::ServiceBundleName([[maybe_unused]] sdv_comms::ctx::Context context) :
  ServiceBundle(context) {
    // Memory allocations and static data loading should be done as
    // part of this method.
    //
    // Loading of the dynamic resources (sockets, files, etc)
    // is strongly discouraged due to possible Suspend-to-RAM scenario.
    //
    // The dynamic data can be loaded in the onStart method.
}

// Called when the service bundle is started by the system.
void ServiceBundleName::onStart() {
    // Dynamic resources(sockets, files, etc) should be allocated during this call.
}

// Called when the service bundle is stopped by the system in preparation
// for shutdown or suspend to RAM/Disc.
void ServiceBundleName::onStop() {
    // Stop phase requires the service bundle to delete the dynamic resources
    // (sockets, files, etc) that were previously allocated in the onStart method.
}

// Called when the service bundle is destroyed by the system.
ServiceBundleName::~ServiceBundleName() {
    // Static resources deallocation needs to be implemented in the destructor.
}
}  // namespace com::sdv::oem::service_bundle

    3. Erstellen Sie ein neues oder vorhandenes Android.bp-Soong-Ziel für die Dienstpaketbibliothek:

      // Service bundle library.
cc_library_shared {
  name: "libservice_bundle",
  srcs: ["src/lib.cpp",],
  // Allows the library to be available inside APEX.
  apex_available: [
      "//apex_available:platform",
      "//apex_available:anyapex",
  ],
  shared_libs: [
    // Service Bundle lifecycle C++ API.
    "libsdv_lifecycle_client_cpp",
    // commstack library that provides context object reference
    "libsdv_comms_cpp",
  ],

  // Service bundle package is packed into /product apexes.
  product_specific: true,
}

Nächste Schritte

Informationen zum Bereitstellen von Dienstbündeln finden Sie unter Dienstbündel erstellen und bereitstellen.