Tworzenie i wdrażanie pakietów usług

Po utworzeniu oprogramowania pośredniczącego i napisaniu kodu niestandardowego możesz wdrożyć pakiety usług jako pliki APEX.

1. Utwórz pliki konfiguracji SDV:

   Rdza

   1. Wygeneruj pliki konfiguracji SDV, uruchamiając:

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

      Uruchomienie vsidlc z flagą --apex automatycznie generuje wszystkie niezbędne pliki konfiguracji, w tym:

      • manifest APEX (apex_manifest.json),
      • manifest metadanych SDV (sdv_service_bundles_manifest.textproto),
      • konfigurację linkera (linker.config.json),
      • konteksty plików SELinux (file_contexts),
      • klucze publiczne i prywatne (.avbpubkey i .pem),
      • deklaracje uprawnień i konfiguracje orkiestracji,
      • plik Android.bp określający wszystkie niezbędne moduły Soong.

      Wygenerowane konfiguracje znajdziesz w tych lokalizacjach:

      /path/to/output/apex/
      

      i

      /path/to/output/configs/
      

   C++

   1. Utwórz plik manifestu metadanych SDV, service_bundle.manifest.textproto z tymi podstawowymi polami metadanych wykonania:

      • nazwa usługi zgodna z konwencjami nazewnictwa
      • reprezentacja wersji pakietu usług w postaci liczby całkowitej i ciągu znaków,
      • ścieżka do utworzonej wcześniej biblioteki.

      Przygotowanie podstawowych metadanych pakietu usług jest obowiązkowe w przypadku pakowania i wdrażania pakietu usług.

      # proto-file: //system/software_defined_vehicle/core_services/service_bundles_registry/proto/sdv_service_bundles_manifest.proto
      # proto-message: SdvServiceBundleManifestEntry
      
      # SDV service bundle metadata definition with mandatory fields.
      sdv_service_bundle_metadata {
        # Service bundle name.
        name: "ServiceBundleName"
        # Service bundle integer version.
        version_number: 42
        # Service bundle version as a string.
        version_name: "42.alpha"
        # Service bundle library path.
        native_library_path: "lib64/libservice_bundle.so"
      }
      

   2. Utwórz nowy plik konfiguracji linkera, linker.config.json:

      { "visible": true }
      

   3. Utwórz nowy plik apex_manifest.json z tymi polami:

      • unikalna nazwa pakietu SDV,
      • wersja APEX,
      • zależność od bibliotek SDV Comms.

      {
        "name": "com.sdv.oem.apex_and_module_name",
        "version": 1,
        "requireNativeLibs": [
            "libsdv_comms_ctx_ffi.so",
            "libsdv_comms_dt_ffi.so",
            "libsdv_comms_id_ffi.so",
            "libsdv_comms_sd_ffi.so"
        ]
      }
      

   4. Utwórz klucz publiczny, apex_name.apex_key.avbpubkey i klucz prywatny, apex_name.apex_key.pem.

   5. Utwórz nowy kontekst pliku SELinux apex_file_contexts.

      (/.*)?    u:object_r:system_file:s0
      

      Więcej informacji znajdziesz w artykule Kontekst i kategorie zabezpieczeń.

   6. Utwórz wstępnie skompilowane cele w nowym lub istniejącym Android.bp pliku:

      // SDV manifest file prebuilt.
      prebuilt_etc {
          name: "com.sdv.oem.apex_and_module_name.service_bundles_manifest",
          // The source filename of the manifest file.
          src: "service_bundle.manifest.textproto",
          // The name of the installed file needs be `sdv_service_bundles_manifest.textproto`.
          filename: "sdv_service_bundles_manifest.textproto",
          // Disable direct installation of the prebuilt to one of the partitions.
          // The manifest is used only inside of an apex.
          installable: false,
      }
      // The linker config to allow libraries for the apex to be linkable.
      linker_config {
          name: "com.sdv.oem.apex_and_module_name. linker_config",
          src: "linker.config.json",
          // Disable direct installation of the prebuilt to one of the partitions.
          // The linker configuration is used only inside of an apex.
          installable: false,
      }
      // Key to be used for signing the apex.
      apex_key {
          name: "apex_name.apex_key",
          public_key: "apex_name.apex_key.avbpubkey",
          private_key: "apex_name.apex_key.pem",
      }
      

   7. Utwórz nowy moduł APEX w nowym lub istniejącym Android.bp pliku. Użyj nazwy pakietu SDV jako nazwy modułu APEX.

      apex {
          name: "com.sdv.oem.apex_and_module_name",
          // The service bundle(s) to be included in the apex.
          native_shared_libs: [
              "libservice_bundle",
          ],
          prebuilts: [
              // SDV service bundles manifest file.
              "com.sdv.oem.apex_and_module_name.service_bundles_manifest",
              // Linker configuration to enable loading library from apex.
              "com.sdv.oem.apex_and_module_name.linker_config",
          ],
          // Json manifest file describes metadata of the APEX package.
          // The 'name' field from the JSON is used as a mounting point.
          manifest: "apex_manifest.json",
          // Setting the security contexts to files in this APEX bundle.
          file_contexts: "apex_file_contexts",
          // Name of the apex_key module that provides the private key to sign the APEX bundle.
          key: "apex_name.apex_key",
          // Mark apex as non-updatable for now, this might be revisited going forward.
          updatable: false,
          // Service bundle package is installed into /product partition.
          product_specific: true,
      }
      

