ভাষার স্পেসিফিকেশন

এই পৃষ্ঠায় ISO/IEC 14977 এক্সটেন্ডেড ব্যাকাস-নাউর ফর্ম (EBNF) ও প্রোটোবাফ ব্যবহার করে ভেহিকল সার্ভিস ইন্টারফেস ডেফিনেশন ল্যাঙ্গুয়েজ (VSIDL) নির্দিষ্ট করা হয়েছে। এই পৃষ্ঠাটি ভাষার প্রসঙ্গ-মুক্ত ব্যাকরণ এবং ভাষার উপাদানগুলির অর্থের উপর ফোকাস করে।

ভাষার হায়ারার্কি

মেটা অবজেক্ট ফেসিলিটি (MOF) অনুযায়ী, VSIDL কম্পাইলার (VSIDLC) ছবি ১-এ দেখানো ভাষা ব্যবহার করে:

VSIDLC languages

ছবি ১. VSIDLC languages.

VSIDLC মূলত প্রোটোকল বাফার (protobuf) ভাষার উপর ভিত্তি করে তৈরি। Protobuf পাবলিশ-সাবস্ক্রাইব এবং রিমোট প্রসিডিওর কল (RPC) ব্যবহার করে আদান-প্রদান করা ডেটার ধরন নির্দিষ্ট করে। টেকনিক্যালি, VSIDL মডেল হল TextProto ফাইল এবং VSIDL সিনট্যাক্স একটি protobuf ফাইলে (syntax.proto) সংজ্ঞায়িত করা হয়।

ডেটার ধরন নির্দিষ্ট করার জন্য protobuf ফাইল এবং VSIDL মডেল, দুটিই Rust কোড জেনারেট করার জন্য ব্যবহার করা হয়। জেনারেট করা কোডে এক্সচেঞ্জ করা মেসেজ ডেটা স্ট্রাকচারের জন্য স্ট্রাক্ট এবং সার্ভিস ইউনিট তৈরি করার জন্য Rust ফাংশন থাকে, তবে সেই সার্ভিস ইউনিটগুলি অটোমেটিক কল করা হয় না। কাস্টম Rust কোড তারপর পরিষেবা ইউনিট ইনস্ট্যান্টিয়েট করতে এবং অ্যাপ্লিকেশন লজিক প্রয়োগ করতে জেনারেট করা কোড ব্যবহার করে।

অ্যাবস্ট্র্যাক্ট সিনট্যাক্স

VSIDL-এ মূল মেসেজের ধরন ২ নম্বর ছবিতে দেখানো হয়েছে:

VSIDL-এ মূল মেসেজের ধরন

ছবি ২. VSIDL-এ মূল মেসেজের ধরন।

VSIDL এন্ট্রি

এই বিভাগে VSIDL এন্ট্রি মেসেজের ধরন ব্যাখ্যা করা হয়েছে।

EBNF ব্যাকরণ

start VsidlEntry =
  "package" , ":" , String , ";" ,
  { "service_bundle" , ServiceBundle } ,
  { "extension" , ":" , Any } ,
  { "some_ip_mapping" , ":" , SomeIpMapping } ,
  { "vhal_mapping" , ":" , VhalMapping }
;

প্রোটো সংজ্ঞা

// The root message for VSIDL files
message VsidlEntry {
  // Required. Package name for entities mentioned in the file.
  string package = 1;
  // Enables custom extensions beyond the standard VSIDL model.
  repeated google.protobuf.Any extension = 3;

  // SOMEIP mapping rules
  repeated sdv.someip.v1.SomeIpMapping some_ip_mapping = 4;
  // VHAL mapping rules
  repeated VhalMapping vhal_mapping = 5;
  // List of SDV service bundles defined in the file.
  repeated ServiceBundle service_bundle = 6;
}

ব্যবহারের উদাহরণ

package: "com.android.sdv.sample.vsidl"

