Ngôn ngữ AIDL chủ yếu dựa trên ngôn ngữ Java. Các tệp chỉ định một hợp đồng giao diện cũng như nhiều kiểu dữ liệu và hằng số được dùng trong hợp đồng này.
Gói
Mỗi tệp AIDL đều bắt đầu bằng một gói tuỳ chọn tương ứng với tên gói trong nhiều phần phụ trợ. Phần khai báo gói sẽ có dạng như sau:
package my.package;
Tương tự như Java, các tệp AIDL phải nằm trong một cấu trúc thư mục khớp với gói của chúng. Các tệp có gói my.package
phải nằm trong thư mục my/package/
.
Loại
Trong tệp AIDL, có nhiều vị trí bạn có thể chỉ định các loại. Để biết danh sách chính xác các loại được hỗ trợ bằng ngôn ngữ AIDL, hãy xem các loại phần phụ trợ AIDL.
Chú thích
Một số phần trong chú thích hỗ trợ ngôn ngữ AIDL. Để biết danh sách các chú giải và vị trí bạn có thể áp dụng các chú giải đó, hãy xem chú thích AIDL.
Nhập
Để sử dụng các kiểu được xác định trong các giao diện khác, trước tiên, bạn phải thêm các phần phụ thuộc vào hệ thống xây dựng. Trong các mô-đun cc_*
và java_*
Soong, trong đó các tệp .aidl
được sử dụng ngay trong srcs
trong các bản dựng nền tảng Android, bạn có thể thêm các thư mục bằng cách sử dụng trường aidl: { include_dirs: ... }
. Để nhập các lệnh bằng aidl_interface
, hãy xem tại đây.
Dữ liệu nhập sẽ có dạng như sau:
import some.package.Foo; // explicit import
Khi nhập một loại trong cùng một gói, gói đó có thể bị bỏ qua. Tuy nhiên, việc bỏ qua gói này có thể dẫn đến lỗi nhập không rõ ràng khi các loại được chỉ định mà không có gói và đặt vào không gian tên chung (thường thì tất cả các loại đều phải được đặt trong vùng chứa tên):
import Foo; // same as my.package.Foo
Xác định loại
Tệp AIDL thường xác định các loại được dùng làm giao diện.
Giao diện
Dưới đây là ví dụ về giao diện AIDL:
interface ITeleport {
void teleport(Location baz, float speed);
String getName();
}
Giao diện xác định một đối tượng bằng một loạt các phương thức. Các phương thức có thể là oneway
(oneway void doFoo()
) hoặc đồng bộ. Nếu một giao diện được xác định là oneway
(oneway interface ITeleport {...}
), thì tất cả phương thức trong giao diện đó sẽ ngầm ẩn là oneway
. Các phương thức một chiều được gửi không đồng bộ và không thể trả về kết quả. Các phương thức một chiều từ cùng một luồng đến cùng một liên kết cũng thực thi tuần tự (mặc dù có thể trên nhiều luồng). Để thảo luận về cách thiết lập luồng, hãy xem phần Quản lý luồng trong phần phụ trợ AIDL.
Các phương thức có thể không có hoặc có nhiều đối số. Đối số cho các phương thức có thể là in
, out
hoặc inout
. Để thảo luận về mức độ ảnh hưởng của điều này đến các loại đối số, vui lòng xem Hướng của phần phụ trợ AIDL.
Theo gói
Để xem nội dung mô tả về cách tạo các bưu kiện dành riêng cho phần phụ trợ, hãy xem các gói phụ trợ AIDL.
Android 10 trở lên hỗ trợ trực tiếp các định nghĩa theo gói trong AIDL. Loại phân khúc có thể đóng gói này được gọi là gói có cấu trúc. Để biết thêm thông tin về mối liên hệ giữa AIDL có cấu trúc và ổn định trong trình biên dịch AIDL và hệ thống xây dựng của chúng tôi, hãy xem phần AIDL có cấu trúc và ổn định.
Ví dụ:
package my.package;
import my.package.Boo;
parcelable Baz {
@utf8InCpp String name = "baz";
Boo boo;
}
Liên đoàn
Android 12 trở lên có hỗ trợ khai báo hợp nhất (union). Ví dụ:
package my.package;
import my.package.FooSettings;
import my.package.BarSettings;
union Settings {
FooSettings fooSettings;
BarSettings barSettings;
@utf8InCpp String str;
int number;
}
Liệt kê
Android 11 trở lên hỗ trợ khai báo enum. Ví dụ:
package my.package;
enum Boo {
A = 1 * 4,
B = 3,
}
Khai báo kiểu lồng ghép
Android 13 trở lên hỗ trợ việc khai báo kiểu lồng ghép. Ví dụ:
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
}
Hằng số
Các giao diện, đối tượng đóng gói và liên kết AIDL tuỳ chỉnh cũng có thể chứa hằng số nguyên và chuỗi, chẳng hạn như:
const @utf8InCpp String HAPPY = ":)";
const String SAD = ":(";
const byte BYTE_ME = 1;
const int ANSWER = 6 * 7;
Biểu thức hằng
Bạn có thể chỉ định hằng số AIDL, kích thước mảng và giá trị liệt kê bằng biểu thức không đổi. Biểu thức có thể sử dụng dấu ngoặc đơn để lồng các toán tử. Bạn có thể dùng các giá trị biểu thức hằng số với các giá trị tích phân hoặc giá trị số thực.
Các giá trị cố định true
và false
biểu thị cho các giá trị boolean. Các giá trị có .
nhưng không có hậu tố, chẳng hạn như 3.8
, được coi là giá trị kép. Giá trị số thực có hậu tố f
, chẳng hạn như 2.4f
. Một giá trị tích phân có hậu tố l
hoặc L
cho biết giá trị dài 64 bit. Nếu không, các giá trị tích phân sẽ có kiểu đã ký bảo toàn giá trị nhỏ nhất trong khoảng từ 8 bit (byte), 32 bit (int) và 64 bit (dài). Vì vậy, 256
được coi là int
, nhưng 255 + 1
vượt ra ngoài byte
0
. Trước tiên, các giá trị hex, chẳng hạn như 0x3
, được hiểu là kiểu chưa ký bảo toàn giá trị nhỏ nhất từ 32 bit đến 64 bit, sau đó được diễn giải lại dưới dạng giá trị chưa ký. Vì vậy, 0xffffffff
có giá trị int
-1
. Kể từ Android 13, hậu tố u8
có thể được thêm vào các hằng số, chẳng hạn như 3u8
, để biểu thị giá trị byte
. Hậu tố này rất quan trọng để một phép tính, chẳng hạn như 0xffu8 * 3
, được diễn giải là -3
với loại byte
trong khi 0xff * 3
là 765
với loại int
.
Các toán tử được hỗ trợ có ngữ nghĩa C++ và Java. Theo thứ tự từ mức độ ưu tiên thấp nhất đến cao nhất, các toán tử nhị phân là || && | ^ & == != < > <= >= << >> + - * / %
. Toán tử đơn nhất là + - ! ~
.