カーネルのビルド

このページでは、Android デバイス用にカスタムカーネルをビルドする手順について詳しく説明します。適切なソースを選択する手順、カーネルをビルドする手順、そのビルド結果を Android オープンソースプロジェクト（AOSP）ベースでビルドされたシステムイメージに埋め込む手順について以下で説明します。

最近のカーネルソースは、Repo を使用して取得することが可能で、ソースチェックアウトのルートから build/build.sh を実行することにより、追加構成を行うことなくビルドできます。

注: build/build.sh は、カーネルソースチェックアウトのルートにあります。Android ツリーには、ビルド済みのカーネルバイナリだけが含まれます。カーネルツリーには、カーネルソースと、カーネルをビルドするためのすべてのツール（上記のスクリプトを含む）が含まれます。

ソースとビルドツールをダウンロードする

最近のカーネルの場合、repo を使用してソース、ツールチェーン、ビルドスクリプトをダウンロードします。Pixel 3 カーネルなど、カーネルによっては、複数の Git リポジトリのソースが必要になることがあります。それ以外のカーネルの場合（共通カーネルなど）、必要なのは単一のソースだけです。repo アプローチを使用すると、ソースディレクトリを確実に正しくセットアップできます。

以下のコマンドで、適切なブランチのソースをダウンロードします。

mkdir android-kernel && cd android-kernel

repo init -u https://android.googlesource.com/kernel/manifest -b BRANCH

repo sync

前の「repo init」コマンドで使用できる Repo ブランチ（BRANCH）のリストの場合は、カーネルブランチとビルドシステムをご覧ください。

Google Pixel のカーネルのダウンロードとコンパイルの詳細については、Google Pixel カーネルのビルドをご覧ください。

注: 1 つの Repo チェックアウト内で異なるブランチに切り替えることができます。共通カーネルのマニフェスト（および他の大部分のカーネルのマニフェスト）は、シャロークローンではなくフルクローンの対象となるカーネル Git リポジトリを定義します。フルクローンを行うことで、ブランチ間を高速で切り替えられるようになります。別のブランチに切り替える手順はブランチを初期化する際の手順と同様で、-u パラメータは省略可能です。たとえば、既存の Repo チェックアウトから common-android-mainline に切り替えるには、次のコマンドを実行します。
$ repo init -b common-android-mainline && repo sync

カーネルをビルドする

Bazel（Kleaf）を使用してビルドする

Android 13 では、Bazel を使用したカーネルのビルドが導入されました。

aarch64 アーキテクチャ用の GKI カーネルをビルドするには、Android 13 以降の Android 共通カーネルのブランチをチェックアウトしてから、次のコマンドを実行します。

tools/bazel build //common:kernel_aarch64_dist

ディストリビューションを作成するには、次のコマンドを実行します。

tools/bazel run //common:kernel_aarch64_dist -- --dist_dir=$DIST_DIR

その後、カーネルのバイナリ、モジュール、対応するイメージが $DIST_DIR ディレクトリに配置されます。--dist_dir を指定していない場合のアーティファクトの場所については、コマンドの出力を参照してください。詳しくは、AOSP のドキュメントをご覧ください。

（以前の）build.sh を使用してビルドする

Android 12 以前のブランチ、または Kleaf のないブランチの場合:

build/build.sh

注: 共通カーネルはカスタマイズ可能な汎用カーネルであり、デフォルト構成を定義するものではありません。共通カーネル用のビルド構成を指定する方法については、カーネルビルドをカスタマイズするをご覧ください。たとえば、aarch64 プラットフォーム用の GKI カーネルをビルドするには、次のコマンドを実行します。
$ BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh

カーネルバイナリや、モジュール、対応するイメージは、out/BRANCH/dist ディレクトリにあります。

仮想デバイスのベンダーモジュールをビルドする

Android 13 では、build.sh に代わって Bazel を使用したカーネルのビルド（Kleaf）が導入されました。

virtual_device のモジュールをビルドするには、次のコマンドを実行します。

