Tworzenie pakietów OTA

ota_from_target_files narzędzie dostępne w build/make/tools/releasetools, umożliwiające tworzenie pełnych pakiety OTA dla urządzeń korzystających z aktualizacji systemu A/B lub Aktualizacje systemu inne niż A/B. Narzędzie pobiera Plik target-files.zip wygenerowany przez system kompilacji Androida jako dane wejściowe.

Na urządzeniach z Androidem 11 lub nowszym możesz tworzyć jeden pakiet OTA dla wielu urządzeń z różnymi kodami SKU. Wymagania konfigurowanie urządzeń docelowych pod kątem korzystania z dynamicznych odcisków cyfrowych. i aktualizacja metadanych OTA, tak aby zawierały dane o urządzeniu. imię i nazwisko oraz odcisk cyfrowy we wpisach dotyczących warunku wstępnego i posta.

Wycofane pakiety OTA w Androidzie 8.0 dla urządzeń innych niż A/B, które muszą zamiast tego użyj blokowanych pakietów OTA. Do generować oparte na blokach pakiety OTA lub urządzenia z Androidem 7.x lub starszym, opcję --block na parametr ota_from_target_files.

Kompiluj pełne aktualizacje

Pełna aktualizacja to pakiet OTA, który zawiera cały końcowy stan urządzenia (partycje systemu, rozruchu i przywracania). O ile urządzenie to umożliwia Po otrzymaniu i zastosowaniu pakietu pakiet może zainstalować kompilację bez względu na jego bieżący stan. Na przykład: używając narzędzi do wersji, aby utworzyć archiwum target-files.zip dla tardis na urządzeniu.

. build/envsetup.sh && lunch tardis-eng
mkdir dist_output
make dist DIST_DIR=dist_output

make dist tworzy pełny pakiet OTA (w $OUT). Powstały plik .zip zawiera wszystko, co jest potrzebne do tworzenia pakietów OTA dla urządzenia tardis. Możesz również skompilować plik ota_from_target_files jako plik binarny Pythona i wywołać go tworzyć pakiety pełne lub przyrostowe.

ota_from_target_files dist_output/tardis-target_files.zip ota_update.zip

Ścieżka ota_from_target_files jest skonfigurowana w języku $PATH, a powstały kod w Pythonie znajduje się w katalogu out/.

Plik ota_update.zip jest teraz gotowy do wysłania na urządzenia testowe (wszystko jest podpisane kluczem testowym). W przypadku urządzeń użytkowników wygeneruj i używaj własnych kluczy prywatnych jako: Szczegółowy opis znajdziesz w artykule Podpisywanie kompilacji do opublikowania.

Tworzenie aktualizacji przyrostowych

Aktualizacja przyrostowa to pakiet OTA, który zawiera binarne poprawki danych. zapisanych już na urządzeniu. Pakiety z przyrostowymi aktualizacjami są zwykle mniejsze ponieważ nie muszą zawierać niezmienionych plików. Ponadto zmienione pliki często bardzo podobne do poprzednich wersji, dlatego w pakiecie wystarczy kodowanie różnic między tymi plikami.

Pakiet aktualizacji przyrostowych możesz zainstalować tylko na urządzeniach, które mają kompilację źródłową używaną podczas tworzenia pakietu. Aby utworzyć stopniową aktualizację, potrzebujesz pliku target_files.zip z poprzedniej kompilacji (który chcesz do aktualizacji z) oraz plik target_files.zip z nowej kompilacji. Dla: Na przykład poniższe polecenia używają narzędzi do wersji, aby utworzyć przyrostową aktualizację dla urządzenia tardis.

ota_from_target_files -i PREVIOUS-tardis-target_files.zip dist_output/tardis-target_files.zip incremental_ota_update.zip

Ta kompilacja jest bardzo podobna do poprzedniej, a aktualizacja przyrostowa pakiet (incremental_ota_update.zip) jest znacznie mniejszy od odpowiadającego mu pełna aktualizacja (około 1 MB zamiast 60 MB).

Rozpowszechniaj pakiet przyrostowy tylko na urządzeniach, które działają dokładnie tak samo jako punktu początkowego pakietu przyrostowego. Musisz flashować obrazy w folderze PREVIOUS-tardis-target_files.zip i PREVIOUS-tardis-img.zip (oba utworzone przy użyciu make dist, które mają zostać migane za pomocą fastboot update), zamiast znajdujących się w katalogu PRODUCT_OUT (skompilowany przy użyciu make, który zostanie z symbolem fastboot flashall). Próba zainstalowania pakietu przyrostowego na urządzeniu z inną kompilacją spowoduje błąd instalacji. Gdy instalacja kończy się niepowodzeniem, urządzenie pozostaje w tym samym stanie (ze starym systemem system); pakiet weryfikuje poprzedni stan wszystkich aktualizacji wszystkich plików przed dotknięciem, dzięki czemu urządzenie nie będzie zawieszone w połowie.

Aby zapewnić użytkownikom najlepsze wrażenia, oferuj pełną aktualizację co 3–4 dodatkowe aktualizacje. aktualizacje. Dzięki temu użytkownicy będą mogli zapoznać się z najnowszą wersją i uniknąć sekwencji instalacji przyrostowych aktualizacji.

Tworzenie pakietów OTA dla wielu kodów SKU

Android 11 lub nowszy obsługuje używanie pojedynczej funkcji OTA Pakiet dla wielu urządzeń z różnymi kodami SKU. Wymaga to skonfigurowania ustawień na urządzeniach docelowych stosować odciski cyfrowe i aktualizować metadane OTA. (za pomocą narzędzi OTA), aby uwzględnić nazwę urządzenia i odcisk cyfrowy przed i po warunków.

