Kể từ năm 2026, để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4. Để tạo và đóng góp cho AOSP, bạn nên sử dụng android-latest-release thay vì aosp-main. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Xác định thông báo và dịch vụ RPC

Hệ thống loại của VSIDLC hoạt động ở 2 cấp độ: Protobuf và VSIDL. Protobuf được dùng để xác định các thông báo được trao đổi giữa nhà xuất bản và người đăng ký do VSIDL xác định. VSIDL tham chiếu các loại do protobuf khai báo.

Trang này giải thích cách xác định các thông báo và phương thức lệnh gọi quy trình từ xa (RPC) để gọi và phản hồi các yêu cầu.

Xác định thông báo

Phần này giải thích cách xác định thông báo trong VSIDL và protobuf.

Mã mẫu sau đây xác định một thông báo TirePressure:

syntax = "proto3";

package com.android.sdv.sample.vsidl;

message TirePressure {
  uint32 pressure = 1;
}

Xác định các dịch vụ RPC

Trong protobuf, một dịch vụ RPC xác định một tập hợp các phương thức có thể được gọi từ xa như thể chúng là các lệnh gọi hàm cục bộ. Ví dụ sau đây xác định các loại thông báo yêu cầu và phản hồi cũng như phương thức dịch vụ RPC dùng để đưa ra yêu cầu và nhận phản hồi:

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);
}

Trong trường hợp:

service xác định một tập hợp các phương thức RPC có liên quan.
rpc xác định một phương thức RPC duy nhất có các loại thông báo đầu vào và đầu ra (lần lượt là SetSeatHeatingRequest và SetSeatHeatingResponse).

Định cấu hình quy trình tích hợp hệ thống xây dựng

Để cho phép vsidlc phát hiện các định nghĩa protobuf của bạn và cho phép hệ thống xây dựng Android biên dịch các định nghĩa đó, bạn phải thêm một tệp Android.bp vào thư mục trên cùng của thư mục danh mục.

Tệp này phải xác định một mục tiêu rust_protobuf nhóm các tệp protobuf của bạn (có đuôi .proto). Mỗi tệp trong danh mục của bạn phải được tính vào một nhóm tệp. Nếu có nhiều nhóm tệp trong tệp Android.bp, vsidlc sẽ lấy nhóm tệp đầu tiên.

Ví dụ sau đây minh hoạ một mục tiêu rust_protobuf điển hình cho danh mục VSIDL:

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