ระดับ API ของผู้ให้บริการ

ระดับ API ของผู้ให้บริการหมายถึงเวอร์ชันของอินเทอร์เฟซที่พาร์ติชันของผู้ให้บริการรองรับ อินเทอร์เฟซเป็นแบบ 2 ทิศทาง ซึ่งจะอธิบาย API ที่พาร์ติชันของผู้ให้บริการมอบให้กับพาร์ติชันระบบ (เลเยอร์การแยกแยะฮาร์ดแวร์หรืออินเทอร์เฟซ HAL) และ API ที่พาร์ติชันของผู้ให้บริการต้องการจากพาร์ติชันระบบ (ชุดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ระดับล่างหรืออินเทอร์เฟซ LLNDK)

นอกจากนี้ ระบบยังใช้ระดับ API ของผู้ให้บริการเพื่อกำหนดข้อกำหนดซอฟต์แวร์ของผู้ให้บริการ (VSR) ซึ่งเป็นคอลเล็กชันข้อกำหนดด้านฟังก์ชันการทำงานและข้อกำหนดที่ไม่ใช่ฟังก์ชันการทำงานที่ซอฟต์แวร์ในพาร์ติชันของผู้ให้บริการต้องเป็นไปตาม

ส่วนที่เหลือของหน้านี้จะอธิบายวิธีใช้พร็อพเพอร์ตี้ของระบบเพื่อระบุระดับ API ของผู้ให้บริการ โดยขึ้นอยู่กับเวอร์ชัน Android ที่ใช้

การระงับผู้ให้บริการ

Android อนุญาตให้ผู้ให้บริการหยุดการแบ่งพาร์ติชันของผู้ให้บริการไว้ที่ VSR เวอร์ชันที่เฉพาะเจาะจง ชุดฟีเจอร์ที่ Android คาดหวังจากพาร์ติชันของผู้ให้บริการจะกำหนดโดยระดับ API ของผู้ให้บริการที่เชื่อมโยงกับพาร์ติชันของผู้ให้บริการ ขณะรันไทม์ ลักษณะการทํางานของซอฟต์แวร์ที่ทํางานในพาร์ติชันระบบจะปรับให้เหมาะกับระดับ Vendor API ของพาร์ติชันผู้ให้บริการ ตัวอย่างเช่น ซอฟต์แวร์ในพาร์ติชันระบบอาจไม่ใช้ฟีเจอร์ใหม่หากระดับ API ของพาร์ติชันของผู้ให้บริการไม่รองรับ

การระงับผู้ให้บริการจะใช้ได้ก็ต่อเมื่อคุณสร้างอุปกรณ์ที่เข้ากันได้กับ Android เท่านั้น

กำหนดระดับ API ของผู้ให้บริการ (Android 14-QPR3 ขึ้นไป)

สำหรับ Android 14-QPR3 ขึ้นไป ระดับ API ของผู้ให้บริการจะเปิดตัวแยกกัน ซึ่งหมายความว่าระดับ API ของ SDK และระดับ API ของผู้ให้บริการจะไม่สอดคล้องกัน

เนื่องจากกำหนดการเผยแพร่แยกกัน สำหรับ Android 14-QPR3 ขึ้นไป ระดับ API ของผู้ให้บริการจะแยกจากระดับ SDK API โดยสมบูรณ์ เพื่อให้การแยกนี้ชัดเจน รูปแบบของระดับ API ของผู้ให้บริการจะเป็นวันที่ในรูปแบบ YYYYMM (ปีและเดือน) ส่วนระดับ SDK จะเป็นจำนวนเต็ม

Android 14-QPR3 ขึ้นไปมีพร็อพเพอร์ตี้ของระบบต่อไปนี้ที่เกี่ยวข้องกับระดับ API ของผู้ให้บริการ (ro.vendor.api_level)

