เมทริกซ์ความเข้ากันได้

ส่วนนี้จะอธิบายกรอบและเข้ากันได้อุปกรณ์ matrixes และ คีมาเข้ากันได้ของเมทริกซ์ สำหรับกฎการแข่งขันดู กฎการจับคู่

เมทริกซ์ความเข้ากันได้ของกรอบงาน (FCM)

เมทริกซ์ความเข้ากันได้ของเฟรมเวิร์ก (FCM) อธิบายข้อกำหนดของเฟรมเวิร์กบนอุปกรณ์ที่ทำงานอยู่ เมทริกซ์กรอบการทำงานร่วมกันประกอบด้วยเมทริกซ์ระบบเข้ากันได้ที่ เมทริกซ์ความเข้ากันได้ของผลิตภัณฑ์ และ เมทริกซ์ system_ext ความเข้ากันได้ ความต้องการของ FCM จะต้องเป็นไปตามรายการอุปกรณ์ (ข้อกำหนดที่บังคับใช้ในเวลาบิลด์ รันไทม์ และใน VTS)

system_ext FCM และ FCM ของผลิตภัณฑ์เป็นส่วนเสริมของ FCM เฉพาะอุปกรณ์ (ติดตั้งในพาร์ติชันระบบ)

  • FCM อุปกรณ์ควรจะสะท้อนถึงความต้องการของโมดูลในที่ พาร์ทิชันระบบ
  • system_ext FCM ควรสะท้อนถึงข้อกำหนดโดยโมดูลในพาร์ติชัน system_ext
  • FCM สินค้าควรจะสะท้อนถึงความต้องการโดยโมดูลในที่ พาร์ติชั่นสินค้า

FCM ทั้งหมดควรสอดคล้องกับการปรับเปลี่ยนของ OEM กับเฟรมเวิร์กในระบบ ผลิตภัณฑ์ และพาร์ติชั่น system_ext ตัวอย่างเช่น หากแอปที่ติดตั้งในพาร์ติชันผลิตภัณฑ์ใช้ส่วนขยายผู้ขายของอินเทอร์เฟซ HAL ความต้องการอินเทอร์เฟซ HAL ควรได้รับการประกาศในผลิตภัณฑ์ FCM

ตัวอย่างไฟล์เมทริกซ์ความเข้ากันได้ของระบบ:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Comments, Legal notices, etc. here -->
<compatibility-matrix version="1.0" type="framework" level="3">
    <hal>
        <name>android.hardware.camera</name>
        <version>1.0</version>
        <version>3.1-4</version>
        <interface>
            <name>ICameraProvider</name>
            <instance>default</instance>
            <regex-instance>[a-z_]+/[0-9]+</regex-instance>
        </interface>
    </hal>
    <hal>
        <name>android.hardware.nfc</name>
        <version>1.0</version>
        <interface>
            <name>INfc</name>
            <instance>default</instance>
        </interface>
    </hal>
    <hal optional="true">
        <name>android.hardware.graphics.composer</name>
        <version>2.1</version>
        <interface>
            <name>IComposer</name>
            <instance>default</instance>
        </interface>
    </hal>
    <hal format="aidl" optional="true">
        <name>android.hardware.light</name>
        <version>1-2</version>
        <interface>
            <name>ILights</name>
            <instance>default</instance>
        </interface>
    </hal>
    <hal format="native">
        <name>GL</name>
        <version>1.1</version>
        <version>3.0</version>
    </hal>
    <hal format="native">
        <name>EGL</name>
        <version>1.1</version>
    </hal>
    <kernel version="3.18.51">
        <!-- common configs -->
    </kernel>
    <kernel version="3.18.51">
        <!-- arm specific configs -->
        <condition>
            <config>
                <key>CONFIG_ARM</key>
                <value type="tristate">y</value>
            </config>
        <condition>
        <config>
            <key>CONFIG_A</key>
            <value type="string"></value>
        </config>
        <config>
            <key>CONFIG_B</key>
            <value type="tristate">y</value>
        </config>
    </kernel>
    <kernel version="4.1.22">
        <!-- common configs -->
        <config>
            <key>CONFIG_A</key>
            <value type="string">foo</value>
        </config>
        <config>
            <key>CONFIG_B2</key>
            <value type="int">1024</value>
        </config>
    </kernel>
    <sepolicy>
        <kernel-sepolicy-version>30</kernel-sepolicy-version>
        <sepolicy-version>25.0</sepolicy-version>
        <sepolicy-version>26.0-3</sepolicy-version>
    </sepolicy>
    <avb>
        <vbmeta-version>2.1</vbmeta-version>
    </avb>
    <xmlfile format="dtd">
        <name>media_profile</name>
        <version>1.0</version>
        <path>/system/etc/media_profile_V1_0.dtd</path>
    </xmlfile>
