서비스 번들 빌드 및 배포

미들웨어를 만들고 맞춤 코드를 작성한 후 서비스 번들을 APEX 파일로 배포할 수 있습니다.

  1. SDV 구성 파일 만들기:

    Rust

    1. 다음을 실행하여 SDV 구성 파일을 생성합니다.

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

      --apex 플래그로 vsidlc를 실행하면 다음을 비롯한 모든 필수 구성 파일이 자동으로 생성됩니다.

      • APEX 매니페스트 (apex_manifest.json)
      • SDV 메타데이터 매니페스트 (sdv_service_bundles_manifest.textproto)
      • 링커 구성 (linker.config.json)
      • SELinux 파일 컨텍스트 (file_contexts)
      • 공개 키와 비공개 키 (.avbpubkey 및 .pem)
      • 권한 선언 및 오케스트레이션 구성
      • 모든 필수 Soong 모듈을 정의하는 Android.bp 파일

      생성된 구성은 다음에서 확인할 수 있습니다.

      /path/to/output/apex/

      그리고

      /path/to/output/configs/

    C++

    1. 다음 필수 실행 메타데이터 필드를 사용하여 SDV 메타데이터 매니페스트 파일 service_bundle.manifest.textproto 을 만듭니다.

      서비스 번들 패키징 및 배포를 위해서는 필수 서비스 번들 메타데이터를 준비해야 합니다.

      # 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. 새 링커 구성 파일 linker.config.json을 만듭니다.

      { "visible": true }

    3. 다음 필드를 사용하여 새 apex_manifest.json 파일을 만듭니다.

      • SDV 이름 지정 규칙에 따른 고유한 SDV 패키지 이름
      • APEX 버전
      • 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. 공개 키 apex_name.apex_key.avbpubkey 와 비공개 키 apex_name.apex_key.pem를 만듭니다.

    5. 새 SELinux 파일 컨텍스트 apex_file_contexts를 만듭니다.

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

      자세한 내용은 보안 컨텍스트 및 카테고리를 참고하세요.

    6. 새 Android.bp 파일 또는 기존 Android.bp 파일에서 사전 빌드된 대상을 만듭니다.

      // 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. 새 Android.bp 파일 또는 기존 Android.bp 파일에서 새 APEX 모듈을 만듭니다. SDV 패키지 이름을 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. SDV 이미지에 새 makefile을 포함하려면 PRODUCT_PACKAGES에 새 APEX 모듈을 제품 makefile에 추가합니다. 예를 들어 sdv_samples_core_services.mk를 참고하세요.

  3. Cuttlefish를 사용하는 경우 다음 명령어를 실행하여 기기를 시작합니다.

    sdv-cf create --instance_name=instance1

  4. 시스템이 부팅될 때 서비스 번들을 실행합니다.

    # 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

서비스 번들 종속 항목 관리

일부 시나리오에서는 서비스 번들 종속 항목의 정적 연결을 사용하여 APEX 크기 및 서비스 번들 메모리 사용 공간을 줄이고 서비스 번들의 시작 시간을 개선할 수 있습니다. 이러한 시나리오에는 다음이 포함된 APEX가 포함됩니다.

  • 단일 서비스 번들
  • 많은 공통 종속 항목을 공유하지 않는 여러 서비스 번들

정적 연결을 사용 설정하려면 서비스 번들 라이브러리 정의에 다음 속성을 추가합니다.

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

각 상황에서 종속 항목에 대한 정적 연결이 서비스 번들의 메모리 사용 공간 및 시작 시간을 개선하는지 확인하는 것이 좋습니다.

디버그 (dumpsys)

수명 주기 관리자는 dumpsys 인터페이스를 구현합니다. 이 인터페이스는 created 또는 started 상태에 있는 서비스 번들 목록을 사용자에게 표시합니다. 또한 서비스 번들 프로세스의 FQIN 또는 UID도 표시합니다.

서비스 번들의 현재 상태와 식별자를 보려면 다음을 실행합니다.

# Grant root access.
adb root

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

다음 단계

vsidlc를 자동으로 실행하고 IDE 플러그인이 종속 항목과 함께 작동하도록 하려면 자동 카탈로그 업데이트 및 LSP 통합을 참고하세요.