Dinamik bölümlendirmelere sahip A/B olmayan cihazlar için OTA

Android 10, kablosuz (OTA) güncellemeler sırasında bölüm oluşturabilen, yeniden boyutlandırabilen ve bölüm silebilir bir kullanıcı alanı bölümlendirme sistemi olan dinamik bölümleri destekler.

Bu sayfada, A/B olmayan cihazlarda güncelleme sırasında OTA istemcilerinin dinamik bölümleri nasıl yeniden boyutlandırdığı açıklanmaktadır.

A/B olmayan cihazlarda dinamik bölümler için OTA güncellemesi, güncelleme paketindeki updater kullanılarak uygulanır.

Lansman cihazlarını güncelleme

Bu bölüm, dinamik bölüm desteğiyle kullanıma sunulan A/B dışı cihazlar için geçerlidir. Bu cihazlar, Android 10'dan sonraki sürümlere yükseltilir.

Güncelleme paketleri oluşturma

OTA güncelleme paketleri, build/make/tools/releasetools altında bulunan ota_from_target_files komut dosyası tarafından oluşturulur. Komut dosyası varsayılan olarak system ve vendor bölümlerini güncelleyen bir paket oluşturur. product, product_services veya odm gibi ek dinamik bölümler varsa bu bölümlerin güncellemeleri cihaza özgü kodda oluşturulmalıdır.

Güncelleme oluşturmak için genişletilmiş Python modülünde FullOTA_GetBlockDifferences() ve IncrementalOTA_GetBlockDifferences() işlevlerini uygulayın. Bu iki işlev, her biri bir bölüme uygulanacak güncelleme yamasını açıklayan BlockDifference nesnelerinin bir listesini döndürür. Bu iki işlev tarafından döndürülen bölümler manuel olarak değiştirilmemeli veya başka bir yerde (ör. *_InstallBegin() veya *_InstallEnd()) doğrulanmamalıdır.

Güncelleme oluşturma örneği: 

# 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()]

Akışı güncelleme

Perde arkasında aşağıdaki işlevler edify komut dosyasına eklenir:

  • unmap_partition(name)
    • Haritalanmışsa bölümün haritasını kaldırın, aksi takdirde hiçbir işlem yapmayın.
    • Başarılı olduğunda t dizesini, başarısız olduğunda ise boş bir dizeyi döndürür.
  • map_partition(name)
    • Daha önce eşlenmemişse bölümü eşleyin.
    • Başarılı olduğunda eşlenen blok cihazın mutlak yolunu, başarısız olduğunda ise boş bir dize döndürür.
  • update_dynamic_partitions(op_list)
    • Belirtilen işlem listesini dinamik bölüm meta verilerine uygulayın, gerekirse bölümlerin eşlemesini kaldırın.
    • Başarılı olduğunda t, başarısız olduğunda boş bir dize döndürür.

update_dynamic_partitions için op_list bağımsız değişkeni, güncelleme paketindeki bir dosyaya işaret eder. Dosyadaki her satır bir işlemi belirtir. Herhangi bir işlem başarısız olursa update_dynamic_partitions hemen boş bir dize döndürür. İşlemler şunlardır:

  • resize partition-name size
    • Bölümün haritasını kaldırın ve size olarak yeniden boyutlandırın.
  • remove partition_name
    • Bölümün haritasını kaldırın, ardından bölümü kaldırın.
  • add partition-name group-name
    • Belirtilen gruba yeni bir bölüm ekleyin.
    • Grup yoksa veya bölüm zaten mevcutsa işlemi iptal edin.
  • move partition-name group-name
    • Bölme, belirtilen gruba taşınır.
    • Grup yoksa veya bölüm yoksa iptal edin.
  • add_group group-name maximum-size
    • Belirtilen ada ve maksimum boyuta sahip bir grup ekleyin.
    • Grup zaten mevcutsa işlemi iptal edin.
    • maximum_size değeri 0 ise gruptaki bölümlerde boyut sınırı yoktur. Gruptaki bölümlerin cihazdaki kullanılabilir alanı aşmaması için ek test yapılması gerekir.
  • resize_group group-name maximum-size
    • Grubu belirtilen maksimum boyuta göre yeniden boyutlandırın.
    • Grup mevcut değilse işlemi iptal edin.
    • maximum_size değerinin 0 olması, gruptaki bölümlerde boyut sınırı olmadığı anlamına gelir. Gruptaki bölümlerin cihazdaki kullanılabilir alanı aşmadığından emin olmak için ek testler gerekir.
  • remove_group group-name
    • Grupları kaldırabilirsiniz.
    • Grupta bölüm varsa işlemi iptal edin.
  • remove_all_groups
    • Tüm bölümlerin cihaz eşleyiciyle eşlemesini kaldırın.
    • Tüm bölümleri ve grupları kaldırın.

Artımlı OTA

Artımlı OTA güncellemeleri aşağıdaki mantığı kullanır:

  1. Bölümleri küçültme/bölümleri silme/bölümleri grup dışına taşıma (böylece grupları küçültecek kadar alan olur)
  2. Grupları küçültme (böylece grupları büyütmek için yeterli alan olmasını sağlar)
  3. Grupları büyütme (böylece bölümleri büyütmek/eklemek için yeterli alanımız olur)
  4. Bölümleri büyütme/bölüm ekleme/bölümleri yeni gruba taşıma

Ayrıntılı olarak update-script, şu mantıkla oluşturulur: 

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), …)

update_dynamic_partitions için op_list dosyası şu mantıkla oluşturulur: 

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

Tam OTA

Tam OTA güncellemeleri aşağıdaki mantığı kullanır:

  1. Mevcut tüm grupları ve bölümleri silme
  2. Grup ekleyin
  3. Bölüm ekleme

Ayrıntılı olarak update-script, şu mantıkla oluşturulur: 

update_dynamic_partitions(op_list)

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

update_dynamic_partitions için op_list dosyası şu mantıkla oluşturulur: 

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