</compatibility-matrix>

สำหรับรายละเอียดเพิ่มเติมโปรดดูที่ FCM Lifecycle

เมทริกซ์ความเข้ากันได้ของผลิตภัณฑ์

ผลิตภัณฑ์ FCM เป็นไฟล์เมทริกซ์ความเข้ากันได้ของเฟรมเวิร์กในพาร์ติชันผลิตภัณฑ์ ออบเจ็กต์ VINTF เข้าร่วมผลิตภัณฑ์ FCM กับ FCMs ในระบบและพาร์ติชัน system_ext ขณะรันไทม์

ตัวอย่างไฟล์ FCM ของผลิตภัณฑ์:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Comments, Legal notices, etc. here -->
<compatibility-matrix version="1.0" type="framework">
    <hal>
        <name>vendor.foo.camera</name>
        <version>1.0</version>
        <interface>
            <name>IBetterCamera</name>
            <instance>default</instance>
        </interface>
    </hal>
</compatibility-matrix>

เมทริกซ์ความเข้ากันได้ของ System_ext

system_ext FCM เป็นไฟล์เมทริกซ์ความเข้ากันได้ของเฟรมเวิร์กในพาร์ติชัน system_ext อ็อบเจ็กต์ VINTF เข้าร่วม system_ext FCM กับ FCMs ในพาร์ติชันระบบและผลิตภัณฑ์ ณ รันไทม์ ดู เมทริกซ์ความเข้ากันได้ของผลิตภัณฑ์ สำหรับ system_ext แฟ้ม FCM ตัวอย่างเช่น

เมทริกซ์ความเข้ากันได้ของอุปกรณ์ (DCM)

เมทริกซ์ความเข้ากันได้ของอุปกรณ์อธิบายชุดข้อกำหนดที่อุปกรณ์คาดหวังจากเฟรมเวิร์ก (ข้อกำหนดที่บังคับใช้เมื่อเปิดตัวและเวลา OTA)

ตัวอย่างไฟล์ DCM:

<?xml version="1.0" encoding="UTF-8"?>
<!-- Comments, Legal notices, etc. here -->
<compatibility-matrix version="1.0" type="device">
    <hal>
        <name>android.hidl.manager</name>
        <version>1.0</version>
        <interface>
            <name>IServiceManager</name>
            <instance>default</instance>
        </interface>
    </hal>
    <hal>
        <name>android.hidl.memory</name>
        <version>1.0</version>
        <interface>
            <name>IMemory</name>
            <instance>ashmem</instance>
        </interface>
    </hal>
    <hal>
        <name>android.hidl.allocator</name>
        <version>1.0</version>
        <interface>
            <name>IAllocator</name>
            <instance>ashmem</instance>
        </interface>
    </hal>
    <hal>
        <name>android.framework.sensor</name>
        <version>1.0</version>
        <interface>
            <name>ISensorManager</name>
            <instance>default</instance>
        </interface>
    </hal>
    <vendor-ndk>
        <version>27</version>
    </vendor-ndk>
    <system-sdk>
        <version>27</version>
    </system-sdk>