tools/bazel build //common-modules/virtual-device:virtual_device_x86_64_dist

ディストリビューションを作成するには、次のコマンドを実行します。

tools/bazel run //common-modules/virtual-device:virtual_device_x86_64_dist -- --dist_dir=$DIST_DIR

Bazel を使用した Android カーネルのビルドについて詳しくは、Kleaf - Building Android Kernels with Bazel（Kleaf - Bazel を使用したカーネルのビルド）をご覧ください。

個々のアーキテクチャにおける Kleaf のサポートの詳細については、各デバイスおよびカーネルでの Kleaf のサポートをご覧ください。

（以前の）build.sh を使用して仮想デバイスのベンダーモジュールをビルドする

Android 12 では Cuttlefish と Goldfish が「合流」するため、同じカーネル「virtual_device」を共有します。そのカーネルのモジュールをビルドするには、次のビルド構成を使用します。

BUILD_CONFIG=common-modules/virtual-device/build.config.virtual_device.x86_64 build/build.sh

Android 11 で導入された GKI により、カーネルは Google が管理するカーネルイメージとベンダーが管理するモジュールに分割され、別個にビルドされます。

この例では、カーネルイメージ構成を示しています。

BUILD_CONFIG=common/build.config.gki.x86_64 build/build.sh

この例では、モジュール設定（Cuttlefish とエミュレータ）を示しています。

BUILD_CONFIG=common-modules/virtual-device/build.config.cuttlefish.x86_64 build/build.sh

カーネルを実行する

カスタムビルドカーネルを実行する方法は複数あります。各種の開発シナリオに適した既存の方法を以下に示します。

Android イメージビルドに埋め込む

Image.lz4-dtb を AOSP ツリー内の各カーネルバイナリの場所にコピーして、ブートイメージを再ビルドします。

あるいは TARGET_PREBUILT_KERNEL 変数を定義して、make bootimage など、ブートイメージをビルドする make コマンドラインを使用する方法もあります。この変数は、device/common/populate-new-device.sh を通じてセットアップされるため、すべてのデバイスでサポートされます。たとえば、次のようになります。

export TARGET_PREBUILT_KERNEL=DIST_DIR/Image.lz4-dtb

fastboot を使用してカーネルをフラッシュしてブートする

最近のデバイスはブートローダー拡張機能を備えており、ブートイメージの生成とブートのプロセスが効率化されています。

フラッシュせずにカーネルをブートするには、以下のコマンドを使用します。

adb reboot bootloader
fastboot boot Image.lz4-dtb

この方法を使用した場合、カーネルはフラッシュされず、リブート後に保持されることもありません。

注: カーネル名はデバイスによって異なります。対象となるカーネルの正確なファイル名については、AOSP ツリー内の device/VENDOR/NAME-kernel をご覧ください。

Cuttlefish でカーネルを実行する

Cuttlefish デバイス上でカーネルを任意のアーキテクチャで実行できます。

特定のカーネルアーティファクトセットを使用して Cuttlefish デバイスを起動するには、ターゲットカーネルアーティファクトをパラメータとして指定して cvd start コマンドを実行します。次のコマンドの例は、common-android14-6.1 カーネルマニフェストから arm64 ターゲットのカーネルアーティファクトを使用しています。

cvd start \
    -kernel_path=/$PATH/$TO/common-android14-6.1/out/android14-6.1/dist/Image \
    -initramfs_path=/$PATH/$TO/common-android14-6.1/out/android14-6.1/dist/initramfs.img

詳しくは、Cuttlefish でカーネルを開発するをご覧ください。

カーネルビルドをカスタマイズする

Kleaf ビルドのカーネルビルドをカスタマイズするには、Kleaf のドキュメントをご覧ください。

注: Kleaf のビルドプロセスは通常、環境変数の影響は受けませんが、コマンドラインオプションと BUILD 定義には影響されます。

（以前の）build.sh でビルドされたカーネルをカスタマイズする

