GKI मॉड्यूल का पार्टीशन लागू करना

GKI और GKI मॉड्यूल को बाकी पार्टिशन से अलग से अपडेट किया जा सकता है, क्योंकि GKI मॉड्यूल, सुपर इमेज में system_dlkm नाम के एक अलग डाइनैमिक पार्टिशन में मौजूद होते हैं. Google, कर्नेल के बिल्ड टाइम पासकोड पेयर का इस्तेमाल करके, जीकेआई मॉड्यूल पर हस्ताक्षर करता है. ये मॉड्यूल सिर्फ़ उसी जीकेआई के साथ काम करते हैं जिसके साथ इन्हें बनाया गया है. GKI और GKI मॉड्यूल के बीच एबीआई स्थिर नहीं है. रनटाइम के दौरान मॉड्यूल सही तरीके से लोड होने के लिए, GKI और GKI मॉड्यूल को एक साथ बनाया और अपडेट किया जाना चाहिए.

system_dklm पार्टिशन के लिए सहायता लागू करना

system_dlkm पार्टिशन, सुपर पार्टिशन में एक और डाइनैमिक पार्टिशन के तौर पर मौजूद होता है. इस पार्टीशन में ये चीज़ें शामिल हो सकती हैं:

  • Google के बनाए गए ऐसे कर्नेल मॉड्यूल जिन्हें बिल्ड के समय साइन किया गया है
  • depmod सह-उत्पाद

बिल्‍ड system_dlkm

system_dlkm बनाना, अन्य डाइनैमिक पार्टिशन बनाने जैसी ही प्रक्रिया है. अपने बिल्ड में system_dlkm जोड़ने के लिए, यह तरीका अपनाएं:

  1. BoardConfig.mk में, ये एंट्री जोड़ें:

    BOARD_USES_SYSTEM_DLKMIMAGE := true
BOARD_SYSTEM_DLKMIMAGE_FILE_SYSTEM_TYPE := $(TARGET_RO_FILE_SYSTEM_TYPE)
TARGET_COPY_OUT_SYSTEM_DLKM := system_dlkm

  2. पार्टीशन की सूची में, system_dlkm जोड़ें: BOARD_GOOGLE_SYSTEM_DYNAMIC_PARTITIONS_PARTITION_LIST := system_dlkm

  3. (ज़रूरी नहीं) A/B और वर्चुअल A/B डिवाइसों के लिए, अपने डिवाइस की device.mk फ़ाइल में यह लाइन जोड़ें:

    AB_OTA_PARTITIONS += system_dlkm

system_dlkm में कॉपी करने के लिए कर्नेल मॉड्यूल की पहचान करना

रनटाइम के दौरान मॉड्यूल सही तरीके से लोड हो सकें, इसके लिए GKI और GKI मॉड्यूल को एक साथ बनाया जाना चाहिए. इसलिए, आपको टारगेट आर्किटेक्चर के लिए GKI बिल्ड में कर्नेल मॉड्यूल की पहचान करनी होगी. साथ ही, प्लैटफ़ॉर्म बिल्ड के दौरान, system_dlkm पार्टिशन के लिए सोर्स के तौर पर उसे उपलब्ध कराना होगा.

Android 13 के लिए

BOARD_SYSTEM_DLKM_SRC को उस फ़ोल्डर पर ले जाएं जिसमें डिवाइस के लिए ज़रूरी GKI मॉड्यूल के साथ-साथ, system_dlkm पार्टीशन जनरेट करने के लिए, बिल्ड सिस्टम के इनपुट के तौर पर कर्नेल ऑब्जेक्ट फ़ाइलें मौजूद हों. उदाहरण के लिए:

GKI मॉड्यूल का सोर्स किसी फ़ोल्डर में दें और BOARD_SYSTEM_DLKM_SRC को उस फ़ोल्डर पर ले जाएं. उदाहरण के लिए:

  BOARD_SYSTEM_DLKM_SRC := kernel/prebuilts/5.10/arm64/system_dlkm_staging

बिल्ड के समय, BOARD_SYSTEM_DLKM_SRC में दिए गए मॉड्यूल, $ANDROID_PRODUCT_OUT/system_dlkm में इंस्टॉल किए जाते हैं.

Android 14 के लिए

