Google Pixel カーネルのビルド

このガイドは開発用にカスタムの Google Pixel カーネルをダウンロードし、コンパイルして書き込む方法について説明した手順ガイドです。GKI により、カーネルを Android プラットフォーム ビルドから独立してアップデートできるようになりました。このステップは Google Pixel 6 以降のデバイスのみが対象です。Google Pixel 5 以前のデバイスでは、vendor パーティションのカーネル モジュールをアップデートする必要があり、それはそのデバイスの Android プラットフォーム ビルドに依存します。GKI がサポートする Google Pixel カーネル ブランチの表には、GKI がサポートされている各 Google Pixel デバイスのカーネル リポジトリ マニフェスト ブランチが含まれています。Google Pixel 5 以前のカーネル マニフェスト ブランチについては、レガシーの Google Pixel カーネルのセクションをご覧ください。

GKI がサポートされている Google Pixel カーネル ブランチ

Google Pixel 6 と Google Pixel 6 Pro デバイスでは、出荷時にサポートされているカーネルに加えて、GKI 開発目的でのみ、サポートされている Google Pixel 6 / 6 Pro の Android プラットフォームとカーネルの組み合わせの表に記載の Android 共通カーネル ブランチをサポートしています。Android プラットフォーム HAL と Google Pixel カーネル ドライバでは、ベンダー UAPI に違いがあるため、表ではサポートされているビルドの組み合わせを示しています。

サポートされている Google Pixel 6 / 6 Pro の Android プラットフォームとカーネルの組み合わせ

Google Pixel デバイスの準備

以下のフローチャートは Google Pixel 6 以降のデバイスでカーネルをアップデートするプロセスを示しています。

flash.android.com を使ってデバイスに書き込む

1. flash.android.com に移動します。
2. サポートされている Android プラットフォームとカーネルの組み合わせに従って、Android ビルドを選択します。
3. 以下のオプションを選択します。
   • Wipe Device
   • Force Flash all Partitions
   • Disable Verification
4. [Install build] ボタンをクリックして、デバイスに書き込みます。

カーネルのダウンロードとコンパイル

カーネル リポジトリを同期する

次のコマンドを実行して、カーネル ソースコードをダウンロードします。Google Pixel の KERNEL_MANIFEST_BRANCH についてはサポートされている Google Pixel 6 / 6 Pro の Android プラットフォームとカーネルの組み合わせの表をご参照ください。

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

repo sync -c --no-tags

ベンダー RAM ディスクをアップデートする

カーネル リポジトリの vendor_ramdisk-DEVICE.img ファイルをアップデートして、デバイスに書き込む Android プラットフォーム ビルドと一致させます。その方法には次のオプションがあります。

オプション 1）Google Pixel のファクトリー イメージからベンダー RAM ディスク イメージを抽出します。

1. デバイスでサポートされているファクトリー イメージを https://developers.google.com/android/images?hl=ja からダウンロードします。

2. vendor_boot.img を抽出します。

   • 次のコマンドは Google Pixel 6 Pro の AP1A.240505.004 を例として使っています。Zip ファイル名をダウンロードしたファクトリー イメージのファイル名に変更してください。

     unzip raven-ap1a.240505.004-factory-9d783215.zip
   

     cd raven-ap1a.240505.004
   

     unzip image-raven-ap1a.240505.004.zip vendor_boot.img
   

3. vendor_boot.img を展開して、ベンダー RAM ディスクを取得します。

     KERNEL_REPO_ROOT/tools/mkbootimg/unpack_bootimg.py --boot_img vendor_boot.img \
         --out vendor_boot_out
   

4. 解凍した vendor-ramdisk-by-name/ramdisk_ ファイルを Google Pixel カーネル リポジトリにコピーします。

   デバイス	DEVICE_RAMDISK_PATH
   Google Pixel 6（Oriole） Google Pixel 6 Pro（Raven）	prebuilts/boot-artifacts/ramdisks/vendor_ramdisk-oriole.img
   Google Pixel 6a（Bluejay）	private/devices/google/bluejay/vendor_ramdisk-bluejay.img

     cp vendor_boot_out/vendor-ramdisk-by-name/ramdisk_ \
         KERNEL_REPO_ROOT/DEVICE_RAMDISK_PATH
   

オプション 2）ローカルで作成された Android プラットフォーム リポジトリから vendor_ramdisk をコピーします。