service_bundle {
  name: "Manager"

  publisher {
    message: "TirePressure"
    topic: "front-left"
    topic: "front-right"
    capacity: 10
  }
}

ব্যাখ্যা

VsidlEntry মেসেজটি VSIDL ফাইলের (.vsidl এক্সটেনশন সহ) রুট কন্টেনার হিসেবে কাজ করে। এই মেসেজটি একটি VSIDL ফাইলের মধ্যে সমস্ত সংজ্ঞা এবং কনফিগারেশন এনক্যাপসুলেট করে। VsidlEntry হল টপ-লেভেল এলিমেন্ট যা অন্য সব কিছুকে একসাথে বেঁধে রাখে।

উদ্দেশ্য:

  • VSIDL ফাইলের সামগ্রিক স্ট্রাকচার নির্ধারণ করে।
  • ফাইলের মধ্যে থাকা সব এন্টিটির জন্য প্যাকেজ নেমস্পেস নির্দিষ্ট করে।
  • পরিষেবা বান্ডেল সংজ্ঞার একটি সংগ্রহ রয়েছে।
  • VSIDL মডেলে কাস্টম এক্সটেনশনের অনুমতি দেয়।
  • SOME/IP এবং VHAL-এর জন্য ম্যাপিং নিয়ম অন্তর্ভুক্ত করে।

সীমাবদ্ধতা

  • প্যাকেজের নাম (E211): প্যাকেজের নাম ১২৭ অক্ষরের বেশি হলে চলবে না।
  • ড্যাংলিং ফাইল (E10B): ক্যাটালগের সব ফাইলকে অবশ্যই একটি Android.bp ফাইলগ্রুপে রেফারেন্স করতে হবে।

পরিষেবা বান্ডেল

এই বিভাগে পরিষেবা বান্ডেল মেসেজের ধরন ব্যাখ্যা করা হয়েছে।

EBNF ব্যাকরণ

ServiceBundle = "{" , { ServiceBundleElement } , "}" ;

ServiceBundleElement =
  "name" , ":" , String |
  "publisher" , Publisher |
  "subscriber" , Subscriber |
  "server" , Server |
  "client" , Client |
  "extension" , ":" , Any |
  "diagnostics_declaration" , DiagnosticsDeclaration |
  "build_cfg" , BuildConfiguration |
  "register_reflection_metadata" , Boolean
;

প্রোটো সংজ্ঞা

// Defines an SDV service
message ServiceBundle {
  // Required. Name of the service bundle (without the package name).
  string name = 1;
  // List of publications the service bundle provides.
  repeated Publisher publisher = 2;
  // List of publications a service bundle subscribes to.
  repeated Subscriber subscriber = 3;
  // RPC services offered by a service bundle.
  repeated Server server = 4;
  // RPC services consumed by a service bundle.
  repeated Client client = 5;
  // Enables custom extensions beyond the standard VSIDL model.
  repeated google.protobuf.Any extension = 7;

  // Diagnostics declarations
  sdv.diagnostics.v1.DiagnosticsDeclaration diagnostics_declaration = 8;

  // Build Configuration
  optional BuildConfiguration build_cfg = 9;

  // Register metadata for service units provided by this service bundle.
  // Setting this to true will increase the memory footprint
  // and network load significantly.
  bool register_reflection_metadata = 10;
}

ব্যবহারের উদাহরণ

service_bundle {
    name: "SeatController"

    publisher {
      message: "SeatHeating"
      topic: "driver-seat"
      capacity: 10
    }
}

ব্যাখ্যা

পরিষেবা বান্ডেল সম্পর্কিত পরিষেবা, প্রকাশক, সাবস্ক্রাইবার, RPC সার্ভার ও RPC ক্লায়েন্টের লজিক্যাল গ্রুপিংকে সংজ্ঞায়িত করে। পরিষেবা বান্ডেল, নির্দিষ্ট সেট কার্যকারিতা এবং তাদের ইন্টার‍্যাকশনের জন্য একটি কন্টেনার হিসেবে কাজ করে।

