OTA paketleri oluşturma

Şunu kullanabilirsiniz: ota_from_target_files tam ve artımlı olması için build/make/tools/releasetools içinde sağlanan A/B sistem güncellemelerini kullanan cihazlar için OTA paketleri veya A/B harici sistem güncellemeleri. Araç, Android derleme sistemi tarafından oluşturulan target-files.zip dosyası giriş olarak.

Android 11 veya sonraki sürümleri çalıştıran cihazlar için farklı SKU'lara sahip birden fazla cihaz için bir OTA paketi Bunu yapmak için hedef cihazları dinamik parmak izleri kullanacak şekilde yapılandırma ve cihazı dahil etmek için OTA meta verilerini güncelleme ad ve parmak izini kontrol edin.

Android 8.0, A/B dışı cihazlar için dosya tabanlı OTA paketleri desteğini sonlandırmıştır. blok tabanlı OTA paketleri kullanın. Alıcı: blok tabanlı OTA paketleri veya Android 7.x veya önceki sürümleri çalıştıran cihazlar için kart oluşturma ota_from_target_files parametresine --block seçeneği eklendi.

Eksiksiz güncellemeler oluşturun

Tam güncelleme, dokümanın son durumunu içeren bir OTA paketidir: (sistem, başlatma ve kurtarma bölümleri). Cihaz gerekli niteliklere sahip olduğu sürece uygulanması sonucundan sonra, paket, cihazın mevcut durumundan bağımsız olarak. Örneğin, komutlarının target-files.zip arşivini oluşturmak için sürüm araçlarını tardis cihaz.

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

make dist, eksiksiz bir OTA paketi oluşturur ($OUT içinde). Sonuçta oluşan .zip dosyası tardis cihaz için OTA paketleri oluşturmak amacıyla gereken her şeyi içerir. Ayrıca ota_from_target_files öğesini bir python ikili programı olarak derleyebilir ve tam veya artımlı paket derleyebilirsiniz.

ota_from_target_files dist_output/tardis-target_files.zip ota_update.zip

ota_from_target_files yolu $PATH dilinde ayarlanır ve ortaya çıkan python ikili, out/ dizininde bulunur.

ota_update.zip artık test cihazlarına gönderilmeye hazır (her şey imzalandı) . Kullanıcı cihazlarında kendi özel anahtarlarınızı oluşturun ve Yayınlanacak derlemeleri imzalama bölümünde ayrıntılı olarak açıklanmıştır.

Artımlı güncellemeler oluşturun

Ek güncelleme, verilere ikili yamalar içeren bir OTA paketidir bu cihazdadır. Artımlı güncellemeleri olan paketler genellikle daha küçüktür çünkü değiştirilmemiş dosyaları dahil etmeleri gerekmez. Ayrıca, değiştirilen dosyalar çoğu zaman önceki sürümlerine çok benzer. Ancak paketin yalnızca koda ekleyebilirsiniz.

Artımlı güncelleme paketi yalnızca paketin oluşturulmasında kullanılan kaynak derlemesi. Artımlı bir güncelleme oluşturmak için önceki derlemedeki (istediğiniz sürümdeki) target_files.zip dosyasına (from) dosyasının yanı sıra yeni derlemenin target_files.zip dosyasını yükleyin. Örneğin, Örneğin, aşağıdaki komutlar artımlı bir güncelleme oluşturmak için yayınlama araçlarını kullanır tardis cihaz için.

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

Bu derleme önceki derlemeye çok benzer ve artımlı güncelleme paket (incremental_ota_update.zip), karşılık gelen paketten çok daha küçük tam güncelleme (60 MB yerine yaklaşık 1 MB).

