हमारा सुझाव है कि 27 मार्च, 2025 से AOSP को बनाने और उसमें योगदान देने के लिए, aosp-main के बजाय android-latest-release का इस्तेमाल करें. ज़्यादा जानकारी के लिए, AOSP में हुए बदलाव लेख पढ़ें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

इस पेज पर बताया गया है कि ओटीए क्लाइंट, अपडेट के दौरान नॉन-ए/बी डिवाइसों के लिए डाइनैमिक पार्टिशन का साइज़ कैसे बदलते हैं.

जिन डिवाइसों में A/B अपडेट की सुविधा नहीं है उनमें डाइनैमिक पार्टीशन के लिए, अपडेट पैकेज में मौजूद updater का इस्तेमाल करके ओटीए अपडेट लागू किया जाता है.

लॉन्च करने वाले डिवाइसों को अपडेट करना

यह सेक्शन, डाइनैमिक पार्टिशन की सुविधा के साथ लॉन्च किए गए नॉन-ए/बी डिवाइसों पर लागू होता है. ये डिवाइस, Android 10 से अपग्रेड करके नए वर्शन पर लाए जाते हैं.

अपडेट पैकेज जनरेट करना

ओटीए अपडेट पैकेज, ota_from_target_files स्क्रिप्ट से जनरेट होते हैं. यह स्क्रिप्ट, build/make/tools/releasetools में मौजूद होती है. डिफ़ॉल्ट रूप से, स्क्रिप्ट एक ऐसा पैकेज जनरेट करती है जो system और vendor पार्टीशन को अपडेट करता है. अगर product, product_services या odm जैसे अन्य डाइनैमिक पार्टिशन हैं, तो उनके अपडेट डिवाइस के हिसाब से कोड में जनरेट होने चाहिए.

अपडेट जनरेट करने के लिए, एक्सटेंड किए गए Python मॉड्यूल में FullOTA_GetBlockDifferences() और IncrementalOTA_GetBlockDifferences() लागू करें. ये दोनों फ़ंक्शन, BlockDifference ऑब्जेक्ट की सूची दिखाते हैं. इनमें से हर ऑब्जेक्ट, अपडेट पैच के बारे में बताता है. यह अपडेट पैच, किसी पार्टीशन पर लागू किया जाएगा. इन दोनों फ़ंक्शन से मिले पार्टीशन में, मैन्युअल तरीके से बदलाव नहीं किया जाना चाहिए. साथ ही, इनकी पुष्टि किसी दूसरी जगह नहीं की जानी चाहिए. उदाहरण के लिए, *_InstallBegin() या *_InstallEnd() में.

अपडेट जनरेट करने का उदाहरण:

# device/yoyodyne/tardis/releasetools.py

import os
from common import BlockDifference, EmptyImage, GetUserImage

# The joined list of user image partitions of source and target builds.
# - Items should be added to the list if new dynamic partitions are added.
# - Items should not be removed from the list even if dynamic partitions are
#   deleted. When generating an incremental OTA package, this script needs to
#   know that an image is present in source build but not in target build.
USERIMAGE_PARTITIONS = [
    "product",
    "odm",
]

def GetUserImages(input_tmp, input_zip):
  return {partition: GetUserImage(partition, input_tmp, input_zip)
          for partition in USERIMAGE_PARTITIONS
          if os.path.exists(os.path.join(input_tmp,
                                         "IMAGES", partition + ".img"))}

def FullOTA_GetBlockDifferences(info):
  images = GetUserImages(info.input_tmp, info.input_zip)
  return [BlockDifference(partition, image)
          for partition, image in images.items()]

def IncrementalOTA_GetBlockDifferences(info):
  source_images = GetUserImages(info.source_tmp, info.source_zip)
  target_images = GetUserImages(info.target_tmp, info.target_zip)

  # Use EmptyImage() as a placeholder for partitions that will be deleted.
  for partition in source_images:
    target_images.setdefault(partition, EmptyImage())

  # Use source_images.get() because new partitions are not in source_images.
  return [BlockDifference(partition, target_image, source_images.get(partition))
          for partition, target_image in target_images.items()]

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

पर्दे के पीछे, edify स्क्रिप्ट में ये फ़ंक्शन जोड़े जाते हैं:

unmap_partition(name)
- अगर पार्टिशन मैप किया गया है, तो उसे अनमैप करें. अगर मैप नहीं किया गया है, तो कुछ न करें.
- अगर कार्रवाई पूरी हो जाती है, तो t स्ट्रिंग दिखाएं. अगर कार्रवाई पूरी नहीं होती है, तो खाली स्ट्रिंग दिखाएं.
map_partition(name)
- अगर पार्टीशन पहले से मैप नहीं किया गया है, तो उसे मैप करें.
- अगर मैपिंग हो जाती है, तो यह फ़ंक्शन मैप्ड ब्लॉक डिवाइस का ऐब्सलूट पाथ दिखाता है. अगर मैपिंग नहीं होती है, तो यह फ़ंक्शन एक खाली स्ट्रिंग दिखाता है.
update_dynamic_partitions(op_list)
- डाइनैमिक पार्टिशन के मेटाडेटा पर दी गई कार्रवाइयों की सूची लागू करें. अगर ज़रूरी हो, तो पार्टिशन को अनमैप करें.
- अगर कार्रवाई पूरी हो जाती है, तो t दिखाता है. अगर कार्रवाई पूरी नहीं होती है, तो खाली स्ट्रिंग दिखाता है.

