डाइनैमिक पार्टीशन वाले A/B डिवाइसों के लिए OTA

Android 10 में डाइनैमिक पार्टिशन की सुविधा काम करती है. यह एक यूज़रस्पेस पार्टिशन सिस्टम है, जो ओवर-द-एयर (ओटीए) अपडेट के दौरान पार्टिशन बना सकता है, उनका साइज़ बदल सकता है, और उन्हें मिटा सकता है.

इस पेज पर, डाइनैमिक पार्टीशन की सुविधा के साथ लॉन्च किए गए A/B डिवाइसों के लिए, अपडेट के दौरान डाइनैमिक पार्टीशन का साइज़ बदलने का तरीका बताया गया है. यह तरीका, Android 9 और इससे पहले के वर्शन वाले डिवाइसों के लिए है.

बैकग्राउंड

डिवाइस पर एक super पार्टीशन हो. इस पार्टीशन में स्लॉट सफ़िक्स नहीं है. ब्लॉक किया गया डिवाइस, fstab में /misc के लिए blk_device एंट्री के साथ मौजूद होना चाहिए. उदाहरण के लिए, अगर fstab फ़ाइल में ये शामिल हैं:

/dev/block/bootdevice/by-name/misc    /misc    # Other fields

इसके बाद, super के लिए ब्लॉक डिवाइस, /dev/block/bootdevice/by-name/super में मौजूद होना चाहिए. हालांकि, super पार्टीशन को fstab फ़ाइल में शामिल करने की ज़रूरत नहीं है.

super पार्टिशन में, दो मेटाडेटा स्लॉट होते हैं. इनका नंबर 0 और 1 होता है. ये स्लॉट, पार्टिशन के A/B स्लॉट से जुड़े होते हैं. इस पेज में, मेटाडेटा स्लॉट को 'मेटाडेटा S (सोर्स)' और 'मेटाडेटा T (टारगेट)' कहा जाता है. इसी तरह, पार्टीशन को system_s, vendor_t वगैरह कहा जाता है.

अपग्रेड से पहले, मेटाडेटा S में इस्तेमाल किए जा रहे डाइनैमिक पार्टिशन (आम तौर पर, system_s, vendor_s, product_s वगैरह) की जानकारी होती है. सिस्टम, अपडेट के दौरान इन सेगमेंट के एक्सटेंट पढ़ता है, इसलिए इन्हें मिटाया नहीं जा सकता.

पार्टीशन, अपडेट ग्रुप से जुड़े होते हैं. ज़्यादा जानकारी के लिए, डाइनैमिक पार्टिशन लागू करना देखें.

किसी डिवाइस पर मेटाडेटा का उदाहरण यहां दिया गया है.

• मेटाडेटा 0
  • ग्रुप foo_a
    • पार्टिशन system_a
    • पार्टिशन product_services_a
    • Foo ने अपडेट किए गए अन्य पार्टीशन
  • ग्रुप bar_a
    • पार्टिशन vendor_a
    • पार्टिशन product_a
    • Bar की मदद से अपडेट किए गए अन्य पार्टीशन
  • ग्रुप foo_b (पिछले अपग्रेड से बचे हुए)
  • ग्रुप bar_b (पिछले अपग्रेड से बचे हुए)
• मेटाडेटा 1
  • ग्रुप foo_a (पिछले अपग्रेड से बचे हुए)
  • ग्रुप bar_a (पिछले अपग्रेड से बचे हुए)
  • ग्रुप foo_b
    • पार्टिशन system_b
    • पार्टिशन product_services_b
    • Foo ने अपडेट किए गए अन्य पार्टीशन
  • ग्रुप bar_b
    • पार्टिशन vendor_b
    • पार्टिशन product_b
    • Bar की मदद से अपडेट किए गए अन्य पार्टीशन

अपने डिवाइस पर मेटाडेटा को डंप करने के लिए, lpdump टूल (system/extras/partition_tools में मौजूद सोर्स कोड) का इस्तेमाल किया जा सकता है. उदाहरण के लिए:

lpdump --slot 0 /dev/block/bootdevice/by-name/super
lpdump --slot 1 /dev/block/bootdevice/by-name/super

फ़्लो अपडेट करना

1. super पार्टीशन का मेटाडेटा शुरू करें.
   1. मेटाडेटा से सोर्स के डाइनैमिक पार्टिशन के एक्सटेंट लोड करें. मान लें कि M, लोड किया गया मेटाडेटा है.
   2. M से टारगेट ग्रुप और पार्टीशन (उदाहरण के लिए, foo_t, bar_t) हटाएं, ताकि M में सिर्फ़ _s सफ़िक्स वाले पार्टीशन और ग्रुप शामिल हों.
   3. अपडेट किए गए मेनिफ़ेस्ट में dynamic_partition_metadata फ़ील्ड के हिसाब से टारगेट ग्रुप और पार्टिशन जोड़ें.
      हर पार्टीशन का साइज़, new_partition_info में देखा जा सकता है.
   4. मेटाडेटा T में M लिखें.
   5. डिवाइस मैपर पर जोड़े गए पार्टीशन को, लिखने के लिए उपलब्ध के तौर पर मैप करें.
2. ब्लॉक किए गए डिवाइसों पर अपडेट लागू करें.
   1. अगर ज़रूरी हो, तो डिवाइस मैपर पर सोर्स पार्टिशन को सिर्फ़ पढ़ने के लिए मैप करें. साइडलोड करने के लिए, यह ज़रूरी है, क्योंकि अपडेट से पहले सोर्स पार्टिशन मैप नहीं किए जाते.
   2. टारगेट स्लॉट पर, ब्लॉक किए गए सभी डिवाइसों पर पूरा या डेल्टा अपडेट लागू करें.
   3. इंस्टॉल के बाद की स्क्रिप्ट चलाने के लिए, पार्टिशन को माउंट करें. इसके बाद, पार्टिशन को अनमाउंट करें.
3. टारगेट किए गए पार्टीशन को अनमैप करें.

अपडेट से पहले और बाद में, इन सिस्टम प्रॉपर्टी में ये वैल्यू होनी चाहिए:

ro.boot.dynamic_partitions=true
ro.boot.dynamic_partitions_retrofit=true

अपडेट मेनिफ़ेस्ट में ग्रुप और पार्टीशन जोड़ना

डाइनैमिक पार्टीशन वाले A/B डिवाइस पर ओटीए अपडेट करते समय या डाइनैमिक पार्टीशन के लिए सहायता जोड़ने वाले A/B डिवाइस पर अपडेट करते समय, आपको अपडेट मेनिफ़ेस्ट में ग्रुप और पार्टीशन जोड़ने होंगे. यहां दिए गए स्निपेट में, डाइनैमिक पार्टिशन के साथ काम करने के लिए, अपडेट मेनिफ़ेस्ट के बारे में ज़्यादा जानकारी दी गई है. हर फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, update_metadata.proto देखें.

message DeltaArchiveManifest {
    optional DynamicPartitionMetadata dynamic_partition_metadata;
}

message DynamicPartitionMetadata {
    repeated DynamicPartitionGroup groups;
}

message DynamicPartitionGroup {
    required string name;
    optional uint64 size; // maximum size of group
    repeated string partition_names;
}