สร้างแพ็กเกจ OTA

คุณสามารถใช้เครื่องมือ ota_from_target_files ที่ให้มากับ build/make/tools/releasetools เพื่อสร้างแพ็กเกจ OTA แบบสมบูรณ์และแบบเพิ่มสำหรับอุปกรณ์ที่ใช้การอัปเดตระบบ A/B หรือการอัปเดตระบบที่ไม่ใช่ A/B เครื่องมือจะใช้ไฟล์ target-files.zip ที่สร้างโดยระบบบิลด์ของ Android เป็นอินพุต

สำหรับอุปกรณ์ที่ใช้ Android 11 ขึ้นไป คุณจะสร้างแพ็กเกจ OTA รายการเดียวสำหรับอุปกรณ์หลายเครื่องที่มี SKU แตกต่างกันได้ ซึ่งจะต้องกำหนดค่าอุปกรณ์เป้าหมายให้ใช้ลายนิ้วมือแบบไดนามิก และอัปเดตข้อมูลเมตา OTA เพื่อใส่ชื่อและลายนิ้วมือของอุปกรณ์ไว้ในรายการเงื่อนไขก่อนและหลัง

Android 8.0 ได้เลิกใช้งานแพ็กเกจ OTA ตามไฟล์สำหรับอุปกรณ์ที่ไม่ใช่ A/B ซึ่งต้องใช้แพ็กเกจ OTA ตามบล็อกแทน หากต้องการสร้างแพ็กเกจ OTA แบบบล็อกหรืออุปกรณ์ที่ใช้ Android 7.x หรือต่ำกว่า ให้ส่งตัวเลือก --block ไปยังพารามิเตอร์ ota_from_target_files

อัปเดตบิลด์ทั้งหมด

การอัปเดตแบบสมบูรณ์คือแพ็กเกจ OTA ที่มีสถานะสุดท้ายทั้งหมดของอุปกรณ์ (พาร์ติชันระบบ พาร์ติชันการบูต และแอปการกู้คืน) ตราบใดที่อุปกรณ์สามารถรับและใช้แพ็กเกจได้ แพ็กเกจจะติดตั้งบิลด์ได้ ไม่ว่าสถานะปัจจุบันของอุปกรณ์จะเป็นอย่างไรก็ตาม ตัวอย่างเช่น คำสั่งต่อไปนี้ใช้เครื่องมือรุ่นเพื่อสร้างไฟล์ target-files.zip สำหรับอุปกรณ์ tardis

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

make dist สร้างแพ็กเกจ OTA แบบเต็ม (ใน $OUT) ไฟล์ .zip ที่เกิดขึ้นมีทุกอย่างที่จำเป็นต่อการสร้างแพ็กเกจ OTA สำหรับอุปกรณ์ tardis นอกจากนี้ คุณยังสร้าง ota_from_target_files เป็นไบนารี Python และเรียกใช้เพื่อสร้างแพ็กเกจแบบสมบูรณ์หรือแบบเพิ่มก็ได้

ota_from_target_files dist_output/tardis-target_files.zip ota_update.zip

เส้นทาง ota_from_target_files ได้รับการตั้งค่าใน $PATH และไฟล์ Python แบบไบนารีที่ได้จะอยู่ในไดเรกทอรี out/

ตอนนี้ ota_update.zip พร้อมที่จะส่งไปยังอุปกรณ์ทดสอบแล้ว (ทุกอย่างจะรับรองด้วยคีย์ทดสอบ) สำหรับอุปกรณ์ของผู้ใช้ ให้สร้างและใช้คีย์ส่วนตัวของคุณเองตามที่อธิบายไว้ในการรับรองบิลด์สำหรับรุ่น

สร้างการอัปเดตเพิ่มเติม

