कर्नेल बनाना

इस पेज पर, 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

रेपो ब्रांच (BRANCH) की सूची देखने के लिए, जिसका इस्तेमाल पिछले नियम के साथ किया जा सकता है `repo init` कमांड, देखें Kernel ब्रांच और उनके बिल्ड सिस्टम.

Pixel डिवाइसों के लिए, कर्नेल डाउनलोड करने और उन्हें कंपाइल करने के बारे में जानने के लिए, Pixel के लिए कर्नेल बनाना लेख पढ़ें.

ध्यान दें: एक ही रिपॉज़िटरी के चेकआउट में, अलग-अलग शाखाओं के बीच स्विच किया जा सकता है. कॉन्टेंट बनाने सामान्य कर्नेल मेनिफ़ेस्ट (और ज़्यादातर कुछ) कर्नेल git रिपॉज़िटरी को तय करते हैं पूरी तरह से क्लोन किया जाना चाहिए (उथला नहीं), जो उनके बीच तेज़ी से स्विच करने में सक्षम बनाता है. किसी दूसरी शाखा पर स्विच करना, शाखा को शुरू करने जैसा ही है; -u पैरामीटर ज़रूरी नहीं है. उदाहरण के लिए, अपने मौजूदा Repo चेकआउट से common-android-mainline पर स्विच करने के लिए,
$ repo init -b common-android-mainline && repo sync चलाएं.

कर्नेल बनाना

Bazel (Kleaf) की मदद से बनाए गए

ध्यान दें: यह पता लगाने के लिए कि Kleaf का इस्तेमाल करके, कब कर्नेल को बनाया जा सकता है. साथ ही, निर्देश बनाए जा सकते हैं और कमांड, देखें Kernel ब्रांच और उनके बिल्ड सिस्टम.

Android 13 में, Bazel की मदद से कर्नेल बनाने की सुविधा जोड़ी गई है.

aarch64 आर्किटेक्चर के लिए GKI कर्नेल का डिस्ट्रिब्यूशन बनाने के लिए, Android 13 से पहले की किसी Android Common Kernel शाखा को देखें और फिर यह कमांड चलाएं:

tools/bazel run //common:kernel_aarch64_dist [-- --destdir=$DIST_DIR]

इसके बाद, कर्नेल बाइनरी, मॉड्यूल, और संबंधित इमेज $DIST_DIR डायरेक्ट्री. अगर --destdir की जानकारी नहीं दी गई है, तो आर्टफ़ैक्ट की जगह के लिए, कमांड का आउटपुट देखें. जानकारी के लिए, इसे देखें AOSP पर दस्तावेज़.

बिल्ड.sh (लेगसी) के साथ बनाएं

ध्यान दें: Build.sh, Android 14 और उसके बाद वाले वर्शन पर काम नहीं करता.

Android 12 या इससे पहले के वर्शन वाले ब्रांच के लिए, या बिना क्लीफ़ के शाखाएं:

build/build.sh

ध्यान दें: सामान्य कर्नेल, सामान्य और पसंद के मुताबिक बनाए जा सकने वाले कर्नेल होते हैं. इसलिए, इनमें डिफ़ॉल्ट कॉन्फ़िगरेशन तय नहीं किया जाता. आम केर्नेल के लिए, बिल्ड कॉन्फ़िगरेशन तय करने का तरीका जानने के लिए, केर्नेल बिल्ड को पसंद के मुताबिक बनाएं लेख पढ़ें. उदाहरण के लिए, aarch64 प्लैटफ़ॉर्म के लिए GKI कर्नेल बनाने के लिए, यह चलाएं:
$ BUILD_CONFIG=common/build.config.gki.aarch64 build/build.sh

कर्नेल बाइनरी, मॉड्यूल, और संबंधित इमेज out/BRANCH/dist डायरेक्ट्री.

वर्चुअल डिवाइस के लिए वेंडर मॉड्यूल बनाना

Android 13 में, इमारत बनाने में इस्तेमाल होने वाले कर्नेल के साथ build.sh की जगह बेज़ल (Kleaf).

virtual_device के मॉड्यूल के लिए डिस्ट्रिब्यूशन बनाने के लिए, इसे चलाएं:

tools/bazel run //common-modules/virtual-device:virtual_device_x86_64_dist [-- --destdir=$DIST_DIR]

Bazel की मदद से Android के कर्नेल बनाने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें. Kleaf - Bazel की मदद से Android के कर्नेल बनाना.

अलग-अलग आर्किटेक्चर के लिए Kleaf की सहायता के बारे में जानने के लिए, डिवाइसों और कर्नेल के लिए Kleaf की सहायता लेख देखें.

build.sh (लेगसी) की मदद से, वर्चुअल डिवाइस के लिए वेंडर मॉड्यूल बनाना

Android 12 में, कटलफ़िश और गोल्डफ़िश एक साथ काम करते हैं. इसलिए, वे एक ही कर्नेल का इस्तेमाल करते हैं: 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 और Emulator) दिखाया गया है:

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

फ़ास्टबूट के साथ फ़्लैश और बूट कर्नेल

ज़्यादातर नए डिवाइसों में बूटलोडर एक्सटेंशन होता है. इससे बूट इमेज को जनरेट करने और बूट करने की प्रोसेस को आसान बनाया जाता है.

फ़्लैश किए बिना कर्नेल को बूट करने के लिए:

adb reboot bootloader
fastboot boot Image.lz4-dtb

इस तरीके का इस्तेमाल करने पर, कर्नेल को असल में फ़्लैश नहीं किया जाता. साथ ही, रीबूट करने पर यह बरकरार नहीं रहेगा.