সীমাবদ্ধতা

  • বান্ডেলের নাম সংক্রান্ত প্রয়োজনীয়তা (E209, E20A, E20B, E20C):
    • পরিষেবা বান্ডেলে অবশ্যই একটি পপুলেট করা নাম থাকতে হবে।
    • নামটি অবশ্যই একটি সঠিক ইউনিকোড শনাক্তকারী শুরুর অক্ষর দিয়ে শুরু হতে হবে (সাধারণত একটি অক্ষর)।
    • নামের পরবর্তী অক্ষরগুলি অবশ্যই বৈধ ইউনিকোড শনাক্তকারী কন্টিনিউয়েশন অক্ষর (সাধারণত অক্ষর বা সংখ্যা) হতে হবে।
    • নামটি Rust, Java বা C++-এ সংরক্ষিত কীওয়ার্ড হওয়া উচিত নয়।
  • গ্লোবাল বান্ডেলের অনন্যতা (E309): প্রতিটি পরিষেবা বান্ডেলের একটি অনন্য সম্পূর্ণ যোগ্য নাম (এর প্যাকেজ এবং নামের উপর ভিত্তি করে) থাকতে হবে।
  • ইন্টার্নাল ইউনিকনেস (E100, E300, E302, E303, E308):
    • একটি পরিষেবা বান্ডেলের মধ্যে, প্রতিটি RPC পরিষেবা সর্বাধিক একটি সার্ভার সংজ্ঞা দ্বারা পরিবেশন করা যেতে পারে।
    • একটি পরিষেবা বান্ডেলের মধ্যে, প্রতিটি MULTI_PUB প্রকাশনার ধরন সর্বাধিক একটি প্রকাশক সংজ্ঞা দ্বারা প্রকাশ করা যেতে পারে।
    • একটি একক পরিষেবা বান্ডেলের মধ্যে, সমস্ত ব্যবহারকারী-সংজ্ঞায়িত পরিষেবা ইউনিটের নাম (প্রকাশক বা সার্ভারের জন্য) অবশ্যই অনন্য হতে হবে।
    • একটি পরিষেবা বান্ডেলের মধ্যে, সব পরিষেবা ইউনিটের নাম (ব্যবহারকারীর দ্বারা সংজ্ঞায়িত বা অটোমেটিক তৈরি করা) অবশ্যই অনন্য হতে হবে।
  • বিল্ড টার্গেট নেমিং কনভেনশন (E205, E206, E207, E208): কাস্টম বিল্ড টার্গেট নাম (build_cfg.target_name) প্রদান করা হলে, এটি অবশ্যই স্নেক কেস ফর্ম্যাট (ছোট হাতের অক্ষর, সংখ্যা এবং একক আন্ডারস্কোর, আন্ডারস্কোর দিয়ে শুরু বা শেষ না হওয়া) মেনে চলতে হবে।
  • বিল্ড টার্গেটের নামের অনন্যতা (E301): ব্যবহারকারীর দ্বারা নির্ধারিত বিল্ড টার্গেটের নাম অন্যান্য পরিষেবা বান্ডেলের জন্য অটোমেটিক জেনারেট হওয়া টার্গেটের নামের সাথে যেন মিলে না যায়।

পাবলিশার

এই বিভাগে প্রকাশকের মেসেজের ধরন ব্যাখ্যা করা হয়েছে।

EBNF ব্যাকরণ

Publisher = "{" , { PublisherElement } , "}" ;

PublisherElement =
  "message" , ":" , String |
  "topic" , ":" , String |
  "capacity" , ":" , Integer |
  "service_unit_name" , ":" , String
;

প্রোটো সংজ্ঞা