การอัปเดตแบบเพิ่มคือแพ็กเกจ OTA ที่มีแพตช์ไบนารีสำหรับข้อมูลที่อยู่ในอุปกรณ์อยู่แล้ว โดยปกติแล้ว แพ็กเกจที่มีการอัปเดตเพิ่มเติมจะมีขนาดเล็กกว่า เนื่องจากไม่ต้องรวมไฟล์ที่ไม่มีการเปลี่ยนแปลง นอกจากนี้ เนื่องจากไฟล์ที่มีการเปลี่ยนแปลงมักจะคล้ายกับเวอร์ชันก่อนหน้ามาก แพ็กเกจจึงต้องมีเพียงการเข้ารหัสความแตกต่างระหว่างไฟล์ 2 ไฟล์เท่านั้น

คุณติดตั้งแพ็กเกจการอัปเดตแบบเพิ่มลงในอุปกรณ์ที่มีบิลด์ซอร์สที่ใช้ในการสร้างแพ็กเกจเท่านั้น หากต้องการสร้างการอัปเดตเพิ่มเติม คุณต้องมีไฟล์ target_files.zip จากบิลด์ก่อนหน้า (เวอร์ชันที่ต้องการอัปเดตจาก) และไฟล์ target_files.zip จากบิลด์ใหม่ ตัวอย่างเช่น คำสั่งต่อไปนี้ใช้เครื่องมือรุ่นเพื่อสร้างการอัปเดตแบบเพิ่มสำหรับอุปกรณ์ tardis

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

บิลด์นี้คล้ายกับบิลด์ก่อนหน้ามาก และแพ็กเกจการอัปเดตแบบเพิ่ม (incremental_ota_update.zip) มีขนาดน้อยกว่าการอัปเดตแบบเต็มที่เกี่ยวข้องมาก (ประมาณ 1 MB แทนที่จะเป็น 60 MB)

เผยแพร่แพ็กเกจที่เพิ่มไปยังอุปกรณ์ที่ใช้บิลด์ก่อนหน้าเดียวกันทุกประการซึ่งใช้เป็นจุดเริ่มต้นของแพ็กเกจที่เพิ่ม คุณต้องแฟลชอิมเมจใน PREVIOUS-tardis-target_files.zip หรือ PREVIOUS-tardis-img.zip (ทั้งสร้างด้วย make dist ที่จะแฟลชด้วย fastboot update) แทนที่จะเป็นรูปภายใต้ไดเรกทอรี PRODUCT_OUT (สร้างด้วย make ซึ่งจะกะพริบด้วย fastboot flashall) การพยายามติดตั้งแพ็กเกจที่เพิ่มขึ้นในอุปกรณ์พร้อมกับบิลด์อื่นๆ ทำให้เกิดข้อผิดพลาดในการติดตั้ง เมื่อติดตั้งไม่สำเร็จ อุปกรณ์จะยังคงอยู่ในสถานะการทำงานเดิม (ใช้ระบบเดิม) แพ็กเกจจะยืนยันสถานะก่อนหน้าของไฟล์ทั้งหมดที่จะอัปเดตก่อนที่จะดำเนินการกับไฟล์เหล่านั้น เพื่อให้อุปกรณ์ไม่อยู่ในสถานะอัปเกรดไม่เสร็จ

เสนอการอัปเดตแบบสมบูรณ์ทุกๆ 3-4 การอัปเดตย่อยเพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดีที่สุด ซึ่งจะช่วยให้ผู้ใช้ใช้รุ่นล่าสุดได้ทันและหลีกเลี่ยงการติดตั้งการอัปเดตทีละรายการ

สร้างแพ็กเกจ OTA สำหรับ SKU หลายรายการ

Android 11 ขึ้นไปรองรับการใช้แพ็กเกจ OTA เดียว สำหรับอุปกรณ์หลายเครื่องที่มี SKU ต่างกัน ซึ่งต้องมีการกำหนดค่าอุปกรณ์เป้าหมายให้ใช้ลายนิ้วมือแบบไดนามิกและอัปเดตข้อมูลเมตา OTA (โดยใช้เครื่องมือ OTA) เพื่อรวมชื่ออุปกรณ์และลายนิ้วมือไว้ในรายการเงื่อนไขก่อนและหลัง

