Android 10 prend en charge les partitions dynamiques , un système de partitionnement de l'espace utilisateur qui peut créer, redimensionner et détruire des partitions lors des mises à jour en direct (OTA).
Cette page décrit comment les clients OTA redimensionnent les partitions dynamiques lors d'une mise à jour pour les périphériques non-A/B.
Pour les appareils non-A/B, la mise à jour OTA pour les partitions dynamiques est appliquée à l'aide du updater
dans le package de mise à jour.
Mettre à jour les appareils de lancement
Cette section s'applique aux périphériques non-A/B qui se lancent avec la prise en charge des partitions dynamiques ; ces appareils sont mis à niveau depuis Android 10 vers des versions supérieures.
Générer des packages de mise à jour
Les packages de mise à jour OTA sont générés par le script ota_from_target_files
, situé sous build/make/tools/releasetools
. Par défaut, le script génère un package qui met à jour les partitions system
et vendor
. S'il existe des partitions dynamiques supplémentaires, telles que product
, product_services
ou odm
, leurs mises à jour doivent être générées dans le code spécifique au périphérique .
Pour générer des mises à jour, dans le module Python étendu, implémentez FullOTA_GetBlockDifferences()
et IncrementalOTA_GetBlockDifferences()
. Ces deux fonctions renvoient une liste d'objets BlockDifference
, chacun décrivant le correctif de mise à jour qui serait appliqué sur une partition. Les partitions renvoyées par ces deux fonctions ne doivent pas être modifiées manuellement ou vérifiées ailleurs, par exemple dans *_InstallBegin()
ou *_InstallEnd()
.
Exemple de génération de mise à jour :
# 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()]
Flux de mise à jour
En coulisses, les fonctions suivantes sont ajoutées au script edify :
-
unmap_partition(name)
- Démapper la partition si elle est mappée, sinon ne faites rien.
- Renvoie la chaîne
t
en cas de succès ou une chaîne vide en cas d'échec.
-
map_partition(name)
- Mappez la partition si elle n’est pas déjà mappée.
- Renvoie le chemin absolu du périphérique de bloc mappé en cas de succès, ou une chaîne vide en cas d'échec.
-
update_dynamic_partitions(op_list)
- Appliquez la liste d'opérations donnée sur les métadonnées de partition dynamique, en démapping les partitions si nécessaire.
- Renvoie
t
en cas de succès, ou une chaîne vide en cas d'échec.
L'argument op_list
de update_dynamic_partitions
pointe vers un fichier dans le package de mise à jour. Chaque ligne du fichier spécifie une opération. Si une opération échoue, update_dynamic_partitions
renvoie immédiatement une chaîne vide. Les opérations sont :
-
resize partition-name size
- Démapper la partition, puis redimensionnez-la à size .
-
remove partition_name
- Démapper la partition, puis supprimez-la.
-
add partition-name group-name
- Ajoutez une nouvelle partition au groupe spécifié.
- Abandonnez si le groupe n'existe pas ou si la partition existe déjà.
-
move partition-name group-name
- Déplacez la partition vers le groupe spécifié.
- Abandonnez si le groupe n'existe pas ou si la partition n'existe pas.
-
add_group group-name maximum-size
- Ajoutez un groupe avec le nom donné et la taille maximale.
- Abandonner si le groupe existe déjà.
- Un maximum_size de 0 signifie qu'il n'y a aucune limite de taille sur les partitions du groupe. Des tests supplémentaires sont nécessaires pour garantir que les partitions du groupe ne dépassent pas l'espace disponible sur le périphérique.
-
resize_group group-name maximum-size
- Redimensionnez le groupe à la taille maximale donnée.
- Abandonner si le groupe n'existe pas.
- Un maximum_size de 0 signifie qu'il n'y a aucune limite de taille sur les partitions du groupe. Des tests supplémentaires sont nécessaires pour garantir que les partitions du groupe ne dépassent pas l'espace disponible sur le périphérique.
-
remove_group group-name
- Supprimer un groupe.
- Abandonnez s'il y a des partitions dans le groupe.
-
remove_all_groups
- Supprimez toutes les partitions du mappeur de périphériques.
- Supprimez toutes les partitions et tous les groupes.
OTA incrémentielle
Les mises à jour OTA incrémentielles utilisent la logique suivante :
- Réduire les partitions/supprimer des partitions/déplacer des partitions hors du groupe (afin qu'il y ait suffisamment d'espace pour réduire les groupes)
- Réduire les groupes (afin qu'il y ait suffisamment d'espace pour agrandir les groupes)
- Agrandir les groupes (afin que nous ayons suffisamment d'espace pour agrandir/ajouter des partitions)
- Agrandir les partitions/ajouter des partitions/déplacer les partitions vers un nouveau groupe
En détail, update-script
est généré avec cette logique :
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), …)
Le fichier op_list
pour update_dynamic_partitions
est généré avec cette logique :
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
OTA complète
Les mises à jour OTA complètes utilisent la logique suivante :
- Supprimer tous les groupes et partitions existants
- Ajouter des groupes
- Ajouter des partitions
En détail, update-script
est généré avec cette logique :
update_dynamic_partitions(op_list) for each adding partition: block_image_update(map_partition(name), …)
Le fichier op_list
pour update_dynamic_partitions
est généré avec cette logique :
remove_all_groups for each adding group: add_group for each adding partition: add for each adding partition: resize