</compatibility-matrix>

สคีมาเมทริกซ์ความเข้ากันได้

ส่วนนี้อธิบายความหมายของแท็ก XML เหล่านี้ บางคน "ที่จำเป็น" แท็กสามารถหายไปจากแฟ้มแหล่งที่มาใน Android แหล่งต้นไม้และเขียนโดย assemble_vintf เวลาที่สร้าง แท็ก "จำเป็น" ต้องมีอยู่ในไฟล์ที่เกี่ยวข้องบนอุปกรณ์

?xml
ไม่จำเป็น. มันให้ข้อมูลแก่ตัวแยกวิเคราะห์ XML เท่านั้น
compatibility-matrix.version
ที่จำเป็น. เมทริกซ์ความเข้ากันได้นี้ในเวอร์ชันเมตา อธิบายองค์ประกอบที่คาดหวังในเมทริกซ์ความเข้ากันได้ ไม่เกี่ยวข้องกับเวอร์ชัน XML
compatibility-matrix.type
ที่จำเป็น. ประเภทของเมทริกซ์ความเข้ากันได้นี้:
  • "device" : อุปกรณ์เมทริกซ์การทำงานร่วมกัน
  • "framework" : กรอบการทำงานร่วมกันของเมทริกซ์
manifest.level
จำเป็นสำหรับเมทริกซ์ความเข้ากันได้ของเฟรมเวิร์ก ใน Android 12 ขึ้นไป อนุญาตในไฟล์เมทริกซ์ความเข้ากันได้ของเฟรมเวิร์กในพาร์ติชันผลิตภัณฑ์และ system_ext ระบุเวอร์ชันเมทริกซ์ความเข้ากันได้ของกรอบงาน (เวอร์ชัน FCM) ของไฟล์นี้ ไม่ได้ประกาศเรื่องนี้ในเฉพาะอุปกรณ์กรอบการทำงานร่วมกันของเมทริกซ์ (เช่น DEVICE_FRAMEWORK_COMPATIBILITY_MATRIX_FILE )
compatibility-matrix.hal
ไม่จำเป็นและสามารถทำซ้ำได้ แสดงรายการ HAL (HIDL หรือเนทีฟ) เดียวที่เจ้าของเมทริกซ์ความเข้ากันได้ (เฟรมเวิร์กหรืออุปกรณ์) ต้องการมีอยู่ รายการ HAL มีความโดดเด่นด้วย <name> องค์ประกอบ; อาจมีรายการ HAL หลายรายการที่มีชื่อเดียวกัน (หมายถึงเงื่อนไข "และ")
compatibility-matrix.hal.format
ไม่จำเป็น. ค่าสามารถเป็นหนึ่งใน:
  • "hidl" : HALs HIDL นี่คือค่าเริ่มต้น
  • "aidl" : AIDL HALs ใช้ได้เฉพาะกับเมทริกซ์ความเข้ากันได้ของเวอร์ชัน 2.0
  • "native" : HALs พื้นเมือง
compatibility-matrix.hal.optional
แอตทริบิวต์เป็นทางเลือกและค่าเริ่มต้นเป็นเท็จ ระบุว่า HAL นี้เป็นทางเลือกสำหรับเจ้าของเมทริกซ์ความเข้ากันได้ (เฟรมเวิร์กหรืออุปกรณ์) หรือไม่ ถ้า <hal> รายการถูกทำเครื่องหมายเป็นตัวเลือกมันหมายถึงเจ้าของสามารถทำงานร่วมกับระบบ HAL นี้ถ้าปัจจุบัน แต่ไม่จำเป็นต้องให้เป็นปัจจุบัน
compatibility-matrix.hal.name
ที่จำเป็น. ชื่อแพ็กเกจแบบเต็มของ HAL นี้ ตัวอย่าง:
  • android.hardware.camera (HIDL หรือ AIDL HAL)
  • GLES (HAL พื้นเมืองต้องมีชื่อเท่านั้น)