เกี่ยวกับ SKU

รูปแบบของ SKU คือรูปแบบหนึ่งของค่าพารามิเตอร์การสร้างที่รวมกัน และมักจะเป็นชุดย่อยที่ยังไม่ได้ประกาศของพารามิเตอร์ build_fingerprint ปัจจุบัน OEM สามารถใช้พารามิเตอร์การสร้างที่ CDD อนุมัติสำหรับ SKU ใดก็ได้ ขณะเดียวกันก็ใช้รูปภาพเดียวสำหรับ SKU เหล่านั้นได้ด้วย เช่น SKU ต่อไปนี้มีผลิตภัณฑ์ย่อยหลายรายการ

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

• modifierA คือระดับอุปกรณ์ (เช่น Pro, Premium หรือ Plus)
• modifierB คือตัวแปรฮาร์ดแวร์ (เช่นวิทยุ)
• modifierC คือภูมิภาค ซึ่งอาจเป็นภูมิภาคทั่วไป (เช่น NA, EMEA หรือ CHN) หรือเฉพาะประเทศหรือภาษา (เช่น JPN, ENG หรือ CHN)

OEM จํานวนมากใช้รูปภาพเดียวสําหรับ SKU หลายรายการ จากนั้นนําชื่อผลิตภัณฑ์และลายนิ้วมือของอุปกรณ์เวอร์ชันสุดท้ายมาใช้งานเมื่อรันไทม์หลังจากอุปกรณ์บูตขึ้น กระบวนการนี้ทำให้กระบวนการพัฒนาแพลตฟอร์มง่ายขึ้น ซึ่งช่วยให้อุปกรณ์ที่มีการปรับเปลี่ยนเล็กน้อยแต่มีชื่อผลิตภัณฑ์ต่างกันสามารถแชร์รูปภาพเดียวกันได้ (เช่น tardis และ tardispro)

ใช้ลายนิ้วมือแบบไดนามิก

ลายนิ้วมือคือการเชื่อมต่อพารามิเตอร์การสร้างที่กําหนด เช่น ro.product.brand, ro.product.name และ ro.product.device ลายนิ้วมือของอุปกรณ์มาจากลายนิ้วมือของพาร์ติชันระบบและใช้เป็นตัวระบุที่ไม่ซ้ำกันของรูปภาพ (และไบต์) ที่ทำงานในอุปกรณ์ หากต้องการสร้างลายนิ้วมือแบบไดนามิก ให้ใช้ตรรกะแบบไดนามิกในไฟล์ build.prop ของอุปกรณ์เพื่อรับค่าของตัวแปร Bootloader ในเวลาที่อุปกรณ์บูต จากนั้นใช้ข้อมูลดังกล่าวเพื่อสร้างลายนิ้วมือแบบไดนามิกสําหรับอุปกรณ์นั้น

เช่น หากต้องการใช้ลายนิ้วมือแบบไดนามิกสําหรับอุปกรณ์ tardis และ tardispro ให้อัปเดตไฟล์ต่อไปนี้ตามที่แสดงด้านล่าง

• อัปเดตไฟล์ odm/etc/build_std.prop ให้มีบรรทัดต่อไปนี้

  ro.odm.product.device=tardis
  

• อัปเดตไฟล์ odm/etc/build_pro.prop ให้มีบรรทัดต่อไปนี้

  ro.odm.product.device=tardispro
  

• อัปเดตไฟล์ odm/etc/build.prop ให้มีบรรทัดต่อไปนี้

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