พร็อพเพอร์ตี้ของระบบ รูปแบบ คำอธิบาย การตั้งค่าเริ่มต้น
ro.board.api_level YYYYMM ระดับ API ของผู้ให้บริการที่ซอฟต์แวร์ของชิปเซ็ตรองรับ พร็อพเพอร์ตี้นี้ตั้งค่าไว้สำหรับชิปเซ็ตทั้งหมด ระบบบิลด์จะตั้งค่านี้โดยอัตโนมัติ
ro.board.first_api_level YYYYMM ระดับ API ของผู้ให้บริการที่ซอฟต์แวร์ของชิปเซ็ตเปิดตัวครั้งแรก พร็อพเพอร์ตี้นี้เกี่ยวข้องกับชิปเซ็ตเท่านั้น และกำหนดโดยผู้ให้บริการ SoC หากชิปเซ็ต SoC มีคุณสมบัติตรงตามเกณฑ์การหยุดให้บริการของผู้ให้บริการ หลังจากการตั้งค่าครั้งแรกแล้ว คุณต้องไม่แก้ไข ผู้ให้บริการ SoC จะตั้งค่านี้โดยใช้ BOARD_SHIPPING_API_LEVEL
ro.product.first_api_level จำนวนเต็ม ระดับ SDK API ที่อุปกรณ์เปิดใช้งานครั้งแรก OEM จะเป็นผู้ตั้งค่าพร็อพเพอร์ตี้นี้และจะไม่อัปเดตอีกต่อไป แม้ว่าจะอัปเกรดระบบปฏิบัติการแล้วก็ตาม
ro.vendor.api_level YYYYMM ระดับ API ของผู้ให้บริการที่อุปกรณ์โดยรวมต้องเป็นไปตามข้อกำหนด อธิบายไว้หลังตารางนี้
ro.board.api_frozen บูลีน ระบบจะตั้งค่าพร็อพเพอร์ตี้นี้เป็น true หากระดับ API ของผู้ให้บริการที่ ro.board.api_level แสดงถึงได้รับการสรุปแล้ว หากไม่ได้ตั้งค่าพร็อพเพอร์ตี้นี้ ระบบจะใช้ false เป็นค่าเริ่มต้น
ro.llndk.api_level YYYYMM ระดับ API ของผู้ให้บริการในรูปแบบ YYYYMM ที่ LLNDK ปัจจุบันในพาร์ติชันระบบระบุ LLNDK ใช้งานย้อนหลังได้ ดังนั้นจึงสามารถแฟลชรูปภาพผู้ให้บริการที่ต่ำกว่าหรือเท่ากับระดับ API นี้ด้วยรูปภาพระบบนี้ได้ พร็อพเพอร์ตี้นี้กำหนดโดยพาร์ติชันระบบ

พร็อพเพอร์ตี้ ro.vendor.api_level มาจากวิธีใดวิธีหนึ่งต่อไปนี้

  • หากชิปเซ็ตมีสิทธิ์ได้รับการหยุดให้บริการของผู้ให้บริการ ให้ทำดังนี้

    ro.vendor.api_level = min(
  ro.board.api_level,
  AVendorSupport_getVendorApiLevelOf(ro.product.first_api_level))

  • หากชิปเซ็ตไม่ได้อยู่ภายใต้การหยุดให้บริการของผู้ให้บริการ ให้ทำดังนี้

    ro.vendor.api_level =
  AVendorSupport_getVendorApiLevelOf(ro.product.first_api_level)

เมธอด AVendorSupport_getVendorApiLevelOf() จะกำหนดระดับ API ของผู้ให้บริการที่เกี่ยวข้องจากระดับ API ของ SDK ตัวอย่างเช่น AVendorSupport_getVendorApiLevelOf(35) โดยที่ 35 คือระดับ SDK API ของ Android รุ่นหลักในปี 2024 จะแสดงผลเป็น 202404 ซึ่งเป็นวันที่โดยประมาณของ Android 14-QPR3 เมื่อตั้งค่าระดับ Vendor API ปัจจุบัน