// Represents a publisher within a service bundle.
message Publisher {
  // Name of the service unit. Name may only use characters from [a-z0-9\-]+,
  // must start with [a-z], may not end with a hyphen,
  // and may not contain consecutive hyphens.
  string service_unit_name = 3;
  // Required. The type of data being published.
  string message = 4;
  // Required. The number of messages a publication queue can hold.
  // Must be an even number >= 2.
  int64 capacity = 6;
  // Required. Unique identifier for the publication topic.
  // Must be in lowercase dash-case.
  repeated string topic = 7;
}

ব্যবহারের উদাহরণ

publisher {
  message: "SeatHeating"
  topic: "driver-heating"
  capacity: 10
}

ব্যাখ্যা

Publisher মেসেজের ধরন এমন একটি ডেটা সোর্সকে সংজ্ঞায়িত করে যা ServiceBundle প্রদান করে। এই মেসেজের ধরন, যে ধরনের ডেটা প্রকাশ করা হচ্ছে এবং সেই ডেটার নির্দিষ্ট বিষয় ও ক্ষমতা নির্দিষ্ট করে।

বিষয়

প্রতিটি Publisher ইনস্ট্যান্সে একটি message ফিল্ড থাকে যা প্রকাশিত প্রোটো মেসেজকে রেফার করে। এতে অবশ্যই একটি বিষয় (topic দ্বারা উপস্থাপিত) এবং একটি ক্ষমতা (capacity দ্বারা উপস্থাপিত) উল্লেখ করতে হবে।

  • Topic: প্রকাশনার বিষয়ের জন্য অনন্য শনাক্তকারী। এটি অবশ্যই ছোট হাতের ড্যাশ-কেস (যেমন, my-topic) অনুসরণ করতে হবে।
  • ক্যাপাসিটি: সারির সাইজ নির্দিষ্ট করে, অর্থাৎ, না পড়া মেসেজ বাতিল করার আগে সারি কতগুলি মেসেজ ধরে রাখতে পারে। এটি অবশ্যই ২-এর সমান বা তার চেয়ে বড় জোড় সংখ্যা হতে হবে।

ব্যবহারকারীর উল্লেখ করা নাম

প্রকাশকরা ব্যবহারকারীর দ্বারা নির্ধারিত পরিষেবা ইউনিটের নাম ব্যবহার করতে পারেন যা অটোমেটিক বেছে নেওয়া পরিষেবা ইউনিটের নামকে ওভাররাইড করে। এই অ্যাফর্ডেন্সের মাধ্যমে ছোট নাম বেছে নেওয়া যায়। কোনও প্রকাশক ব্যবহারকারীর দ্বারা নির্ধারিত পরিষেবা ইউনিটের নাম ব্যবহার করলে, এটি শুধুমাত্র একটি ইনস্ট্যান্স ব্যবহার করতে পারে, যাতে পরিষেবা ইউনিটের নাম অনন্যভাবে একটি ইনস্ট্যান্সে অ্যাসাইন করা হয়।

# VALID: A publisher assigns a user-defined name to a single instance
publisher {
  message: "SeatHeating"
  topic: "seat-heating-status"
  service_unit_name: "heating-is-off"
}

# ERROR: user-defined names are only allowed if there's only a single instance
publisher {
  message: "SeatHeating"
  topic: "seat-heating-status"
  service_unit_name: "heating-status"
}