บรรทัดเหล่านี้จะตั้งค่าชื่ออุปกรณ์ ลายนิ้วมือ และค่า ro.build.fingerprint แบบไดนามิกตามค่าของพร็อพเพอร์ตี้ bootloader ro.boot.product.hardware.sku (ซึ่งเป็นแบบอ่านอย่างเดียว)

อัปเดตข้อมูลเมตาของแพ็กเกจ OTA

แพ็กเกจ OTA มีไฟล์ข้อมูลเมตา (META-INF/com/android/metadata) ที่อธิบายแพ็กเกจ รวมถึงเงื่อนไขก่อนและเงื่อนไขหลังของแพ็กเกจ OTA เช่น โค้ดต่อไปนี้คือไฟล์ข้อมูลเมตาสำหรับแพ็กเกจ OTA ที่กำหนดเป้าหมายอุปกรณ์ 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

ค่า pre-device, pre-build-incremental และ pre-build จะกำหนดสถานะที่อุปกรณ์ต้องมีก่อนจึงจะติดตั้งแพ็กเกจ OTA ได้ ค่า post-build-incremental และ post-build จะกำหนดสถานะที่อุปกรณ์ควรมีหลังจากติดตั้งแพ็กเกจ OTA ค่าของช่อง pre- และ post- มาจากพร็อพเพอร์ตี้การสร้างที่เกี่ยวข้องต่อไปนี้

• ค่า pre-device มาจากพร็อพเพอร์ตี้การสร้าง ro.product.device
• ค่า pre-build-incremental และ post-build-incremental มาจากพร็อพเพอร์ตี้บิลด์ ro.build.version.incremental
• ค่า pre-build และ post-build มาจากพร็อพเพอร์ตี้การสร้าง ro.build.fingerprint

ในอุปกรณ์ที่ใช้ Android 11 ขึ้นไป คุณสามารถใช้ Flag --boot_variable_file ในเครื่องมือ OTA เพื่อระบุเส้นทางไปยังไฟล์ที่มีค่าของตัวแปรรันไทม์ที่ใช้ในการสร้างลายนิ้วมือแบบไดนามิกของอุปกรณ์ จากนั้นระบบจะใช้ข้อมูลดังกล่าวเพื่ออัปเดตข้อมูลเมตา OTA ให้รวมชื่อและลายนิ้วมือของอุปกรณ์ไว้ในเงื่อนไข pre- และ post- (โดยใช้อักขระเครื่องหมายทับ | เป็นตัวคั่น) Flag --boot_variable_file มีไวยากรณ์และคำอธิบายดังนี้

• ไวยากรณ์: --boot_variable_file <path>
• คําอธิบาย: ระบุเส้นทางไปยังไฟล์ที่มีค่าที่เป็นไปได้ของพร็อพเพอร์ตี้ ro.boot.* ใช้สำหรับคํานวณลายนิ้วมือรันไทม์ที่เป็นไปได้เมื่อคำสั่งนําเข้าลบล้างพร็อพเพอร์ตี้ ro.product.* บางรายการ ไฟล์จะรองรับพร็อพเพอร์ตี้ 1 รายการต่อบรรทัด โดยแต่ละบรรทัดจะมีรูปแบบดังนี้ prop_name=value1,value2

เช่น เมื่อพร็อพเพอร์ตี้คือ ro.boot.product.hardware.sku=std,pro ข้อมูลเมตาของ OTA สำหรับอุปกรณ์ tardis และ tardispro จะปรากฏตามที่แสดงด้านล่าง

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

หากต้องการรองรับฟังก์ชันนี้ในอุปกรณ์ที่ใช้ Android 10 โปรดดูการใช้งานอ้างอิง รายการการเปลี่ยนแปลงนี้จะแยกวิเคราะห์คำสั่ง import ในไฟล์ build.prop แบบมีเงื่อนไข ซึ่งจะช่วยให้ระบบจดจำการลบล้างพร็อพเพอร์ตี้และแสดงในข้อมูลเมตา OTA สุดท้าย