2026년부터 트렁크 안정 개발 모델과 일치하고 생태계의 플랫폼 안정성을 보장하기 위해 2분기와 4분기에 AOSP에 소스 코드를 게시합니다. AOSP를 빌드하고 기여하려면 android-latest-release를 사용하세요. android-latest-release 매니페스트 브랜치는 항상 AOSP에 푸시된 최신 버전을 참조합니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

메시지 및 RPC 서비스 정의

VSIDLC의 유형 시스템은 Protobuf와 VSIDL이라는 두 가지 수준에서 작동합니다. Protobuf는 VSIDL로 정의된 게시자와 구독자 간에 교환되는 메시지를 정의하는 데 사용됩니다. VSIDL은 protobuf로 선언된 유형을 참조합니다.

이 페이지에서는 요청을 호출하고 응답하기 위한 메시지와 리모트 프러시저 콜 (RPC) 메서드를 정의하는 방법을 설명합니다.

메시지 정의

이 섹션에서는 VSIDL 및 protobuf에서 메시지가 정의되는 방식을 설명합니다.

다음 코드 샘플은 TirePressure 메시지를 정의합니다.

syntax = "proto3";

package com.android.sdv.sample.vsidl;

message TirePressure {
  uint32 pressure = 1;
}

RPC 서비스 정의

protobuf에서 RPC 서비스는 로컬 함수 호출인 것처럼 원격으로 호출할 수 있는 메서드 집합을 정의합니다. 다음 예에서는 요청을 하고 응답을 수신하는 데 사용되는 요청 및 응답 메시지 유형과 RPC 서비스 메서드를 정의합니다.

syntax = "proto3";

package com.google.sdv;

enum SeatHeatingLevel {
  OFF = 0;
  LOW = 1;
  HIGH = 2;
}

// Request to set seat heating
message SetSeatHeatingRequest {
  enum Seat {
    DRIVER = 0;
    PASSENGER = 1;
  }
  Seat seat = 1;
  SeatHeatingLevel level = 2;
}

// Response to setting seat heating
message SetSeatHeatingResponse {
  bool success = 1;
}

// Seat heating service
service SeatHeatingService {
  rpc SetSeatHeating (SetSeatHeatingRequest) returns (SetSeatHeatingResponse);
}

각 항목의 의미는 다음과 같습니다.

service는 관련 RPC 메서드의 컬렉션을 식별합니다.
rpc은 입력 및 출력 메시지 유형(각각 SetSeatHeatingRequest 및 SetSeatHeatingResponse)이 있는 단일 RPC 메서드를 식별합니다.

빌드 시스템 통합 구성

vsidlc가 프로토콜 버퍼 정의를 검색하고 Android 빌드 시스템이 이를 컴파일하도록 하려면 카탈로그 디렉터리의 최상위 폴더에 Android.bp 파일을 포함해야 합니다.

이 파일은 protobuf 파일(.proto 확장자 사용)을 그룹화하는 rust_protobuf 타겟을 정의해야 합니다. 카탈로그의 모든 파일은 파일 그룹에 포함되어야 합니다. Android.bp 파일에 파일 그룹이 여러 개 있는 경우 vsidlc은 첫 번째 파일 그룹을 사용합니다.

다음 예시는 VSIDL 카탈로그의 일반적인 rust_protobuf 타겟을 보여줍니다.

  rust_protobuf {
      name: "liboem_vehicle_messages",
      crate_name: "oem_vehicle_messages",
      source_stem: "oem_vehicle_messages_source",
      protos: [
          "**/*.proto",
      ],
      rustlibs: [
          "libvsidl_v1_proto_rs",
      ],
      proto_flags: [
          "-I external/protobuf/src",
      ],
      apex_available: [
          "//apex_available:platform",
          "//apex_available:anyapex",
      ],
      vendor_available: true,
      product_available: true,
      min_sdk_version: "35",
  }

  filegroup {
      name: "catalog_oem_vehicle_messages",
      srcs: ["**/*"],
  }