Artımlı paketi yalnızca tam olarak aynı artımlı paketin başlangıç noktası olarak kullanılan önceki derleme. Yanıp söndürmeniz gerekiyor PREVIOUS-tardis-target_files.zip veya PREVIOUS-tardis-img.zip klasöründeki resimler (her ikisi de make dist ile oluşturulmuştur, fastboot update ile desteklenecektir), PRODUCT_OUT dizini altındakiler (make ile oluşturulmuş ve şu andan itibaren) fastboot flashall ile yanıp söndü). Artımlı paket yüklenmeye çalışılıyor yüklü olduğu için yükleme hatası veriyor. başarısız olursa cihazın çalışma durumu değişmeden kalır (eski sistemi; paket, güncellediği tüm dosyaların önceki durumunu doğrular Böylece, cihaz yarı yükseltilmiş durumda mahsur kalmaz.

En iyi kullanıcı deneyimi için her 3-4 ek güncelleme için tam bir güncelleme sunun. güncellemelerine göz atın. Bu sayede kullanıcılar en son sürümü kavrayabilir ve uzun sürümden artımlı güncellemenin sırası vardır.

Birden fazla SKU için OTA paketi oluşturma

Android 11 veya sonraki sürümler tek bir OTA kullanmayı destekler farklı SKU'lara sahip birden fazla cihaz için paket oluşturabilirsiniz. Bunu yapmak için hedef cihazların dinamik parmak izlerini kullanmasını ve OTA meta verilerini güncellemesini (OTA araçları kullanılarak) koşul girişleridir.

SKU'lar hakkında

SKU biçimi, birleşik derlemenin bir varyasyonudur. parametre değerleri ve genellikle geçerli build_fingerprint parametrelerinin bildirilmemiş bir alt kümesidir. OEM'ler, deneme amaçlı bir SKU için CDD onaylı derleme parametrelerinin herhangi bir kombinasyonunu tek bir resim kullanılmasıdır. Örneğin aşağıdaki SKU birden çok varyasyon:

SKU = <product><device><modifierA><modifierB><modifierC>

• modifierA, cihaz düzeyindedir (ör. Pro, Premium veya Plus)
• modifierB donanım varyasyonu (örneğin, radyo)
• modifierC, genel olabilecek bir bölgedir (ör. Kuzey Amerika, EMEA veya CHN) veya ülkeye ya da dile özgü (ör. Japonya, ENG veya CHN)

Birçok OEM, birden fazla SKU için tek bir resim kullanır ve ardından ürünün adı ve cihaz parmak izini gösterir. Bu işlem küçük boyutlu cihazların kullanılmasını sağlayarak platform geliştirme sürecini basitleştirir ortak resimleri paylaşmak için (örneğin, tardis ve tardispro).

Dinamik parmak izleri kullanma

Parmak izi, derlemenin tanımlı bir birleştirme parametreleri gibi ro.product.brand, ro.product.name ve ro.product.device. Parmak izi cihaz bölümü, sistem bölümü parmak izinden türetilir ve cihazda çalıştırılan resimlerin (ve baytların) benzersiz tanımlayıcısıdır. Bir dinamik parmak izini kullanıyorsanız aşağıdaki işlemler için cihazın build.prop dosyasındaki dinamik mantığı kullanın: cihaz önyükleme zamanında bootloader değişkenlerinin değerini alın, ardından bu verileri aşağıdakileri yapmak için o cihaz için dinamik bir parmak izi oluşturmalıdır.

Örneğin, tardis ve tardispro cihazlarda dinamik parmak izleri kullanmak için aşağıdaki dosyaları aşağıda gösterildiği şekilde güncelleyin.

• odm/etc/build_std.prop dosyasını aşağıdaki satırı içerecek şekilde güncelleyin.

  ro.odm.product.device=tardis
  

• odm/etc/build_pro.prop dosyasını aşağıdaki satırı içerecek şekilde güncelleyin.

  ro.odm.product.device=tardispro
  

• odm/etc/build.prop dosyasını aşağıdaki satırları içerecek şekilde güncelleyin.

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

Bu satırlar, cihaz adını, parmak izini ve dijital parmak izini Değerine dayalı olarak ro.build.fingerprint değerleri ro.boot.product.hardware.sku bootloader özelliği (salt okunur).

OTA paketi meta verilerini güncelleme

Bir OTA paketi, şu özelliklere sahip bir meta veri dosyası (META-INF/com/android/metadata) içerir: OTA'nın ön koşulu ve sonrası durumu dahil olmak üzere paketi açıklama paketinden yararlanın. Örneğin, aşağıdaki kod bir OTA paketinin meta veri dosyasıdır tardis cihazı hedefliyor.

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

pre-device, pre-build-incremental ve pre-build değerleri, OTA paketinin yüklenebilmesi için bir cihazda olması gerekir. İlgili içeriği oluşturmak için kullanılan post-build-incremental ve post-build değerleri bir cihazın durumunu tanımlar olması beklenir. pre- ve değerleri post- alanları, aşağıdaki karşılık gelen derleme mülklerinden türetilir.

• pre-device değeri, ro.product.device derleme özelliğinden türetilir.
• pre-build-incremental ve post-build-incremental değerleri türetilir ro.build.version.incremental derleme mülkünden.
• pre-build ve post-build değerleri, ro.build.fingerprint derleme mülkü.

Android 11 veya sonraki sürümleri çalıştıran cihazlarda OTA araçlarında --boot_variable_file işaretini kullanarak cihazın çalışma zamanı değişkenlerinin değerlerini içerir. dinamik parmak izi. Bu veriler daha sonra OTA meta verilerini güncelleyerek pre- ve post- koşullarında ( dikey çizgi karakteri | ayırıcı olarak kullanılır). --boot_variable_file işareti dikkat edin.

• Sözdizimi: --boot_variable_file <path>
• Description: ro.boot.* mülk. Olası çalışma zamanı parmak izlerini hesaplamak için kullanılır bazı ro.product.* özellikleri içe aktarma ifadesi tarafından geçersiz kılındığında. Dosya, her satırda aşağıdakilerin bulunduğu her satır için bir özellik bekler biçim: prop_name=value1,value2.

Örneğin, mülk ro.boot.product.hardware.sku=std,pro olduğunda tardis ve tardispro cihazlar için OTA meta verileri aşağıda gösterildiği gibidir.

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

Bu işlevin Android 10 yüklü cihazlarda desteklenmesi için referans bölümüne bakın hakkında daha fazla bilgi edinin. Bu değişiklik listesi, build.prop içindeki import ifadelerini koşullu olarak ayrıştırır dosyası oluşturur. Bu dosya, özellik geçersiz kılma işlemlerinin nihai OTA meta verileri