Puedes usar la herramienta ota_from_target_files que se proporciona en build/make/tools/releasetools para compilar paquetes de actualización inalámbrica incrementales y completos para dispositivos que usan actualizaciones de sistema A/B o actualizaciones de sistema no A/B. La herramienta toma el archivo target-files.zip que produce el sistema de compilación de Android como entrada.
En el caso de los dispositivos que ejecutan Android 11 o versiones posteriores, puedes compilar un paquete inalámbrico para varios dispositivos con diferentes SKU. Para ello, debes configurar los dispositivos de destino de modo que usen huellas dactilares dinámicas y actualizar los metadatos OTA para incluir el nombre del dispositivo y la huella dactilar en las entradas anterior y posterior a la condición.
Android 8.0 dejó de usar los paquetes de OTA basados en archivos para dispositivos que no son A/B, los cuales deben usar paquetes de OTA basados en bloques. Para generar paquetes OTA basados en bloques o dispositivos que ejecuten Android 7.x o versiones anteriores, pasa la opción --block al parámetro ota_from_target_files.
Compila actualizaciones completas
Una actualización completa es un paquete OTA que contiene todo el estado final del dispositivo (particiones del sistema, de inicio y de recuperación). Siempre que el dispositivo sea capaz de recibir y aplicar el paquete, este podrá instalar la compilación independientemente del estado actual del dispositivo. Por ejemplo, los siguientes comandos usan herramientas de lanzamiento para compilar el archivo target-files.zip para el dispositivo tardis.
. build/envsetup.sh && lunch tardis-engmkdir dist_outputmake dist DIST_DIR=dist_output
make dist compila un paquete inalámbrico completo (en $OUT). El archivo .zip resultante contiene todo lo necesario para compilar paquetes inalámbricos para el dispositivo tardis.
También puedes compilar ota_from_target_files como un objeto binario de Python y llamarlo para compilar paquetes completos o incrementales.
ota_from_target_files dist_output/tardis-target_files.zip ota_update.zipLa ruta de ota_from_target_files se configura en $PATH, y el archivo binario de Python resultante se encuentra en el directorio out/.
ota_update.zip ya está listo para enviarse a los dispositivos de prueba (todo está firmado con la clave de prueba). En el caso de los dispositivos de los usuarios, genera y usa tus propias claves privadas, como se detalla en Cómo firmar compilaciones para el lanzamiento.
Compila actualizaciones incrementales
Una actualización incremental es un paquete OTA que contiene parches binarios para los datos que ya están en el dispositivo. Por lo general, los paquetes con actualizaciones incrementales son más pequeños, ya que no necesitan incluir archivos sin cambios. Además, como los archivos modificados suelen ser muy similares a sus versiones anteriores, el paquete solo necesita incluir una codificación de las diferencias entre los dos archivos.
Solo puedes instalar un paquete de actualización incremental en dispositivos que tengan la compilación de origen que se usó para construir el paquete. Para compilar una actualización incremental, necesitas el archivo target_files.zip de la compilación anterior (la que deseas actualizar desde) y el archivo target_files.zip de la compilación nueva. Por ejemplo, los siguientes comandos usan herramientas de lanzamiento para compilar una actualización incremental para el dispositivo tardis.
ota_from_target_files -i PREVIOUS-tardis-target_files.zip dist_output/tardis-target_files.zip incremental_ota_update.zipEsta compilación es muy similar a la anterior, y el paquete de actualización incremental (incremental_ota_update.zip) es mucho más pequeño que la actualización completa correspondiente (alrededor de 1 MB en lugar de 60 MB).
Distribuye un paquete incremental solo a los dispositivos que ejecutan exactamente la misma compilación anterior que se usó como punto de partida del paquete incremental. Debes escribir las imágenes en la memoria flash de PREVIOUS-tardis-target_files.zip o PREVIOUS-tardis-img.zip (ambas compiladas con make dist, para escribirse en la memoria flash con fastboot update), en lugar de las que se encuentran en el directorio PRODUCT_OUT (compiladas con make, que se escribirán en la memoria flash con fastboot flashall). Si intentas instalar el paquete incremental en un dispositivo con otra compilación, se producirá un error de instalación. Cuando falla la instalación, el dispositivo permanece en el mismo estado de funcionamiento (ejecutando el sistema anterior); el paquete verifica el estado anterior de todos los archivos que actualiza antes de modificarlos, por lo que el dispositivo no queda en un estado de actualización incompleta.
Para brindar la mejor experiencia del usuario, ofrece una actualización completa por cada 3 o 4 actualizaciones incrementales. Esto ayuda a los usuarios a ponerse al día con la versión más reciente y evitar una larga secuencia de instalación de actualizaciones incrementales.
Cómo compilar paquetes inalámbricos para varios SKUs
Android 11 y las versiones posteriores admiten el uso de un solo paquete de OTA para varios dispositivos con diferentes SKU. Para ello, debes configurar los dispositivos de destino de modo que usen huellas dactilares dinámicas y actualizar los metadatos OTA (con herramientas OTA) para incluir el nombre del dispositivo y la huella dactilar en las entradas anterior y posterior a la condición.
Acerca de los SKU
El formato de un SKU es una variación de los valores combinados de los parámetros de compilación y, por lo general, es un subconjunto no declarado de los parámetros build_fingerprint actuales.
Los OEM pueden usar cualquier combinación de parámetros de compilación aprobados por el CDD para un SKU y, al mismo tiempo, usar una sola imagen para esos SKU. Por ejemplo, el siguiente SKU tiene varias variaciones:
SKU = <product><device><modifierA><modifierB><modifierC>
modifierAes el nivel del dispositivo (como Pro, Premium o Plus).modifierBes la variación de hardware (como la radio).modifierCes la región, que puede ser general (como NA, EMEA o CHN) o específica del país o el idioma (como JPN, ENG o CHN).
Muchos OEM usan una sola imagen para varios SKU y, luego, derivan el nombre del producto final y la huella digital del dispositivo en el tiempo de ejecución después de que se inicia el dispositivo. Este proceso simplifica el desarrollo de la plataforma, lo que permite que los dispositivos con personalizaciones menores, pero con nombres de productos diferentes, compartan imágenes comunes (como tardis y tardispro).
Cómo usar huellas dactilares dinámicas
Una huella digital es una concatenación definida de parámetros de compilación, como ro.product.brand, ro.product.name y ro.product.device. La huella digital de un dispositivo se deriva de la huella digital de la partición del sistema y se usa como identificador único de las imágenes (y los bytes) que se ejecutan en el dispositivo. Para crear una huella digital dinámica, usa lógica dinámica en el archivo build.prop del dispositivo para obtener el valor de las variables del cargador de arranque en el momento del arranque del dispositivo y, luego, usa esos datos para crear una huella digital dinámica para ese dispositivo.
Por ejemplo, para usar huellas digitales dinámicas para dispositivos tardis y tardispro, actualiza los siguientes archivos como se muestra a continuación.
Actualiza el archivo
odm/etc/build_std.proppara que contenga la siguiente línea.ro.odm.product.device=tardisActualiza el archivo
odm/etc/build_pro.proppara que contenga la siguiente línea.ro.odm.product.device=tardisproActualiza el archivo
odm/etc/build.proppara que contenga las siguientes líneas.ro.odm.product.device=tardis import /odm/etc/build_${ro.boot.product.hardware.sku}.prop
Estas líneas configuran de forma dinámica los valores del nombre, la huella digital y ro.build.fingerprint del dispositivo según el valor de la propiedad ro.boot.product.hardware.sku del cargador de arranque (que es de solo lectura).
Actualiza los metadatos del paquete OTA
Un paquete OTA contiene un archivo de metadatos (META-INF/com/android/metadata) que describe el paquete, incluidas las condiciones previas y posteriores del paquete OTA. Por ejemplo, el siguiente código es el archivo de metadatos de un paquete OTA destinado al dispositivo tardis.
post-build=google/tardis/tardis:11/RP1A.200521.001/6516341:userdebug/dev-keys
post-build-incremental=6516341
post-sdk-level=30
post-security-patch-level=2020-07-05
post-timestamp=1590026334
pre-build=google/tardis/tardis:11/RP1A.200519.002.A1/6515794:userdebug/dev-keys
pre-build-incremental=6515794
pre-device=tardis
Los valores pre-device, pre-build-incremental y pre-build definen el estado que debe tener un dispositivo antes de que se pueda instalar el paquete de OTA. Los valores post-build-incremental y post-build definen el estado que se espera que tenga un dispositivo después de que se instale el paquete OTA. Los valores de los campos pre- y post- se derivan de las siguientes propiedades de compilación correspondientes.
- El valor de
pre-devicese deriva de la propiedad de compilaciónro.product.device. - Los valores de
pre-build-incrementalypost-build-incrementalse derivan de la propiedad de compilaciónro.build.version.incremental. - Los valores de
pre-buildypost-buildse derivan de la propiedad de compilaciónro.build.fingerprint.
En dispositivos con Android 11 o versiones posteriores, puedes usar la marca --boot_variable_file en las herramientas de OTA para especificar una ruta de acceso a un archivo que contenga los valores de las variables de tiempo de ejecución que se usan para crear la huella digital dinámica del dispositivo. Luego, los datos se usan para actualizar los metadatos OTA y, así, incluir el nombre y la huella dactilar del dispositivo en las condiciones pre- y post- (con el carácter de barra vertical | como delimitador). La marca --boot_variable_file tiene la siguiente sintaxis y descripción.
- Sintaxis:
--boot_variable_file <path> - Descripción: Especifica una ruta de acceso a un archivo que contiene los valores posibles de las propiedades
ro.boot.*. Se usa para calcular las huellas digitales de tiempo de ejecución posibles cuando la instrucción de importación anula algunas propiedades dero.product.*. El archivo espera una propiedad por línea, en la que cada línea tiene el siguiente formato:prop_name=value1,value2.
Por ejemplo, cuando la propiedad es ro.boot.product.hardware.sku=std,pro, los metadatos de la OTA para los dispositivos tardis y tardispro son los que se muestran a continuación.
post-build=google/tardis/tardis:11/<suffix>|google/tardis/tardispro:11/<suffix>
pre-build=google/tardis/tardis:11/<suffix>|google/tardis/tardispro:11/<suffix>
pre-device=tardis|tardispro
Para admitir esta funcionalidad en dispositivos que ejecutan Android 10, consulta la implementación de referencia.
Esta lista de cambios analiza de forma condicional las instrucciones import en el archivo build.prop, lo que permite que las anulaciones de propiedades se reconozcan y se reflejen en los metadatos finales de la OTA.