op_list आर्ग्युमेंट, update_dynamic_partitions को अपडेट पैकेज में मौजूद किसी फ़ाइल की ओर ले जाता है. फ़ाइल की हर लाइन में एक ऑपरेशन के बारे में बताया जाता है. अगर कोई भी ऑपरेशन पूरा नहीं होता है, तो update_dynamic_partitions तुरंत एक खाली स्ट्रिंग दिखाता है. ये कार्रवाइयां की जा सकती हैं:

resize partition-name size
- पार्टिशन को अनमैप करें. इसके बाद, इसका साइज़ बदलकर size करें.
remove partition_name
- पार्टिशन को अनमैप करें. इसके बाद, उसे हटाएं.
add partition-name group-name
- चुने गए ग्रुप में नया पार्टीशन जोड़ता है.
- अगर ग्रुप मौजूद नहीं है या पार्टीशन पहले से मौजूद है, तो कार्रवाई रोकें.
move partition-name group-name
- इस फ़ंक्शन का इस्तेमाल करके, किसी पार्टीशन को तय किए गए ग्रुप में ले जाया जा सकता है.
- अगर ग्रुप या पार्टिशन मौजूद नहीं है, तो प्रोसेस बंद करें.
add_group group-name maximum-size
- दिए गए नाम और ज़्यादा से ज़्यादा साइज़ वाला ग्रुप जोड़ें.
- अगर ग्रुप पहले से मौजूद है, तो कार्रवाई रोकें.
- maximum_size की वैल्यू 0 होने का मतलब है कि ग्रुप में मौजूद पार्टीशन के साइज़ की कोई सीमा नहीं है. यह पक्का करने के लिए कि ग्रुप में मौजूद पार्टिशन, डिवाइस पर उपलब्ध जगह से ज़्यादा न हों, अतिरिक्त टेस्टिंग की ज़रूरत होती है.
resize_group group-name maximum-size
- ग्रुप का साइज़ बदलकर, तय की गई ज़्यादा से ज़्यादा सीमा तक करें.
- अगर ग्रुप मौजूद नहीं है, तो कार्रवाई रोकें.
- maximum_size की वैल्यू 0 होने का मतलब है कि ग्रुप में मौजूद पार्टीशन के साइज़ की कोई सीमा नहीं है. यह पक्का करने के लिए कि ग्रुप में मौजूद पार्टिशन, डिवाइस पर उपलब्ध जगह से ज़्यादा न हों, अतिरिक्त टेस्टिंग की ज़रूरत होती है.
remove_group group-name
- किसी ग्रुप को हटाना.
- अगर ग्रुप में पार्टिशन हैं, तो कार्रवाई बंद करें.
remove_all_groups
- डिवाइस मैपर से सभी पार्टिशन को अनमैप करें.
- सभी ग्रुप और पार्टिशन हटा दिए जाते हैं.

इंक्रीमेंटल ओटीए

इंक्रीमेंटल ओटीए अपडेट में इस लॉजिक का इस्तेमाल किया जाता है:

ग्रुप के साइज़ को कम करने के लिए, पार्टीशन को छोटा करें/पार्टिशन मिटाएं/पार्टिशन को ग्रुप से बाहर ले जाएं
ग्रुप को छोटा करें, ताकि ग्रुप को बड़ा करने के लिए काफ़ी जगह हो
ग्रुप बढ़ाएं, ताकि हमारे पास पार्टीशन बढ़ाने/जोड़ने के लिए काफ़ी जगह हो
पार्टिशन बढ़ाना/पार्टिशन जोड़ना/पार्टिशन को नए ग्रुप में ले जाना

ज़्यादा जानकारी के लिए, update-script इस लॉजिक के साथ जनरेट होता है:

for each shrinking partition:
    block_image_update(map_partition(name), …)

update_dynamic_partitions(op_list)

for each growing / adding partition:
    block_image_update(map_partition(name), …)

op_list के लिए update_dynamic_partitions फ़ाइल, इस लॉजिक के हिसाब से जनरेट की जाती है:

for each deleting partition:
    remove
for each partition that changes groups:
    move to "default"
for each shrinking partition:
    resize
for each shrinking / removing group:
    resize_group / remove_group
for each growing / adding group:
    resize_group / add_group
for each adding partition:
    add
for each growing / adding partition:
    resize
for each partition that changes groups:
    move to target group

फ़ुल ओटीए

पूरे ओटीए अपडेट में इस लॉजिक का इस्तेमाल किया जाता है:

मौजूदा सभी ग्रुप और पार्टीशन मिटाएं
ग्रुप जोड़ें
पार्टिशन जोड़ना

ज़्यादा जानकारी के लिए, update-script इस लॉजिक के साथ जनरेट होता है:

update_dynamic_partitions(op_list)

for each adding partition:
    block_image_update(map_partition(name), …)

op_list के लिए update_dynamic_partitions फ़ाइल, इस लॉजिक के हिसाब से जनरेट की जाती है:

remove_all_groups
for each adding group:
    add_group
for each adding partition:
    add
for each adding partition:
    resize