সীমাবদ্ধতা

  • প্রকাশক প্লেসমেন্ট (E300): একই MULTI_PUB ধরনের প্রকাশকদের আলাদা সার্ভিস বান্ডেলে সংজ্ঞায়িত করতে হবে।
  • স্থানীয় নামের অনন্যতা (E302): যেকোনও একটি সার্ভিস বান্ডেলের মধ্যে, সব প্রকাশকের অবশ্যই অনন্য ব্যবহারকারী-নির্ধারিত পরিষেবা ইউনিটের নাম থাকতে হবে।
  • গ্লোবাল নামের অনন্যতা (E304): একই প্রকাশনার ধরনের প্রকাশকদের সমস্ত পরিষেবা বান্ডেল জুড়ে বিশ্বব্যাপী অনন্য ব্যবহারকারী-নির্ধারিত পরিষেবা ইউনিটের নাম থাকতে হবে।
  • সিঙ্গেল চ্যানেলের নামকরণ (E306): ব্যবহারকারীর দ্বারা নির্ধারিত পরিষেবা ইউনিটের নাম শুধুমাত্র সেইসব প্রকাশকদের অ্যাসাইন করা যেতে পারে যারা ঠিক একটি ইনস্ট্যান্স ম্যানেজ করেন।
  • একক প্রকাশকের সীমা (E307): SINGLE_PUB হিসেবে চিহ্নিত করা একটি protobuf মেসেজ পুরো সিস্টেম জুড়ে শুধুমাত্র একজন প্রকাশক প্রকাশ করতে পারবেন।
  • পরিষেবা ইউনিটের নামের অনন্যতা (E308): সব পরিষেবা ইউনিটের নাম (জেনারেট করা বা ব্যবহারকারীর দ্বারা সংজ্ঞায়িত) তাদের পরিষেবা বান্ডেলের মধ্যে অনন্য হতে হবে; জেনারেট করা নামের সাথে দ্বন্দ্ব সমাধান করতে ব্যবহারকারীর দ্বারা সংজ্ঞায়িত নাম ব্যবহার করা উচিত।
  • ভেরিয়েন্ট স্পেসিফিকেশন সংক্রান্ত প্রয়োজনীয়তা (E501): কোনও প্রকাশক একাধিক ভেরিয়েন্ট সহ কোনও প্রকারের জন্য ব্যবহারকারীর-নির্ধারিত নাম ব্যবহার করলে, সেটিকে অবশ্যই স্পষ্টভাবে প্রকাশিত ভেরিয়েন্টটি উল্লেখ করতে হবে।
  • সাবস্ক্রাইবারের জন্য প্রকাশকের অস্তিত্ব (E504): প্রতিটি নির্দিষ্ট সাবস্ক্রাইবারের জন্য নির্দিষ্ট ধরন ও ভ্যারিয়েন্টের অন্তত একজন সংশ্লিষ্ট প্রকাশক প্রয়োজন।
  • প্রকাশকের সঠিক ধরন (E601): প্রকাশককে অবশ্যই এমন একটি ধরন উল্লেখ করতে হবে যা আগে থেকে থাকা protobuf মেসেজের সাথে মেলে।
  • প্রকাশনা অ্যানোটেশন সংক্রান্ত প্রয়োজনীয়তা (E602): প্রকাশকের রেফার করা protobuf মেসেজের ধরন অবশ্যই SdvPublication অ্যানোটেশন অন্তর্ভুক্ত করতে হবে।
  • সঠিক ভেরিয়েন্টের ব্যবহার (E606): কোনও প্রকাশক ভেরিয়েন্ট (ইনস্ট্যান্স) নির্দিষ্ট করলে, সেই ভেরিয়েন্টটি অবশ্যই protobuf-এ প্রকাশনার ধরনের জন্য নির্ধারিত instances_enum-এর মধ্যে থাকতে হবে।
  • ভেরিয়েন্ট স্পেসিফিকেশন শর্ত (E607): কোনও প্রকাশক শুধুমাত্র তখনই একটি স্পষ্ট ভেরিয়েন্ট (ইনস্ট্যান্স) নির্দিষ্ট করতে পারেন যদি প্রকাশনার ধরন protobuf-এ একটি instances_enum সংজ্ঞায়িত করে।
  • বিষয়ের নামকরণ (E20D, E20F): বিষয়গুলি অবশ্যই ছোট হাতের ড্যাশ-কেসে হতে হবে এবং ১২৭ অক্ষরের বেশি হবে না।
  • বিষয় অনন্যতা (E314): সব প্রকাশকের ক্ষেত্রে বিষয় বিশ্বব্যাপী অনন্য হতে হবে।
  • ক্যাপাসিটি সংক্রান্ত প্রয়োজনীয়তা (E406, E407): ক্যাপাসিটি উল্লেখ করা বাধ্যতামূলক এবং এটি অবশ্যই জোড় সংখ্যা >= ২ হতে হবে।