2. Aby uwzględnić nowy plik makefile w obrazie SDV, dodaj nowy moduł APEX do PRODUCT_PACKAGES w pliku makefile produktu. Na przykład zobacz sdv_samples_core_services.mk.

3. Jeśli używasz Cuttlefish, uruchom to polecenie, aby uruchomić urządzenie:

   sdv-cf create --instance_name=instance1
   

4. Uruchom pakiet usług po uruchomieniu systemu:

   # Grant root access.
   adb root
   # Launch the new service bundle.
   adb shell sdv_service_bundle start \
     local-vm:com.sdv.oem.apex_and_module_name.ServiceBundleName/instance-1
   

Zarządzanie zależnościami pakietu usług

W niektórych przypadkach możesz użyć statycznego łączenia zależności pakietu usług, aby zmniejszyć rozmiar APEX i wykorzystanie pamięci pakietu usług oraz skrócić czas uruchamiania pakietów usług. Te scenariusze obejmują APEX z:

• pojedynczymi pakietami usług,
• kilkoma pakietami usług, które nie mają wielu wspólnych zależności.

Aby włączyć statyczne łączenie, dodaj te właściwości do definicji biblioteki pakietu usług:

// Service bundle library.
rust_ffi_shared {
  // See rust_ffi_shared basic template.
  ...
  // uses static linking for the dependencies
  prefer_rlib: true,
  // needed to correctly resolve commstack deps
  ld_flags: ["-Wl,--no-as-needed"],
}

W każdym przypadku zalecamy sprawdzenie, czy statyczne łączenie z zależnościami prowadzi do zmniejszenia wykorzystania pamięci przez pakiety usług i skrócenia czasu ich uruchamiania.

Debugowanie (dumpsys)

Menedżer cyklu życia implementuje interfejs dumpsys. Ten interfejs wyświetla użytkownikowi listę pakietów usług, które są w stanie created lub started. Interfejs wyświetla też FQIN lub UID procesu pakietu usług.

Aby wyświetlić bieżący stan i identyfikatory pakietów usług, wykonaj to polecenie:

# Grant root access.
adb root

# Execute dumpsys to see service bundles state
adb shell dumpsys google.sdv.lifecycle.ILifecycleManager/default

Co dalej?

Aby automatycznie wykonywać vsidlc i umożliwić wtyczce IDE pracę z zależnościami, zapoznaj się z artykułem Automatyczne aktualizacje katalogu i integracja z LSP.