ระบุระดับ API ของผู้ให้บริการ (Android 13)

ระดับ API ของผู้ให้บริการจะเป็นไปตามระดับ API ของ SDK ซึ่งใช้สำหรับอินเทอร์เฟซแอปกับระบบปฏิบัติการ และอัปเดตปีละครั้งเมื่อมีการเผยแพร่แพลตฟอร์ม Android ใหม่ใน AOSP

Android 13 มีพร็อพเพอร์ตี้ของระบบต่อไปนี้ที่เกี่ยวข้องกับระดับ API ของผู้ให้บริการ (ro.vendor.api_level)

พร็อพเพอร์ตี้ของระบบ รูปแบบ คำอธิบาย การตั้งค่าเริ่มต้น
ro.board.first_api_level จำนวนเต็ม ระดับ API ของผู้ให้บริการที่ซอฟต์แวร์ของชิปเซ็ตเปิดตัวครั้งแรก ข้อมูลนี้เป็นเพียงฟังก์ชันของชิปเซ็ตเท่านั้น และผู้จำหน่าย SoC หรือ OEM จะแก้ไขไม่ได้ พร็อพเพอร์ตี้นี้ตั้งค่าไว้สำหรับชิปเซ็ตที่มีสิทธิ์ได้รับการหยุดให้บริการของผู้ให้บริการเท่านั้น ค่าจะสร้างขึ้นโดยการตั้งค่า BOARD_SHIPPING_API_LEVEL ในไฟล์ device.mk
ro.board.api_level จำนวนเต็ม ระดับ API ของผู้ให้บริการที่ซอฟต์แวร์ของชิปเซ็ตรองรับ พร็อพเพอร์ตี้นี้กำหนดไว้สำหรับชิปเซ็ตที่มีสิทธิ์ใช้การหยุดให้บริการของผู้ให้บริการเท่านั้น ในตอนแรก ระบบบิลด์จะตั้งค่าพร็อพเพอร์ตี้นี้เป็นค่าเดียวกับ ro.board.first_api_level แต่อัปเดตได้หากมีการอัปเกรดพาร์ติชันของผู้ให้บริการ
ro.product.first_api_level จำนวนเต็ม ระดับ SDK API ที่อุปกรณ์เปิดใช้งานครั้งแรก OEM จะตั้งค่าพร็อพเพอร์ตี้นี้และจะไม่อัปเดตอีกต่อไป แม้ว่าจะอัปเกรดระบบปฏิบัติการแล้วก็ตาม
ro.vendor.api_level จำนวนเต็ม ระดับ API ของผู้ให้บริการที่อุปกรณ์โดยรวมต้องเป็นไปตามข้อกำหนด อธิบายไว้หลังตารางนี้
ro.vndk.version จำนวนเต็ม เวอร์ชัน VNDK ที่ใช้ในการสร้างพาร์ติชันของผู้ให้บริการ พร็อพเพอร์ตี้นี้กำหนดโดยพาร์ติชันระบบ
ro.vendor.build.version.sdk จำนวนเต็ม ระดับ SDK API ของต้นทางที่คอมไพล์พาร์ติชันของผู้ให้บริการ
ro.vendor.build.version.release จำนวนเต็ม เวอร์ชันแพลตฟอร์มของโครงสร้างต้นทางที่สร้างพาร์ติชันของผู้ให้บริการ
ro.vendor.build.version.release_or_codename จำนวนเต็ม ชื่อโค้ดของต้นไม้ซอร์สโค้ดที่สร้างพาร์ติชันของผู้ให้บริการ

ระบบจะตั้งค่าพร็อพเพอร์ตี้ ro.vendor.api_level เป็นค่าต่ำสุดของ ro.board.api_level (หรือ ro.board.first_api_level หากไม่ได้กำหนด ro.board.api_level) และ ro.product.first_api_level โดยอัตโนมัติ