সাবস্ক্রাইবার

এই বিভাগে সাবস্ক্রাইবার মেসেজের ধরন সম্পর্কে ব্যাখ্যা করা হয়েছে।

EBNF ব্যাকরণ

Subscriber = "{" , { SubscriberElement } , "}" ;

SubscriberElement =
  "message" , ":" , String |
  "topic" , ":" , String
;

প্রোটো সংজ্ঞা

// Represents a subscriber within a service bundle.
message Subscriber {
  // Required. The type of data being subscribed to.
  string message = 4;
  // Required. Specific topic(s) of the message to subscribe to.
  // Must match the publisher's topic.
  repeated string topic = 6;
}

ব্যবহারের উদাহরণ

subscriber {
  message: "SeatHeating"
  topic: "driver-seat"
}

ব্যাখ্যা

Subscriber মেসেজটি একটি প্রকাশনা রিসিভারকে সংজ্ঞায়িত করে যা ServiceBundle প্রদান করে। এই মেসেজে সাবস্ক্রাইব করা ডেটার ধরন এবং সেই প্রকাশনার নির্দিষ্ট বিষয় উল্লেখ করা থাকে। কোনও বিষয়ের একাধিক প্রকাশক থাকলে, সাবস্ক্রাইবার তাদের সকলের প্রকাশিত মেসেজ পান।

সীমাবদ্ধতা

  • প্রকাশকের অস্তিত্ব (E504): প্রতিটি নির্দিষ্ট সাবস্ক্রাইবারের জন্য, অন্তত একজন সংশ্লিষ্ট প্রকাশক থাকতে হবে যিনি নির্দিষ্ট প্রকাশনার ধরন এবং ভেরিয়েন্ট প্রকাশ করেন।
  • সাবস্ক্রিপশনের সঠিক ধরন (E608): সাবস্ক্রাইবারকে অবশ্যই এমন একটি ধরন উল্লেখ করতে হবে যা SdvPublication অ্যানোটেশন সহ সংজ্ঞায়িত একটি বিদ্যমান প্রোটোবাফ মেসেজের সাথে সম্পর্কিত।
  • সঠিক ভেরিয়েন্ট সাবস্ক্রিপশন (E609): কোনও সাবস্ক্রাইবার ভেরিয়েন্ট (ইনস্ট্যান্স) নির্দিষ্ট করলে, সেই ভেরিয়েন্টটি অবশ্যই সংশ্লিষ্ট protobuf প্রকাশনার ধরনের instances_enum-এর মধ্যে সংজ্ঞায়িত একটি সঠিক মান হতে হবে।
  • বিষয় বাধ্যতামূলক (E408): সাবস্ক্রাইবারদের জন্য বিষয় বাধ্যতামূলক।
  • বিষয় আবার ঘোষণা করা (E311): একই পরিষেবা বান্ডেলে সাবস্ক্রাইবার বিষয় আবার ঘোষণা করা যাবে না।

RPC সার্ভার

এই বিভাগে RPC সার্ভার মেসেজের ধরন ব্যাখ্যা করা হয়েছে।

EBNF ব্যাকরণ

Server = "{" , { ServerElement } , "}" ;

ServerElement =
  "service" , ":" , String |
  "channel" , ":" , String |
  "service_unit_name" , ":" , String
;

প্রোটো সংজ্ঞা

// Represents an RPC server within a service bundle.
message Server {
  // Deprecated. Name of the service unit.
  string service_unit_name = 3 [ deprecated = true ];
  // Required. Name of the RPC service.
  string service = 4;
  // Required. Name of the RPC channel.
  // Must be in lowercase dash-case.
  string channel = 5;
}

