AIDL言語は、大まかにJava言語に基づいています。ファイルは、インターフェイスコントラクトと、このコントラクトで使用されるさまざまなデータ型および定数を指定します。
パッケージ
すべてのAIDLファイルは、さまざまなバックエンドのパッケージ名に対応するオプションのパッケージで始まります。パッケージ宣言は次のようになります。
package my.package;
Javaと同様に、AIDLファイルはパッケージと一致するフォルダー構造内にある必要があります。パッケージmy.packageを含むファイルは、 my/package/フォルダーにある必要があります。
種類
AIDLファイルには、タイプを指定できる場所がたくさんあります。 AIDL言語でサポートされているタイプの正確なリストについては、 AIDLバックエンドタイプを参照してください。
注釈
AIDL言語のいくつかの部分は、注釈をサポートしています。注釈のリストとそれらを適用できる場所については、 AIDL注釈を参照してください。
輸入
他のインターフェースで定義されたタイプを使用するには、最初にビルドシステムに依存関係を追加する必要があります。 cc_*およびjava_* Soongモジュールでは、 .aidlファイルがAndroidプラットフォームビルドのsrcの直下で使用され、フィールドsrcs 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 void doFoo() onewayまたは同期のいずれかです。インターフェイスが一方向（一方向インターフェイスoneway oneway interface ITeleport {...} ）として定義されている場合、その中のすべてのメソッドは暗黙的にonewayです。一方向メソッドは非同期でディスパッチされ、結果を返すことはできません。同じスレッドから同じバインダーへの一方向のメソッドも、シリアルに実行されることが保証されています（ただし、異なるスレッドで実行される可能性があります）。スレッドの設定方法については、 AIDLバックエンドのスレッド管理を参照してください。
メソッドは0個以上の引数を持つことができます。メソッドの引数は、 in 、 out 、またはinoutにすることができます。これが引数の型にどのように影響するかについては、 AIDLバックエンドの方向性を参照してください。
パーセラブル
バックエンド固有のパーセラブルを作成する方法の説明については、AIDLバックエンドのカスタムパーセラブルを参照してください。
Android 10以降は、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;
}
列挙型
Android 11以降は、列挙型宣言をサポートしています。例えば：
package my.package;
enum Boo {
A = 1 * 4,
B = 3,
}
ネストされた型の宣言
Android T（AOSP実験的）以降は、ネストされた型の宣言をサポートします。例えば：
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値と見なされます。フロート値には、 2.4fなどのfサフィックスが付いています。 lまたはL接尾辞が付いた整数値は、64ビット長の値を示します。それ以外の場合、整数値は、8ビット（バイト）、32ビット（int）、および64ビット（long）の間で最小の値を保持する符号付き型を取得します。したがって、 256はintと見なされますが、 255 + 1がオーバーフローしてbyte 0になります。 0x3などの16進値は、最初に32ビットから64ビットまでの最小値を保持する符号なし型として解釈され、次に符号なし値として再解釈されます。したがって、 0xffffffffのint値は-1です。 Android T（AOSP実験的）以降、接尾辞u8を3u8などの定数に追加して、 byte値を表すことができます。この接尾辞は、 0xffu8 * 3などの計算がbyte型の-3として解釈されるのに対し、 0xff * 3はint型の765であるために重要です。
サポートされている演算子には、C++およびJavaのセマンティクスがあります。優先順位の低いものから高いものの順に、二項演算子は|| && | ^ & == != < > <= >= << >> + - * / %です。 || && | ^ & == != < > <= >= << >> + - * / % 。単項演算子は+ - ! ~ 。