ภาษา AIDL จะใช้ภาษา Java อย่างคร่าวๆ ไฟล์ต่างๆ จะระบุสัญญาอินเทอร์เฟซ รวมถึงประเภทข้อมูลและค่าคงที่ต่างๆ ที่ใช้ในสัญญานี้
Package
ไฟล์ AIDL ทุกไฟล์จะเริ่มต้นด้วยแพ็กเกจที่ไม่บังคับซึ่งสอดคล้องกับชื่อแพ็กเกจในแบ็กเอนด์ต่างๆ การประกาศแพ็กเกจจะมีลักษณะดังนี้
package my.package;
ไฟล์ AIDL ต้องอยู่ในโครงสร้างโฟลเดอร์ที่ตรงกับแพ็กเกจ เช่นเดียวกับ Java ไฟล์ที่มีแพ็กเกจ my.package
ต้องอยู่ในโฟลเดอร์ my/package/
ประเภท
ในไฟล์ AIDL มีหลายตำแหน่งที่คุณระบุประเภทได้ ดูรายการประเภทที่รองรับในภาษา AIDL ได้ที่ประเภทแบ็กเอนด์ AIDL
คำอธิบายประกอบ
หลายส่วนของคำอธิบายประกอบภาษา AIDL รองรับ ดูรายการคำอธิบายประกอบและตำแหน่งที่สามารถใช้ได้ที่คำอธิบายประกอบ AIDL
การนำเข้า
หากต้องการใช้ประเภทที่กำหนดในอินเทอร์เฟซอื่น คุณต้องเพิ่มทรัพยากร Dependency ในระบบบิลด์ก่อน ในโมดูล cc_*
และ java_*
Soong ซึ่งมีการใช้ไฟล์ .aidl
โดยตรงภายใต้ srcs
ในเวอร์ชันแพลตฟอร์ม Android คุณสามารถเพิ่มไดเรกทอรีโดยใช้ช่อง aidl: { include_dirs: ... }
ได้ สำหรับการนำเข้าที่ใช้ aidl_interface
โปรดดูที่นี่
การนำเข้ามีลักษณะดังนี้
import some.package.Foo; // explicit import
เมื่อนำเข้าประเภทในแพ็กเกจเดียวกัน แพ็กเกจสามารถละเว้นได้ อย่างไรก็ตาม การละเว้นแพ็กเกจอาจทำให้เกิดข้อผิดพลาดในการนำเข้าที่ไม่ชัดเจนเมื่อมีการระบุประเภทโดยไม่มีแพ็กเกจและใส่ในเนมสเปซสากล (โดยทั่วไปทุกประเภทควรสร้างเนมสเปซ) ดังนี้
import Foo; // same as my.package.Foo
กำหนดประเภท
โดยทั่วไปแล้วไฟล์ AIDL จะกําหนดประเภทที่จะใช้เป็นอินเทอร์เฟซ
อินเทอร์เฟซ
ตัวอย่างอินเทอร์เฟซ AIDL
interface ITeleport {
void teleport(Location baz, float speed);
String getName();
}
อินเทอร์เฟซจะกำหนดออบเจ็กต์ด้วยชุดวิธีการ เมธอดอาจเป็นแบบ oneway
(oneway void doFoo()
) หรือแบบซิงโครนัสก็ได้ หากอินเทอร์เฟซได้รับการระบุเป็น oneway
(oneway interface ITeleport {...}
) เมธอดทั้งหมดในหน้านั้นจะเป็น oneway
โดยปริยาย ระบบจะส่งเมธอดทางเดียวแบบไม่พร้อมกันและแสดงผลลัพธ์ไม่ได้ เมธอดทางเดียวจากชุดข้อความเดียวกันไปยังแฟ้มเดียวกันจะดำเนินการแบบต่อเนื่องด้วย (แต่อาจดำเนินการในชุดข้อความที่แตกต่างกัน) ได้ ดูข้อมูลเกี่ยวกับวิธีตั้งค่าเทรดได้ที่การจัดการชุดข้อความของแบ็กเอนด์ AIDL
เมธอดจะมีอาร์กิวเมนต์เป็นศูนย์หรือมากกว่าได้ อาร์กิวเมนต์ของเมธอดอาจเป็น in
, out
หรือ inout
หากต้องการพูดคุยว่าการดำเนินการนี้ส่งผลต่อประเภทอาร์กิวเมนต์อย่างไร โปรดดูทิศทางของแบ็กเอนด์ AIDL
พาร์เซล
AIDL จะแบ็กเอนด์ Parcelable ที่กำหนดเองเพื่อดูคำอธิบายของวิธีสร้าง Parcelable เฉพาะแบ็กเอนด์
Android 10 ขึ้นไปรองรับคำจำกัดความของไฟล์พาร์เซลโดยตรงใน AIDL พัสดุประเภทนี้เรียกว่าพัสดุที่มีแบบมีโครงสร้าง ดูข้อมูลเพิ่มเติมเกี่ยวกับความเกี่ยวข้องของ AIDL ที่มีโครงสร้างและเสถียรในคอมไพเลอร์ AIDL และระบบบิลด์ของเราที่หัวข้อ AIDL ที่มีโครงสร้างกับเสถียร
เช่น
package my.package;
import my.package.Boo;
parcelable Baz {
@utf8InCpp String name = "baz";
Boo boo;
}
สหภาพ
ประกาศสหภาพการสนับสนุน Android 12 ขึ้นไป เช่น
package my.package;
import my.package.FooSettings;
import my.package.BarSettings;
union Settings {
FooSettings fooSettings;
BarSettings barSettings;
@utf8InCpp String str;
int number;
}
Enums
Android 11 ขึ้นไปรองรับการประกาศ enum เช่น
package my.package;
enum Boo {
A = 1 * 4,
B = 3,
}
การประกาศประเภทที่ซ้อนกัน
Android 13 ขึ้นไปรองรับการประกาศประเภทที่ซ้อนกัน เช่น
package my.package;
import my.package.Baz;
interface IFoo {
void doFoo(Baz.Nested nested); // defined in my/package/Baz.aidl
void doBar(Bar bar); // defined below
parcelable Bar { ... } // nested type definition
}
ค่าคงที่
อินเทอร์เฟซ AIDL ที่กำหนดเอง พาร์เซล และยูเนียนยังมีค่าคงที่ของสตริงและจำนวนเต็มได้ด้วย เช่น
const @utf8InCpp String HAPPY = ":)";
const String SAD = ":(";
const byte BYTE_ME = 1;
const int ANSWER = 6 * 7;
นิพจน์คงที่
คุณสามารถระบุค่าคงที่ AIDL ขนาดอาร์เรย์ และเครื่องมือแจกแจงได้โดยใช้นิพจน์คงที่ นิพจน์สามารถใช้วงเล็บเพื่อซ้อนการดำเนินการได้ ค่านิพจน์คงที่สามารถใช้กับค่าปริพันธ์หรือค่าลอยตัว
true
และ false
ลิเทอรัลแทนค่าบูลีน ค่าที่มี .
แต่ไม่มีส่วนต่อท้าย เช่น 3.8
จะถือว่าเป็นค่า Double ค่าทศนิยมมีคำต่อท้าย f
เช่น 2.4f
ค่าจำนวนเต็มที่มีส่วนต่อท้าย l
หรือ L
จะระบุค่าแบบยาว 64 บิต ไม่เช่นนั้น ค่าปริพันธ์จะได้ประเภทที่มีการลงชื่อซึ่งคงค่าไว้น้อยที่สุดระหว่าง 8 บิต (ไบต์), 32 บิต (int) และ 64 บิต (ยาว) ดังนั้น 256
จึงเป็น int
แต่ 255 + 1
เกินขีดจำกัดเป็น byte
0
ค่าฐานสิบหก เช่น 0x3
จะได้รับการตีความก่อนว่าเป็นประเภทที่ไม่มีเครื่องหมายซึ่งเก็บรักษาค่าน้อยที่สุดระหว่าง 32 บิตถึง 64 บิต แล้วจึงตีความใหม่เป็นค่าที่ไม่มีเครื่องหมาย ดังนั้น 0xffffffff
จะมีค่า int
-1
ตั้งแต่ Android 13 เป็นต้นไป คุณจะเพิ่มส่วนต่อท้าย u8
ลงในค่าคงที่ได้ เช่น 3u8
เพื่อแทนค่า byte
คำต่อท้ายนี้สำคัญมากเพราะจะทำให้ระบบตีความการคำนวณ เช่น 0xffu8 * 3
เป็น -3
ที่มีประเภท byte
ขณะที่ 0xff * 3
มีค่าเป็น 765
สำหรับประเภท int
โอเปอเรเตอร์ที่รองรับมี C++ และความหมายของ Java โอเปอเรเตอร์ไบนารีจะเป็น || && | ^ & == != < > <= >= << >> + - * / %
โดยเรียงลำดับจากความสำคัญต่ำสุดไปสูงสุด โอเปอเรเตอร์แบบรวมคือ + - ! ~