Informacje o kodach SKU

Format kodu SKU to odmiana połączonej kompilacji i wartości parametru, jest zwykle niezadeklarowanym podzbiorem bieżących parametrów build_fingerprint. OEM może używać dowolnej kombinacji parametrów kompilacji zatwierdzonych przez CDD dla kodu SKU, za pomocą jednego zdjęcia dla tych kodów SKU. Na przykład ten kod SKU ma wiele odmian:

SKU = <product><device><modifierA><modifierB><modifierC>
  • modifierA to poziom urządzenia (np. Pro, Premium lub Plus)
  • modifierB to wersja sprzętowa (np. radio)
  • modifierC to region, który może być ogólny (np. NA, EMEA lub CHN ) albo w zależności od kraju lub języka (np. JPN, ENG lub CHN)

Wielu producentów OEM używa jednego zdjęcia dla wielu kodów SKU, a następnie otrzymuje ostateczną wersję produktu nazwę użytkownika i odcisk palca urządzenia podczas działania po uruchomieniu urządzenia. Ten proces upraszcza proces programowania platformy, umożliwiając obsługę urządzeń ale różne wersje produktu, aby udostępnić wspólne zdjęcia (np. tardis i tardispro).

Używanie dynamicznych odcisków palców

Odcisk cyfrowy to zdefiniowana konkatenacja słowa build parametry takie jak: ro.product.brand, ro.product.name i ro.product.device. Odcisk palca urządzenia pochodzi z odcisku cyfrowego partycji systemowej i jest używany jako unikalny identyfikator obrazów (i bajtów) uruchomionych na urządzeniu. Aby utworzyć dynamic odcisk palca, użyj dynamicznej logiki w pliku build.prop urządzenia, aby pobrać wartość zmiennych programu rozruchowego w momencie uruchomienia urządzenia, a następnie użyć tych danych do utworzyć dynamiczny odcisk palca dla tego urządzenia.

Aby na przykład używać dynamicznych odcisków palców na urządzeniach z systemem tardis i tardispro, zaktualizuj te pliki, jak pokazano poniżej.

  • Zaktualizuj plik odm/etc/build_std.prop, tak aby zawierał następujący wiersz.

    ro.odm.product.device=tardis

  • Zaktualizuj plik odm/etc/build_pro.prop, tak aby zawierał następujący wiersz.

    ro.odm.product.device=tardispro

  • Zaktualizuj plik odm/etc/build.prop, tak aby zawierał następujące wiersze.

    ro.odm.product.device=tardis
import /odm/etc/build_${ro.boot.product.hardware.sku}.prop

Wiersze te dynamicznie ustawiają nazwę urządzenia, odcisk palca ro.build.fingerprint na podstawie wartości atrybutu Właściwość programu rozruchowego ro.boot.product.hardware.sku (tylko do odczytu).

Aktualizacja metadanych pakietu OTA

Pakiet OTA zawiera plik metadanych (META-INF/com/android/metadata), który opisuje pakiet, w tym stan wstępny i końcowy OTA. pakietu SDK. Na przykład ten kod to plik metadanych pakietu OTA kierowane na urządzenie z systemem 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

Wartości pre-device, pre-build-incremental i pre-build określają określić, jakie musi mieć urządzenie, zanim będzie można zainstalować pakiet OTA. Wartości post-build-incremental i post-build określają stan urządzenia co może nastąpić po zainstalowaniu pakietu OTA. Wartości pre- i Pola post- pochodzą z podanych niżej odpowiednich właściwości kompilacji.

  • Wartość pre-device pochodzi z właściwości kompilacji ro.product.device.
  • Wartości pre-build-incremental i post-build-incremental są wyliczane z właściwości kompilacji ro.build.version.incremental.
  • Wartości pre-build i post-build pochodzą z parametru ro.build.fingerprint właściwość kompilacji.

Na urządzeniach z Androidem 11 lub nowszym możesz używać tej funkcji: flagę --boot_variable_file w narzędziach OTA, aby podać ścieżkę do pliku, zawiera wartości zmiennych środowiska wykonawczego używanych do tworzenia dynamiczny odcisk cyfrowy. Te dane służą następnie do aktualizowania metadanych OTA, dodając do nazwę urządzenia i odcisk palca w warunkach pre- i post- (przy użyciu pionowa kreska | jako separatora). Flaga --boot_variable_file zawiera element z poniższą składnią i opisem.

  • Składnia: --boot_variable_file <path>
  • Opis: określa ścieżkę do pliku zawierającego możliwe wartości ro.boot.*. Służy do obliczania możliwych odcisków cyfrowych środowiska wykonawczego gdy niektóre właściwości ro.product.* zostały zastąpione instrukcją importu. Plik wymaga 1 właściwości w każdym wierszu, w którym każdy wiersz zawiera: format: prop_name=value1,value2.

Jeśli na przykład właściwość to ro.boot.product.hardware.sku=std,pro, atrybut Metadane OTA urządzenia z systemem tardis i tardispro są przedstawione poniżej.

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

Aby uzyskać dostęp do tej funkcji na urządzeniach z Androidem 10, zapoznaj się z dokumentacją implementacji. Ta lista zmian warunkowo analizuje instrukcje import w elemencie build.prop który umożliwia rozpoznawanie i uwzględnianie zastąpień właściwości w ostatecznych metadanych OTA.