ध्यान दें: कर्नेल के नाम, डिवाइस के हिसाब से अलग-अलग होते हैं. अपने कर्नेल के लिए सही फ़ाइल का नाम ढूंढने के लिए, device/VENDOR/NAME-kernel AOSP ट्री

देखें.

Cuttlefish पर कर्नेल चलाना

आप इस पर अपनी पसंद के आर्किटेक्चर में कर्नेल चला सकते हैं कटलफ़िश डिवाइस.

कर्नेल के एक खास सेट वाले कटलफ़िश डिवाइस को चालू करने के लिए आर्टफ़ैक्ट में, cvd create कमांड को टारगेट कर्नेल आर्टफ़ैक्ट के साथ इस तरह चलाएं पैरामीटर का इस्तेमाल करें. नीचे दिए गए उदाहरण कमांड, common-android14-6.1 कर्नेल मेनिफ़ेस्ट.

cvd create \
    -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	वह कॉन्फ़िगरेशन फ़ाइल जिससे बिल्ड एनवायरमेंट को शुरू किया जाता है. जगह की जानकारी, रेपो रूट के हिसाब से होनी चाहिए डायरेक्ट्री. डिफ़ॉल्ट तौर पर, यह 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 दस्तावेज़ देखें.

ध्यान दें: Kleaf के लिए एलटीओ सेटिंग में बदलाव करने के लिए, --lto कमांड लाइन के विकल्प का इस्तेमाल करें.

बिल्ड कॉन्फ़िगरेशन (लेगसी) के साथ स्थानीय बिल्ड के लिए कस्टम कर्नेल कॉन्फ़िगरेशन

Android 13 और उससे पहले के वर्शन में, यह तरीका अपनाएं.

अगर आपको कर्नेल कॉन्फ़िगरेशन विकल्प को नियमित रूप से स्विच करने की ज़रूरत पड़ती है, तो उदाहरण के लिए, या आपको डेवलपमेंट के लिए सेट किए जाने का विकल्प चाहिए, तो का पालन किया है, तो आप अपने स्थानीय स्तर पर बिल्ड कॉन्फ़िगरेशन में बदलाव किया जा सकता है या उसकी कॉपी बनाई जा सकती है.

वैरिएबल POST_DEFCONFIG_CMDS को ऐसे स्टेटमेंट पर सेट करें जिसका आकलन, make defconfig चरण पूरा होने के तुरंत बाद किया जाता है. build.config फ़ाइलों को बिल्ड एनवायरमेंट में सोर्स किया जाता है. इसलिए, build.config में तय किए गए फ़ंक्शन को पोस्ट-defconfig कमांड के हिस्से के तौर पर कॉल किया जा सकता है.

इसका एक सामान्य उदाहरण क्रॉसहैच के लिए लिंक टाइम ऑप्टिमाइज़ेशन (एलटीओ) को बंद करना है कर्नेल के तौर पर जोड़ा गया है. रिलीज़ किए गए कर्नेल के लिए एलटीओ फ़ायदेमंद है, लेकिन बिल्ड के समय ज़्यादा समय लग सकता है. यह स्निपेट जोड़ा गया को लोकल build.config में सेट करने से, एलटीओ लगातार बंद हो जाता है. ऐसा तब होता है, जब build/build.sh का इस्तेमाल करके.

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)
}

kernel वर्शन की पहचान करना

बिल्ड करने के लिए सही वर्शन की पहचान, दो सोर्स से की जा सकती है: AOSP ट्री और सिस्टम इमेज.

AOSP ट्री से मिला Kernel वर्शन

AOSP ट्री में, पहले से बने कर्नेल वर्शन मौजूद होते हैं. git लॉग में, कमिट मैसेज के हिस्से के तौर पर सही वर्शन दिखता है:

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

अगर git लॉग में कर्नेल वर्शन मौजूद नहीं है, तो उसे सिस्टम इमेज से पाएं. इसके लिए, यहां दिया गया तरीका अपनाएं.

सिस्टम इमेज से Kernel वर्शन

किसी सिस्टम इमेज में इस्तेमाल किए गए कर्नेल वर्शन का पता लगाने के लिए, कर्नेल फ़ाइल के लिए यह कमांड चलाएं:

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 [-- --destdir=$DIST_DIR]

build/build.sh (लेगसी) की मदद से, GKI बूट इमेज को इनके साथ बनाया जा सकता है:

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

जीकेआई की बूट इमेज $DIST_DIR में मौजूद है.

init_boot (लेगसी) के बिना डिवाइसों के लिए बूट इमेज बनाना

जिन डिवाइसों में init_boot पार्टीशन नहीं है उनके लिए, आपको रैमडिस्क बाइनरी की ज़रूरत होगी. इसे पाने के लिए, GKI बूट इमेज डाउनलोड करें और उसे अनपैक करें. इस ऐप्लिकेशन से जुड़ी Android रिलीज़ से ली गई, Gकेआई की बूट इमेज काम करेगी.

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

टारगेट फ़ोल्डर, कर्नेल ट्री (मौजूदा) की टॉप-लेवल की डायरेक्ट्री है जॉबिंग डायरेक्ट्री).

अगर आपको एओएसपी मुख्य के साथ डेवलप किया जा रहा है, तो आपके पास ramdisk-recovery.img, aosp_arm64 बिल्ड से जुड़ा आर्टफ़ैक्ट बनाता है ci.android.com पर जाकर, उसे अपने रैम डिस्क बाइनरी के तौर पर इस्तेमाल करें.

जब आपके पास ramdisk बाइनरी हो और आपने उसे kernel build की रूट डायरेक्ट्री में 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 पर मौजूद है.