VNDK の有効化

VNDK では、ベンダーとシステムを切り離して扱うために、コードベースにいくつかの変更が必要です。ベンダーまたは OEM のコードベースで VNDK を有効にするには、以下のガイドをご覧ください。

ビルドシステムライブラリ

ビルドシステムには、ライブラリ（共有、静的、ヘッダー）やバイナリなど、数種類のオブジェクトが含まれています。

図 1. ビルドシステムライブラリ

core ライブラリは、システムイメージ上でシステムイメージによって使用されます。このライブラリが vendor ライブラリ、vendor_available ライブラリ、vndk ライブラリ、vndk-sp ライブラリによって使用されることはありません。
```
cc_library {
    name: "libThatIsCore",
    ...
}
```
vendor-only（または proprietary）ライブラリは、ベンダーイメージ上でベンダーイメージによって使用されます。
```
cc_library {
    name: "libThatIsVendorOnly",
    proprietary: true,
    # or: vendor: true, # (for things in AOSP)
    ...
}
```
vendor_available ライブラリは、ベンダーイメージ上でベンダーイメージによって使用されます（core の重複が含まれている場合があります）。
```
cc_library {
    name: "libThatIsVendorAvailable",
    vendor_available: true,
    ...
}
```

vndk ライブラリは、システムイメージ上でベンダーイメージによって使用されます。

cc_library {
    name: "libThatIsVndk",
    vendor_available: true,
    vndk: {
        enabled: true,
    }
    ...
}

vndk-sp ライブラリは、ベンダーイメージだけでなく、システムイメージによっても間接的に使用されます。

cc_library {
    name: "libThatIsVndkSp",
    vendor_available: true,
    vndk: {
        enabled: true,
        support_system_process: true,
    }
    ...
}

llndk ライブラリは、システムイメージとベンダーイメージの両方によって使用されます。
```
cc_library {
    name: "libThatIsLlndk",
    llndk: {
        symbol_file: "libthatisllndk.map.txt"
    }
    ...
}
```

lib が vendor_available:true としてマークされている場合は、次のように 2 回ビルドされます。

プラットフォーム用に 1 回（その後 /system/lib にインストールされます）
ベンダー用に 1 回（その後 /vendor/lib または VNDK APEX にインストールされます）

lib のベンダーバージョンは、-D__ANDROID_VNDK__ とともにビルドされます。Android の今後のバージョンで大幅に変更される可能性のある非公開システムコンポーネントは、このフラグで無効になります。さらに、各ライブラリがそれぞれ異なるセットのヘッダー（liblog など）をエクスポートします。ターゲットのベンダーバリアントに固有のオプションは、以下にある Android.bp ファイルで指定できます。

target: { vendor: { … } }

コードベースの VNDK の有効化

コードベースの VNDK を有効化するには:

vendor.img パーティションと system.img パーティションの必須サイズを計算して対象となるかどうかを判断します。
BOARD_VNDK_VERSION=current を有効にします。BoardConfig.mk に追加することも、コンポーネントとともに直接ビルドすることもできます（例: m -j BOARD_VNDK_VERSION=current MY-LIB）。

ビルドシステムは、BOARD_VNDK_VERSION=current を有効にした後、以下の依存関係とヘッダーの要件を適用します。

依存関係の管理

vndk に存在しない、または vendor オブジェクトとして存在しない core コンポーネントに依存する vendor オブジェクトは、次のいずれかのオプションを使用して解決する必要があります。

依存関係は削除できます。
vendor が core コンポーネントを所有する場合は、vendor_available または vendor としてマークすることが可能です。
vndk のコアオブジェクト部分の変更は、Google に送信される可能性があります。

さらに、core コンポーネントが vendor コンポーネントに依存している場合、vendor コンポーネントを core コンポーネントにするか、または依存関係を別の方法で解消する必要があります（たとえば、依存関係を削除する、または依存関係を vendor コンポーネントに移動する）。

ヘッダーの管理

ヘッダーのビルドに -D__ANDROID_VNDK__ を使用するかしないかをビルドシステムが把握できるようにするには、グローバルヘッダーの依存関係を解消する必要があります。たとえば、utils/StrongPointer.h のような libutils ヘッダーは、ヘッダーライブラリ libutils_headers を使用して引き続きアクセスできます。

一部のヘッダー（unistd.h など）は、推移的に含めることはできなくなりましたが、ローカルに含めることができます。

最後に、private/android_filesystem_config.h の公開部分は cutils/android_filesystem_config.h に移動しました。これらのヘッダーを管理するには、次のいずれかの操作を行います。

可能な場合、すべての AID_* マクロを getgrnam または getpwnam の呼び出しに置き換えて、private/android_filesystem_config.h への依存関係を解消します。次に例を示します。
- (uid_t)AID_WIFI を getpwnam("wifi")->pw_uid に変更します。
- (gid_t)AID_SDCARD_R を getgrnam("sdcard_r")->gr_gid に変更します。
詳細については private/android_filesystem_config.h をご覧ください。
ハードコードされた AIS の場合は、cutils/android_filesystem_config.h を含めます。

VNDK の有効化

ビルドシステム ライブラリ

コードベースの VNDK の有効化

依存関係の管理

ヘッダーの管理

ビルドシステムライブラリ