build/build.sh の場合、ビルドプロセスとビルド結果は、環境変数の影響を受けることがあります。環境変数のほとんどは省略可能であり、各カーネルブランチには適切なデフォルト構成が用意されています。主な環境変数のリストを以下に示します。最新の全リストについては、build/build.sh をご覧ください。

環境変数	説明	例
`BUILD_CONFIG`	ビルド環境の初期化を行うビルド構成ファイル。ビルドの場所は、Repo ルートディレクトリを基準とする相対パスで定義する必要があります。デフォルトは `build.config` です。共通カーネルでは必須です。	`BUILD_CONFIG=common/build.config.gki.aarch64`
`CC`	使用するコンパイラをオーバーライドします。`build.config` で定義されているデフォルトコンパイラにフォールバックします。	`CC=clang`
`DIST_DIR`	カーネル配布用のベース出力ディレクトリ。	`DIST_DIR=/path/to/my/dist`
`OUT_DIR`	カーネルビルドのベース出力ディレクトリ。	`OUT_DIR=/path/to/my/out`
`SKIP_DEFCONFIG`	`make defconfig` をスキップします。	`SKIP_DEFCONFIG=1`
`SKIP_MRPROPER`	`make mrproper` をスキップします。	`SKIP_MRPROPER=1`

ローカルビルド用のカスタムカーネル構成

Android 14 以降では、defconfig フラグメントを使用してカーネル構成をカスタマイズできます。defconfig フラグメントに関する Kleaf のドキュメントをご覧ください。

（以前の）ビルド構成を持つローカルビルド用のカスタムカーネル構成

Android 13 以前では、以下を参照してください。

機能の開発時など、カーネル構成オプションを定期的に切り替える必要がある場合や、開発上の目的でオプションを設定する必要がある場合は、ビルド構成をローカルレベルで編集したりコピーしたりすることで、そのような柔軟性を実現することができます。

POST_DEFCONFIG_CMDS 変数を、通常の make defconfig ステップの実行直後に評価されるステートメントに設定します。build.config ファイルはビルド環境に供給されるため、build.config 内で定義されている関数は post-defconfig コマンドの一部として呼び出すことができます。

たとえば、開発段階では、クロスハッチカーネルのリンク時最適化（LTO）を無効にすることができます。LTO はリリースカーネルにとってはメリットがありますが、ビルド時のオーバーヘッドは相当なものになります。以下のスニペットをローカル build.config に追加することで、build/build.sh の使用時に LTO を永続的に無効にできます。

POST_DEFCONFIG_CMDS="check_defconfig && update_debug_config"
function update_debug_config() {
    ${KERNEL_DIR}/scripts/config --file ${OUT_DIR}/.config \
         -d LTO \
         -d LTO_CLANG \
         -d CFI \
         -d CFI_PERMISSIVE \
         -d CFI_CLANG
    (cd ${OUT_DIR} && \
     make O=${OUT_DIR} $archsubarch CC=${CC} CROSS_COMPILE=${CROSS_COMPILE} olddefconfig)
}

カーネルバージョンを識別する

ビルドのための正しいバージョンは、AOSP ツリーとシステムイメージという 2 つのソースから識別できます。

AOSP ツリーのカーネルバージョン

AOSP ツリーには、ビルド済みのカーネルバージョンが含まれています。Git ログにより、commit メッセージの一部として正しいバージョンを確認できます。

cd $AOSP/device/VENDOR/NAME
git log --max-count=1

カーネルバージョンが Git ログに記載されていない場合は、下記で説明されているように、システムイメージから取得してください。

システムイメージのカーネルバージョン

システムイメージ内で使用されているカーネルバージョンを確認するには、カーネルファイルに対して次のコマンドを実行します。

file kernel

Image.lz4-dtb ファイルに対しては、次のコマンドを実行します。

grep -a 'Linux version' Image.lz4-dtb

ブートイメージをビルドする

カーネルのビルド環境を使用してブートイメージをビルドできます。

