Ngôn ngữ AIDL

Ngôn ngữ AIDL chủ yếu dựa trên ngôn ngữ Java. Tệp chỉ định 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 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 . 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í có thể chỉ định loại. Để biết danh sách chính xác các loại được hỗ trợ trong ngôn ngữ AIDL, hãy xem phần Các loại phần phụ trợ AIDL.

Chú thích

Một số phần của ngôn ngữ AIDL hỗ trợ chú thích. Để biết danh sách chú thích và nơi có thể áp dụng chú thích, hãy xem Chú thích AIDL.

Nhập

Để sử dụng các loại đượ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 trong hệ thống xây dựng. Trong các mô-đun Soong cc_* và java_*, trong đó các tệp .aidl được sử dụng trực tiếp trong srcs trong các bản dựng nền tảng Android, bạn có thể thêm thư mục bằng cách sử dụng trường aidl: { include_dirs: ... }. Để nhập bằng cách sử dụng aidl_interface, xem tại đây.

Lệnh nhập 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, bạn có thể bỏ qua gói đó. 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 là tất cả các loại phải là 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

Sau đây là ví dụ về giao diện AIDL:

    interface ITeleport {
        // Location defined elsewhere
        void teleport(Location baz, float speed);
        String getName();

        // ITeleportCallback defined elsewhere
        void methodWithCallback(ITeleportCallback callback);

        // ITeleportSession defined elsewhere
        ITeleportSession getASubInterface();
    }

Giao diện xác định một đối tượng bằng một loạt các phương thức. Bạn có thể dùng một trong hai phương thức 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ả các phương thức trong giao diện đó đều 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 các luồng khác nhau). Đối với thảo luận về cách thiết lập luồng, hãy xem luồng phần phụ trợ AIDL quản lý chiến dịch.

Binder cho phép chia sẻ nhiều giao diện và đối tượng liên kết thông qua giao diện liên kết. Giao diện AIDL thường sử dụng lệnh gọi lại trong các lệnh gọi phương thức, chẳng hạn như với ITeleportCallback trong ví dụ trước. Bạn có thể sử dụng lại lệnh gọi lại đối tượng giữa các lệnh gọi đến cùng một phương thức hoặc các lệnh gọi đến nhiều phương thức. Khác việc sử dụng các loại giao diện phổ biến là dành cho các giao diện phụ, đối tượng phiên được trả về từ các phương thức như với ITeleportSession trong ví dụ trước. Việc lồng nhau này cho phép nhiều API được đóng gói tại API hoặc dựa trên trạng thái thời gian chạy. Ví dụ: một phiên có thể thể hiện quyền sở hữu của một tài nguyên cụ thể. Khi giao diện được truyền nhiều lần hoặc trả về cho ứng dụng hoặc máy chủ mà chúng đến từ, giao diện luôn duy trì tính bằng nhau của con trỏ đối tượng liên kết cơ bản.

Các phương thức có thể không có hoặc có nhiều đối số. Đối số cho phương thức có thể là in, out hoặc inout. Để thảo luận về mức độ ảnh hưởng của việc này đến các loại đối số, xem Định hướng cho phần phụ trợ AIDL.

Theo gói

Để biết nội dung mô tả cách tạo các gói có thể phân phối dành riêng cho phần phụ trợ, hãy xem bài viết các gói có thể phân phối tuỳ chỉnh của phần phụ trợ AIDL.

Android 10 trở lên hỗ trợ các định nghĩa theo gói ngay trong AIDL. Loại 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 so với AIDL ổn định.

Ví dụ:

    package my.package;

    import my.package.Boo;

    parcelable Baz {
        @utf8InCpp String name = "baz";
        Boo boo;
    }

Liên minh

Android 12 trở lên hỗ trợ khai báo liên kết. 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 loại lồng nhau

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ố

Giao diện tuỳ chỉnh, thành phần có thể đóng gói và tập hợp AIDL cũng có thể chứa số nguyên và hằng số 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

Có thể chỉ định hằng số AIDL, kích thước mảng và giá trị liệt kê bằng hằng số biểu thức. 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ể sử dụng giá trị biểu thức hằng số với giá trị số nguyên hoặc số thực.

Giá trị cố định true và false đại diện 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. Các giá trị dấu phẩy động có hậu tố f, chẳng hạn như 2.4f. Giá trị số nguyê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ẽ nhận được loại đã ký có giá trị nhỏ nhất giữa 8 bit (byte), 32 bit (int) và 64 bit (long). Vì vậy, 256 được coi là int, nhưng 255 + 1 tràn thành byte 0. Giá trị hex (chẳng hạn như 0x3) được diễn giải trước tiên là kiểu không dấu bảo toàn giá trị nhỏ nhất từ 32 bit đến 64 bit và sau đó được diễn giải lại thành các giá trị chưa được ký. Vì vậy, 0xffffffff có giá trị int là -1. Kể từ Android 13, hậu tố u8 có thể là thêm vào hằng số, chẳng hạn như 3u8, để biểu thị giá trị byte. Hậu tố này là quan trọng để một phép tính, chẳng hạn như 0xffu8 * 3, sẽ được hiểu là -3 thuộc loại byte trong khi 0xff * 3 là 765 thuộc 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à + - ! ~.