ব্যবহারের উদাহরণ

server {
  service: "SetTemperature"
  channel: "temp-setter"
}

ব্যাখ্যা

Server মেসেজটি একটি RPC সার্ভারকে সংজ্ঞায়িত করে যা ServiceBundle প্রদান করে। এই মেসেজটি সার্ভার যে পরিষেবা প্রয়োগ করে এবং RPC চ্যানেল নির্দিষ্ট করে।

RPC সার্ভার এমন কিছু পদ্ধতি দেখায় যা ক্লায়েন্ট দূরবর্তীভাবে চালু করতে পারে। service ফিল্ডটি RPC পরিষেবার নাম নির্দিষ্ট করে যা সার্ভার প্রয়োগ করে। এই পরিষেবাটি একটি প্রোটো ফাইলে সংজ্ঞায়িত করা হয়েছে এবং কাস্টম Rust কোডে প্রয়োগ করা হয়েছে। RPC পরিষেবায় ইউনারি, ক্লায়েন্ট-স্ট্রিমিং ও সার্ভার-স্ট্রিমিং পদ্ধতি অন্তর্ভুক্ত থাকতে পারে, যেমনটা protobuf পরিষেবার সংজ্ঞায় উল্লেখ করা আছে। channel ফিল্ডটি যোগাযোগের এন্ডপয়েন্ট নির্ধারণ করে এবং এটি বাধ্যতামূলক (E409)।

সীমাবদ্ধতা

  • পরিষেবার সংজ্ঞা (E603): RPC সার্ভারকে অবশ্যই এমন একটি service মান উল্লেখ করতে হবে যা আগে থেকে থাকা protobuf RPC service মানের সাথে মেলে।
  • প্রতি পরিষেবায় সার্ভারের সীমা (E100): একটি পরিষেবা বান্ডেলের মধ্যে, একটি নির্দিষ্ট RPC service সর্বাধিক একটি সার্ভার সংজ্ঞা দ্বারা পরিবেশন করা যেতে পারে।
  • চ্যানেলের নামকরণ (E20E): RPC চ্যানেল অবশ্যই ছোট হাতের ড্যাশ-কেসে হতে হবে।
  • চ্যানেল বাধ্যতামূলক (E409): RPC চ্যানেল বাধ্যতামূলক।
  • চ্যানেলের অনন্যতা (E40B): RPC চ্যানেল শুধুমাত্র একটি পরিষেবার মাধ্যমে ব্যবহার করতে হবে।

RPC ক্লায়েন্ট

এই বিভাগে RPC ক্লায়েন্ট মেসেজের ধরন ব্যাখ্যা করা হয়েছে।

EBNF ব্যাকরণ

Client = "{" , { ClientElement } , "}" ;

ClientElement =
  "service" , ":" , String |
  "channel" , ":" , String
;

প্রোটো সংজ্ঞা

// Represents an RPC client within a service bundle.
message Client {
  // Required. Name of the RPC service.
  string service = 2;
  // Required. Name of the RPC channel.
  // Must match the server's channel and be in lowercase dash-case.
  string channel = 3;
}

ব্যবহারের উদাহরণ

client {
  service: "SetTemperature"
  channel: "temp-setter"
}

ব্যাখ্যা

client একটি RPC ক্লায়েন্টকে সংজ্ঞায়িত করে যা ServiceBundle ব্যবহার করে। client ক্লায়েন্ট যে পরিষেবা ব্যবহার করে এবং কানেক্ট করার জন্য যে চ্যানেল ব্যবহার করে তা উল্লেখ করে। পরিষেবার সংজ্ঞার উপর নির্ভর করে, ক্লায়েন্ট ইউনারি, ক্লায়েন্ট-স্ট্রিমিং এবং সার্ভার-স্ট্রিমিং পদ্ধতির সাথে ইন্টার‍্যাক্ট করতে পারে।