`init_boot` があるデバイスのブートイメージをビルドする

init_boot パーティションを備えたデバイスの場合、ブートイメージはカーネルとともにビルドされます。initramfs イメージは、ブートイメージには埋め込まれません。

たとえば、Kleaf で GKI ブートイメージをビルドするには、次のコマンドを使用します。

tools/bazel run //common:kernel_aarch64_dist -- --dist_dir=$DIST_DIR

（以前の）build/build.sh を使用する場合は、次のコマンドで GKI ブートイメージをビルドできます。

BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh

GKI ブートイメージは $DIST_DIR にあります。

（以前の）`init_boot` のないデバイスのブートイメージをビルドする

init_boot パーティションがないデバイスの場合は、RAM ディスクバイナリが必要です。これは、GKI ブートイメージをダウンロードして展開すると取得できます。関連する Android リリースの GKI ブートイメージであれば使用可能です。

tools/mkbootimg/unpack_bootimg.py --boot_img=boot-5.4-gz.img
mv $KERNEL_ROOT/out/ramdisk gki-ramdisk.lz4

ターゲットフォルダはカーネルツリーの最上位ディレクトリ（現在の作業ディレクトリ）です。

AOSP main を使用して開発している場合は、代わりに ci.android.com にある aosp_arm64 ビルドから ramdisk-recovery.img ビルドアーティファクトをダウンロードして、RAM ディスクバイナリとして使用できます。

取得した RAM ディスクバイナリをカーネルビルドのルートディレクトリにある gki-ramdisk.lz4 にコピーしたら、次のコマンドを実行してブートイメージを生成できます。

BUILD_BOOT_IMG=1 SKIP_VENDOR_BOOT=1 KERNEL_BINARY=Image GKI_RAMDISK_PREBUILT_BINARY=gki-ramdisk.lz4 BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh

x86 ベースのアーキテクチャを使用している場合は、Image を bzImage に、aarch64 を x86_64 にそれぞれ置き換えます。

BUILD_BOOT_IMG=1 SKIP_VENDOR_BOOT=1 KERNEL_BINARY=bzImage GKI_RAMDISK_PREBUILT_BINARY=gki-ramdisk.lz4 BUILD_CONFIG=common/build.config.gki.x86_64 build/build.sh

このファイルはアーティファクトディレクトリ $KERNEL_ROOT/out/$KERNEL_VERSION/dist にあります。

ブートイメージは out/<kernel branch>/dist/boot.img に生成されます。

カーネルのビルド

ソースとビルドツールをダウンロードする

カーネルをビルドする

Bazel（Kleaf）を使用してビルドする

（以前の）build.sh を使用してビルドする

仮想デバイスのベンダー モジュールをビルドする

（以前の）build.sh を使用して仮想デバイスのベンダー モジュールをビルドする

カーネルを実行する

Android イメージビルドに埋め込む

fastboot を使用してカーネルをフラッシュしてブートする

Cuttlefish でカーネルを実行する

カーネルビルドをカスタマイズする

（以前の）build.sh でビルドされたカーネルをカスタマイズする

ローカルビルド用のカスタム カーネル構成

（以前の）ビルド構成を持つローカルビルド用のカスタム カーネル構成

カーネル バージョンを識別する

AOSP ツリーのカーネル バージョン

システム イメージのカーネル バージョン

ブートイメージをビルドする

init_boot があるデバイスのブートイメージをビルドする

（以前の）init_boot のないデバイスのブートイメージをビルドする

仮想デバイスのベンダーモジュールをビルドする

（以前の）build.sh を使用して仮想デバイスのベンダーモジュールをビルドする

ローカルビルド用のカスタムカーネル構成

（以前の）ビルド構成を持つローカルビルド用のカスタムカーネル構成

カーネルバージョンを識別する

AOSP ツリーのカーネルバージョン

システムイメージのカーネルバージョン

`init_boot` があるデバイスのブートイメージをビルドする

（以前の）`init_boot` のないデバイスのブートイメージをビルドする