compatibility-matrix.hal.version
รายการของช่วงรุ่น A (ดู การแข่งขัน HAL ) กำหนดว่าสิ่งที่รุ่นเมทริกซ์เจ้าของความเข้ากันได้ที่ (กรอบหรืออุปกรณ์) คาดว่า

สำหรับ HIDL และ HAL ดั้งเดิม สามารถทำซ้ำได้โดยไม่ซ้ำกัน รูปแบบเป็นหนึ่งในสิ่งต่อไปนี้:
  • MAJOR . MINOR_MIN - MINOR_MAX
  • MAJOR . MINOR (เทียบเท่า MAJOR . MINOR - MINOR )

สำหรับ AIDL HAL จะต้องไม่ปรากฏบนอุปกรณ์ที่ใช้ Android 11 หรือต่ำกว่า เป็นทางเลือกในอุปกรณ์ที่ใช้เวอร์ชันที่ใหม่กว่า หากระบุไว้ รูปแบบจะเป็นอย่างใดอย่างหนึ่งต่อไปนี้:
  • VERSION_MIN - VERSION_MAX
  • VERSION (เทียบเท่า VERSION - VERSION )
ถ้าไม่ได้ที่ไม่ได้ระบุค่าเริ่มต้นค่าเป็น 1
compatibility-matrix.hal.interface
ไม่จำเป็น สามารถทำซ้ำได้ รายการอินเทอร์เฟซที่จำเป็นของ HAL นี้
compatibility-matrix.hal.interface.name
ที่จำเป็น. ชื่อของอินเทอร์เฟซ
compatibility-matrix.hal.interface.instance
ไม่จำเป็น สามารถทำซ้ำได้ รายการอินสแตนซ์ที่จำเป็นของอินเทอร์เฟซนี้
compatibility-matrix.hal.interface.regex-instance
ไม่จำเป็น สามารถทำซ้ำได้ รายการรูปแบบชื่ออินสแตนซ์ที่จำเป็นในอินเทอร์เฟซนี้ ใช้ ขยายนิพจน์ปกติ รูปแบบ
compatibility-matrix.kernel
ไม่จำเป็น สามารถทำซ้ำได้ ระบุรายการการกำหนดค่าเคอร์เนลที่เฟรมเวิร์กต้องการในแต่ละเวอร์ชันเคอร์เนล
หลาย <kernel> แบบเดียวกับ <version> สามารถที่มีอยู่เพื่อบ่งบอกถึง "และ" ความสัมพันธ์ แต่ละ <kernel> คือ "ส่วน" ของความต้องการที่จะเปิดใช้งานเฉพาะเมื่อ <conditions> จะได้พบกับ
compatibility-matrix.kernel.version
ที่จำเป็น. รุ่นเคอร์เนล รูปแบบเป็น VERSION . MAJOR_REVISION . MINOR_REVISION เวอร์ชันและการแก้ไขหลักต้องตรงกันทุกประการ การแก้ไขเล็กน้อยกำหนดเวอร์ชัน LTS ขั้นต่ำของเคอร์เนลที่เฟรมเวิร์กคาดหวัง
compatibility-matrix.kernel.condition
ไม่จำเป็น. จะต้องไม่อยู่สำหรับแรก <kernel> ของแต่ละรุ่น ระบุรายการเงื่อนไข เฉพาะเมื่อเงื่อนไขที่จะได้พบกับข้อกำหนดที่ระบุไว้ในนี้ <kernel> ส่วนถูกเปิดใช้งาน
compatibility-matrix.kernel.config
ไม่จำเป็น สามารถทำซ้ำได้ รายการ CONFIG รายการที่จะต้องจับคู่กับรุ่นเคอร์เนลนี้ แต่ละ CONFIG รายการคือคู่ค่าคีย์; รายการ config นั้นแยกความแตกต่างด้วยคีย์
compatibility-matrix.kernel.config.key
ที่จำเป็น. ชื่อที่สำคัญของ CONFIG รายการ เริ่มต้นด้วย CONFIG_
compatibility-matrix.kernel.config.value
ที่จำเป็น. ค่าของการ CONFIG รายการ รูปแบบขึ้นอยู่กับประเภท:
  • string ละเว้นคำพูด
  • int ทศนิยมและเลขฐานสิบหก (ต้องเริ่มต้นด้วย 0x หรือ 0X) ค่าได้รับการยอมรับ ตีความว่าเป็นจำนวนเต็ม 64 บิต; ล้นส่งผลให้เกิดการตัดทอน (Parser ยอมรับค่าจาก 64 + -2 1-2 64-1, 65 บิตถูกตัดทอน; สำหรับรายละเอียดดูที่ หน้าคน strtoull .)
  • range รูปแบบคือ [int]-[int] เช่น 10-20 ค่าเลขฐานสิบหกได้รับการยอมรับและต้องเริ่มต้นด้วย 0x หรือ 0X สองขอบเขตต้องเป็นจำนวนเต็ม 64 บิตที่ไม่ได้ลงนาม
  • tristate ค่าที่ถูกต้องคือ y , m และ n
