開發Android內核

本頁介紹如何在 Cuttlefish 裝置上開發 Android 核心。

支援的核心清單

Cuttlefish 在主要版本和 AOSP GSI 版本上支援以下核心清單。

  • aosp-main
    • common-android14-6.1
    • common-android14-5.15
    • common-android-mainline
  • aosp-android13-gsi
    • common-android13-5.15
    • common-android13-5.10
  • aosp-android12-gsi
    • common-android12-5.10
    • common-android12-5.4
    • common-android-4.19-stable
  • aosp-android11-gsi
    • common-android11-5.4
    • common-android-4.19-stable
    • common-android-4.14-stable

以下是 Cuttlefish 裝置上核心開發的核心來源。

開發Android內核

要在 Cuttlefish 設備上開發內核,請按照以下步驟操作:

  1. 克隆適合您的 Cuttlefish 裝置的核心儲存庫清單並進行任何更改。

    mkdir common-android14-6.1
    cd common-android14-6.1
    repo init -u https://android.googlesource.com/kernel/manifest -b common-android14-6.1
    repo sync -c -j$(nproc) -q
    
  2. 建構核心和虛擬磁碟。有關更多信息,請參閱構建虛擬設備的供應商模組

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

    如果使用common-android-4.19-stablecommon-android-4.14-stablecommon-android11-5.4核心清單,請執行:

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

    您可以在 ci.android.com 下載相關工件,而不是在本機建置(以避免下載核心原始碼、設定核心開發環境)。

  3. 使用 Cuttlefish 啟動核心和 ramdisk。

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

    如果啟動非 GKI 核心(4.19 或以下的任何核心),請省略-initramfs_path參數。

    如果您在 aarch64 版本的 Cuttlefish 上啟動內核,請使用aarch64建立配置並使用Image工件而不是bzImage

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