हमने अन्य *_dlkm पार्टीशन के लिए इस्तेमाल किए जा रहे मैक्रो (BOARD_*_KERNEL_MODULES) के साथ, लागू करने की प्रोसेस को आसान बनाया है. डिवाइस के लिए ज़रूरी GKI मॉड्यूल की सूची का रेफ़रंस, BOARD_SYSTEM_KERNEL_MODULES मैक्रो से दिया जाना चाहिए. बिल्ड के समय ये मॉड्यूल, $ANDROID_PRODUCT_OUT/system_dlkm में इंस्टॉल किए जाते हैं. vendor_dlkm सेगमेंट में मौजूद कोई भी मॉड्यूल, system_dlkm सेगमेंट में मौजूद मॉड्यूल पर निर्भर करता है. यह vendor_dlkm सेगमेंट के लिए, modules.dep फ़ाइल में सही रेफ़रंस जनरेट करता है. modules.dep से दिखाए गए क्रॉस-पार्टिशन डिपेंडेंसी की वजह से, जब कोई वेंडर मॉड्यूल लोड होता है, तो ज़रूरी GKI मॉड्यूल अपने-आप लोड हो जाता है.

उदाहरण के लिए, पहले से बने GKI arm64 कर्नेल 5.15 के लिए, system_dlkm पार्टिशन पर सभी GKI मॉड्यूल इंस्टॉल करने के लिए:

 BOARD_SYSTEM_KERNEL_MODULES := $(wildcard kernel/prebuilts/5.15/arm64/*.ko)

रनटाइम पर system_dlkm को माउंट करना

रीड-ओनली फ़ाइल सिस्टम के तौर पर इस्तेमाल किए जा रहे फ़ाइल सिस्टम के आधार पर, system_dlkm पार्टिशन को रनटाइम पर माउंट करने के लिए, अपने fstab में ये चीज़ें जोड़ें:

ext4 को सिर्फ़ पढ़ने वाले फ़ाइल सिस्टम के तौर पर

  system_dlkm /system_dlkm ext4 noatime,ro,errors=panic wait,logical,first_stage_mount,slotselect,avb

erofs को सिर्फ़ पढ़ने वाले फ़ाइल सिस्टम के तौर पर

  system_dlkm /system_dlkm erofs ro wait,logical,first_stage_mount,slotselect,avb

पार्टीशन को माउंट करना और मॉड्यूल लोड करना

first_stage_init के दौरान, system_dlkm पार्टीशन को /system_dlkm में, सिर्फ़ पढ़ने के लिए फ़ाइल सिस्टम के तौर पर माउंट किया जाता है. माउंट होने के बाद, /system/lib/modules पर /system_dlkm/lib/modules पर ले जाने वाले सिंबल लिंक उपलब्ध होते हैं.

इसके बाद, .rc स्क्रिप्ट जैसी वेंडर प्रोसेस, modules.load में बताए गए क्रम के आधार पर कर्नेल मॉड्यूल लोड कर सकती है. मॉड्यूल लोड करने के लिए, वेंडर प्रोसेस को सिंबल लिंक /system/lib/modules का इस्तेमाल करना होगा. अगर ज़रूरी हो, तो वेंडर प्रोसेस बाद में भी मॉड्यूल लोड कर सकती है.

SELinux

system_dlkm पार्टीशन में मौजूद हर फ़ाइल को system_dlkm_file के फ़ाइल कॉन्टेक्स्ट के साथ लेबल किया गया है. system_dlkm पार्टिशन में GKI मॉड्यूल फ़ाइल को लोड करने के लिए, मॉड्यूल लोड करने वाली वेंडर प्रोसेस को वेंडर डोमेन में sepolicy की ज़रूरत होती है.

उदाहरण के लिए, GKI मॉड्यूल लोड करने के लिए Cuttlefish का इस्तेमाल करने वाले dlkm_loader के पास, shared/sepolicy/vendor/dlkm_loader.te पर मौजूद नीति फ़ाइल में ये अनुमतियां हैं:

allow dlkm_loader self:capability sys_module;
allow dlkm_loader system_dlkm_file:dir r_dir_perms;
allow dlkm_loader system_dlkm_file:file r_file_perms;
allow dlkm_loader system_dlkm_file:system module_load;

system-dlkm पार्टीशन की पुष्टि करना

system_dlkm पार्टिशन की पुष्टि करने के लिए, Google एक GKI VTS टेस्ट केस उपलब्ध कराता है. जांच को मैन्युअल तरीके से शुरू करने के लिए, atest कमांड का इस्तेमाल करें:

  atest -c vts_dlkm_partition_test