compatibility-matrix.kernel.config.value.type
ที่จำเป็น. ชนิดของค่าของ CONFIG รายการหนึ่ง:
  • string
  • int
  • range
  • tristate
compatibility-matrix.sepolicy
ที่จำเป็น. มีรายการที่เกี่ยวข้องกับ sepolicy ทั้งหมด ใช้โดยเมทริกซ์ความเข้ากันได้ของเฟรมเวิร์กเท่านั้น
compatibility-matrix.sepolicy.sepolicy-version
จำเป็น สามารถทำซ้ำได้ อธิบายข้อกำหนดเกี่ยวกับเวอร์ชันแยกดินแดน สอดคล้องกับ manifest.sepolicy.version แต่ละอินสแตนซ์ขององค์ประกอบกำหนดช่วงของเวอร์ชันการแยกตัว
compatibility-matrix.sepolicy.kernel-sepolicy-version
ที่จำเป็น. ประกาศ policydb รุ่นกรอบการทำงานร่วมกับ
compatibility-matrix.avb.vbmeta-version
ไม่จำเป็น; ใช้โดยเมทริกซ์ความเข้ากันได้ของเฟรมเวิร์กเท่านั้น ประกาศ รุ่น AVB ใช้ในการลงชื่อ system.img เลิกใช้ใน Android 10
compatibility-matrix.vendor-ndk
ไม่จำเป็น; ใช้โดยเมทริกซ์ความเข้ากันได้ของอุปกรณ์เท่านั้น ประกาศข้อกำหนดของสแน็ปช็อตผู้ขาย VNDK หากไม่มีข้อกำหนด VNDK บนอิมเมจระบบ
compatibility-matrix.vendor-ndk.version
ที่จำเป็น. จำนวนเต็มบวกที่ประกาศเวอร์ชัน VNDK ที่จำเป็นสำหรับอิมเมจผู้ขาย
compatibility-matrix.vendor-ndk.library
ไม่จำเป็น สามารถทำซ้ำได้ ประกาศชุดของไลบรารี VNDK ที่อิมเมจผู้ขายต้องการ ความหมายเช่นเดียวกับ manifest.vendor-ndk.library
compatibility-matrix.system-sdk.version
ไม่บังคับ สามารถทำซ้ำได้ ใช้โดยเมทริกซ์ความเข้ากันได้ของอุปกรณ์เท่านั้น ประกาศข้อกำหนดโดยแอปของผู้จัดจำหน่ายในเวอร์ชัน SDK ของระบบ หากไม่มีข้อกำหนด System SDK บนอิมเมจระบบ