সীমাবদ্ধতা

  • পরিষেবার সংজ্ঞা (E60A): RPC ক্লায়েন্টকে অবশ্যই একটি service উল্লেখ করতে হবে যা আগে থেকে থাকা protobuf service সংজ্ঞার সাথে সম্পর্কিত।
  • অনন্য পরিষেবা সোর্স (E60B): RPC ক্লায়েন্টের service দ্বারা রেফারেন্স করা protobuf service সংজ্ঞা সব protobuf ফাইল জুড়ে অনন্যভাবে সংজ্ঞায়িত (একাধিকবার সংজ্ঞায়িত নয়) হতে হবে।
  • চ্যানেল বাধ্যতামূলক (E409): RPC চ্যানেল বাধ্যতামূলক।

বিল্ড কনফিগারেশন

এই বিভাগে বিল্ড কনফিগারেশন মেসেজের ধরন ব্যাখ্যা করা হয়েছে।

EBNF ব্যাকরণ

BuildConfiguration = "{" , BuildConfigurationElement, "}" ;

BuildConfigurationElement =
  "target_name" , ":" , String |
  "skip_codegen" , ":" , Boolean
;

প্রোটো সংজ্ঞা

// Defines additional information used to configure build settings
message BuildConfiguration {
  /// Build target name
  optional string target_name = 1;
  // Do not generate code for this service bundle
  optional bool skip_codegen = 2;
}

ব্যবহারের উদাহরণ

build_cfg {
  target_name: "my_custom_target_name"
  skip_codegen: false
}

ব্যাখ্যা

BuildConfiguration কোড জেনারেশনের জন্য ServiceBundle-এর নন-স্ট্যান্ডার্ড প্যারামিটার কনফিগার করে। সব বিল্ড কনফিগারেশন ঐচ্ছিক।

  • target_name (ঐচ্ছিক string): Android.bp ফাইলে বিল্ড টার্গেটের নাম নির্দিষ্ট করে। অটোমেটিক বেছে নেওয়া নামের থেকে ছোট নাম দিয়ে টার্গেট নাম সেট করতে এটি ব্যবহার করুন।
  • skip_codegen (ঐচ্ছিক bool): এই পরিষেবা বান্ডেলের জন্য কোড জেনারেশন এড়িয়ে যাওয়া উচিত কিনা তা নির্দেশ করে। true-এ সেট করা থাকলে, এই নির্দিষ্ট পরিষেবা বান্ডেলের জন্য কোনও কোড জেনারেট করা হয় না। ম্যানুয়ালি প্রয়োগ করা হয় এমন পরিষেবা বান্ডেলের ক্ষেত্রে এটি উপযোগী হতে পারে। ডিফল্ট হিসেবে, এটি false-এ সেট করা থাকে।

সীমাবদ্ধতা

  • টার্গেট নামের ফর্ম্যাট (E205, E206, E207, E208): কাস্টম বিল্ড টার্গেটের নাম (build_cfg.target_name) দেওয়া হলে, সেটি অবশ্যই স্নেক কেস ফর্ম্যাটিং অনুসরণ করতে হবে:
    • এতে শুধু ছোট হাতের অক্ষর (a থেকে z), সংখ্যা (0 থেকে 9) এবং আন্ডারস্কোর (_) থাকতে হবে।
    • এতে পরপর আন্ডারস্কোর (__) থাকলে চলবে না।
    • এটি আন্ডারস্কোর দিয়ে শুরু করা যাবে না।
    • এটি আন্ডারস্কোর দিয়ে শেষ করা যাবে না।
  • টার্গেট নামের অনন্যতা (E301): ব্যবহারকারীর দ্বারা নির্ধারিত build_cfg.target_name বিল্ড সিস্টেম জুড়ে অনন্য হতে হবে এবং অন্য পরিষেবা বান্ডেল সংজ্ঞা থেকে প্রাপ্ত অটোমেটিক তৈরি করা টার্গেট নামের সাথে কোনও বিরোধ থাকা চলবে না।