ビジネス ロジックの実装

1. VSIDL カタログ ディレクトリに必要なビルド、protobuf、VSIDL ファイルがあることを確認します。既存のサンプルから始める場合は、/system/software_defined_vehicle/samples/vsidl/stable/catalog に有効なカタログ フォルダの例があります。

   カタログ構造の例:

   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. ビジネス ロジックを実装するカスタムコードを記述します。

   • RPC サーバー: lib.rs からトレイトを実装します。

   • パブリッシュ / サブスクライブと RPC クライアント: service_bundle.rs 内で生成された関数を呼び出して、他のサービスとやり取りします。

   Rust

   1. 次のコマンドを実行して、スケルトン実装を生成します。

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

      --services フラグを指定して vsidlc を実行すると、各サービス バンドルのボイラープレート Rust 実装が生成されます。これにより、ソースコード（main.rs）やすべての依存関係を含むビルド構成ファイル（Android.bp）などの必要なスキャフォールディングが提供され、コア ビジネス ロジックの実装に集中しながら、デフォルト メッセージをすぐに交換できます。

   2. 各サービス バンドルについて、Rust 実装は次の場所にあります。

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

   3. デフォルトでは、生成された実装はデフォルト値でメッセージを作成し、パブリッシャーとサブスクライバーの間、または RPC クライアントとサーバーの間でメッセージを送信します。この動作を変更するには、main.rs で TODO コメントを見つけて、好みに合わせて調整します。次に例を示します。

      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. 生成されたファイルに対する変更が次回 vsidlc の実行時に上書きされないようにするには、services フォルダを /path/to/output フォルダの外に移動します。

   C++

   1. サービス バンドルのクラスを含む新しいヘッダー ファイル src/lib.hpp を作成します。

      #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. クラス実装を含む新しいソースファイル src/lib.cpp を作成します。

      #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. 新しい Android.bp ファイルまたは既存の Android.bp ファイルに、サービス バンドル ライブラリの Soong ターゲットを作成します。

      // 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,
      }
      

次のステップ

サービス バンドルをデプロイするには、サービス バンドルをビルドしてデプロイするをご覧ください。