cp ANDROID_ROOT/out/target/product/DEVICE/vendor_ramdisk-debug.img \
   KERNEL_REPO_ROOT/DEVICE_RAMDISK_PATH/vendor_ramdisk-DEVICE.img

カーネル（Kleaf）をコンパイルする

Android 13 では、build.sh スクリプトは新しいカーネル ビルドシステムである Kleaf に変更されています。android13-5.15 以降を使用しているデバイスの場合、カーネルは Kleaf を使用して作成する必要があります。

android14 以降のカーネルを使用した Google Pixel 6 および 6 Pro では、次の Kleaf ビルドコマンドを実行します。

tools/bazel run --config=fast --config=stamp //private/google-modules/soc/gs:slider_dist

android13-5.15 カーネルを使用した Google Pixel 6 および 6 Pro では、次の Kleaf ビルドコマンドを実行します。

tools/bazel run --lto=thin //gs/google-modules/soc-modules:slider_dist

その他のすべての Google Pixel カーネルでは、KERNEL_REPO_ROOT にある build_DEVICE.sh スクリプトを実行します。多くの場合、DEVICE は、GKI がサポートする Google Pixel カーネル ブランチの表の AOSP ツリーのバイナリパス列で使われているコードネームと一致するコードネームである必要があります。コードネームには、1 つのデバイスのコードネーム（例: 「akita」（Google Pixel 8a））か、カーネルが同じである関連デバイスのグループを指すコードネーム（例: 「caimito」（Google Pixel 9（tokay）、Google Pixel 9 Pro（caiman）、Google Pixel 9 Pro XL（komodo）を指す））を使用できます。android14 以前のリリースでは、Google Pixel 6 および Google Pixel 6 Pro に build_slider.sh を、Google Pixel 7 および Google Pixel 7 Pro に build_cloudripper.sh を使用します。

たとえば、android-gs-raviole-5.10-android14 ブランチで Google Pixel 6 のカーネルをビルドするには、次のコマンドを実行します。

build_slider.sh

デフォルトでは、build_DEVICE.sh スクリプトでビルド済みの GKI カーネルを使用して、ビルドプロセスをスピードアップします。コアカーネルを変更する場合は、ローカルソースからカーネルをビルドするように環境変数 BUILD_AOSP_KERNEL=1 を設定します。

カーネル ビルドシステムの詳細とビルドのカスタマイズ方法については、Kleaf - Building Android Kernels with Bazel（Kleaf - Bazel を使用したカーネルのビルド）をご覧ください。

カーネル イメージを書き込む

注: 確認を無効にしていない場合は、カスタム カーネルを書き込む前に無効にする必要があります。以下はそれを行うためのコマンドです。

fastboot oem disable-verification

警告: プラットフォーム ビルドの上からカスタム カーネルを書き込むときは、新しいカーネルに関連するセキュリティ パッチレベル（SPL）のダウングレードがある場合、デバイスをワイプしなければならない可能性があります。 このプロセスを実行するとすべての個人データが消去されます。ワイプする前に必ずデータをバックアップしてください。

fastboot -w

カーネル イメージを書き込むには、デバイスにリストされているそれぞれのカーネル パーティションに対して、fastboot flash コマンドを実行します。動的パーティションの場合、書き込み前に fastbootd モードで再起動する必要があります。

以下は android-mainline での Google Pixel 6 の書き込みコマンドです。

fastboot flash boot        out/slider/dist/boot.img
fastboot flash dtbo        out/slider/dist/dtbo.img
fastboot flash vendor_boot out/slider/dist/vendor_boot.img
fastboot reboot fastboot
fastboot flash vendor_dlkm out/slider/dist/vendor_dlkm.img

カーネル イメージは DIST_DIR にあります。

注: シリアル ドングルがあり、シリアルログを有効にする場合のコマンドは以下のとおりです。

fastboot oem uart enable
fastboot oem uart config 3000000

ホストから接続するコマンドの例は以下のとおりです。

screen -fn /dev/ttyUSB* 3000000

ファクトリー イメージを復元する

デバイスをファクトリー イメージに戻すには、flash.android.com を使用します。

以前の Google Pixel カーネル

参考として、以前の Google Pixel カーネル ブランチの表では、Google Pixel 5 以前のデバイスのカーネル リポジトリ ブランチを示しています。GKI がサポートされているデバイスはありません。

以前の Google Pixel カーネル ブランチ