ภาษา AIDL

ภาษา 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 โอเปอเรเตอร์ไบนารีจะเป็น || && | ^ & == != < > <= >= << >> + - * / % โดยเรียงลำดับจากความสำคัญต่ำสุดไปสูงสุด โอเปอเรเตอร์แบบรวมคือ + - ! ~