รูปแบบไฟล์ที่ดำเนินการได้ Dalvik

เอกสารนี้อธิบายเลย์เอาต์และเนื้อหาของ .dex ซึ่งจะใช้เก็บชุดคำจำกัดความของคลาสและ ที่เกี่ยวข้อง ข้อมูลเพิ่มเติม

คำแนะนำเกี่ยวกับประเภท

LEB128

LEB128 ("Little-Endian Base 128") คือ การเข้ารหัสความยาวตัวแปรสำหรับ จำนวนจำนวนเต็มที่มีการลงชื่อหรือไม่ลงนามที่กำหนดเอง รูปแบบคือ ยืมมาจาก DWARF3 ในไฟล์ .dex จะมีการใช้ LEB128 เพื่อ เข้ารหัสจำนวน 32 บิต

ค่าที่เข้ารหัส LEB128 แต่ละค่าประกอบด้วย 1-5 ไบต์ ซึ่งรวมกันแล้วจะแสดงเป็นค่า 32 บิตเพียงค่าเดียว ชิ้น ไบต์มีชุดบิตที่สำคัญที่สุดยกเว้นไบต์สุดท้ายใน ตามลำดับ ซึ่งมีบิตสำคัญที่สุดอย่างชัดเจน ส่วนที่เหลือ 7 บิตในแต่ละไบต์คือเพย์โหลด ด้วย 7 ที่มีนัยสำคัญน้อยที่สุด บิตของจำนวนในไบต์แรก, 7 ถัดไปในไบต์ที่สอง ไบต์ เป็นต้น ในกรณีของ LEB128 ที่ลงนามแล้ว (sleb128) บิตเพย์โหลดที่สำคัญที่สุดของไบต์สุดท้ายในลำดับคือ เพิ่มเติมเพื่อสร้างค่าสุดท้าย ในเคสที่ไม่ได้ลงนาม (uleb128) บิตใดๆ ที่ไม่ได้แสดงไว้อย่างชัดแจ้งคือ ตีความเป็น 0

ตัวแปร uleb128p1 ใช้เพื่อแสดงสัญลักษณ์ โดยที่ค่าที่นำเสนอเป็นค่าบวกหนึ่งที่เข้ารหัส ในฐานะ uleb128 การดำเนินการนี้จะทำให้การเข้ารหัสของ -1 (หรืออาจเรียกว่าค่า 0xffffffff ที่ไม่มีเครื่องหมาย) — แต่ไม่มีจำนวนลบอื่นๆ — ไบต์เดียว และ มีประโยชน์ในกรณีต่างๆ ที่ตัวเลขที่แสดงต้อง ไม่ติดลบหรือ -1 (หรือ 0xffffffff) และที่ไม่อนุญาตให้ใช้ค่าลบอื่นๆ (หรือที่ไม่มีเครื่องหมายขนาดใหญ่ )

ต่อไปนี้เป็นตัวอย่างของรูปแบบ

เลย์เอาต์ของไฟล์

คำจำกัดความของบิตฟิลด์ สตริง และคงที่

DEX_FILE_MAGIC

ฝังใน header_item

อาร์เรย์/สตริงคงที่ DEX_FILE_MAGIC คือรายการของ ไบต์ที่ต้องปรากฏที่ตอนต้นของไฟล์ .dex เพื่อให้จำได้ว่าเป็น มูลค่าที่ตั้งใจ มีบรรทัดใหม่ ("\n" หรือ 0x0a) และ ไบต์ที่เป็นค่าว่าง ("\0" หรือ 0x00) เพื่อช่วย เพื่อตรวจหาความเสียหายบางรูปแบบ ค่ายัง จะเข้ารหัสหมายเลขเวอร์ชันของรูปแบบเป็นเลขทศนิยม 3 หลัก ซึ่งเป็น ซึ่งจะเพิ่มขึ้นเรื่อยๆ เมื่อรูปแบบมีการพัฒนาไปในทิศทางเดียวกัน

ubyte[8] DEX_FILE_MAGIC = { 0x64 0x65 0x78 0x0a 0x30 0x33 0x39 0x00 }
                        = "dex\n039\0"

หมายเหตุ: รองรับเวอร์ชัน 039 ของ เพิ่มเข้ามาใน Android 9.0 ซึ่งมี ไบต์โค้ดใหม่ const-method-handle และ const-method-type (แต่ละหัวข้อได้อธิบายไว้ใน ข้อมูลสรุปของชุดไบต์โค้ด ตาราง) ใน Android 10 เวอร์ชัน 039 ได้ขยายรูปแบบไฟล์ DEX เพื่อรวมที่ซ่อนอยู่ ข้อมูล API ที่ใช้ได้กับไฟล์ DEX ในเส้นทางคลาสการเปิดเครื่องเท่านั้น

หมายเหตุ: การรองรับเวอร์ชัน 038 ของรูปแบบที่เพิ่มเข้ามาใน Android 8.0 เวอร์ชัน 038 ได้เพิ่มไบต์โค้ดใหม่ (invoke-polymorphic และ invoke-custom) และ สำหรับแฮนเดิลเมธอด

หมายเหตุ: รองรับเวอร์ชัน 037 ของ รูปแบบนี้มีการเพิ่มไว้ในรุ่น Android 7.0 ก่อนหน้าเวอร์ชัน 037 มากที่สุด Android เวอร์ชันต่างๆ ใช้รูปแบบ 035 มีเพียง ความแตกต่างระหว่างเวอร์ชัน 035 และ 037 คือ เพิ่มเมธอดเริ่มต้นและการปรับเปลี่ยนinvoke

หมายเหตุ: รูปแบบก่อนหน้านี้อย่างน้อย 2-3 รูปแบบ ใช้ในซอฟต์แวร์รุ่นสาธารณะที่เผยแพร่ในวงกว้าง ตัวอย่างเช่น มีการใช้เวอร์ชัน 009 สำหรับรุ่น M3 ของ แพลตฟอร์ม Android (พฤศจิกายน - ธันวาคม 2007) และมีการใช้เวอร์ชัน 013 สำหรับ Android รุ่น M5 (กุมภาพันธ์ - มีนาคม 2008) ในแง่ต่างๆ ก่อนหน้านี้ ของรูปแบบแตกต่างจากเวอร์ชันที่อธิบายไว้ใน เอกสาร

ENDIAN_CONSTANT และ REVERSE_ENDIAN_CONSTANT

ฝังใน header_item

ค่า ENDIAN_CONSTANT คงที่ใช้เพื่อระบุ Endianness ของไฟล์ที่พบ แม้ว่ามาตรฐาน รูปแบบ .dex เป็นเนื้อหาขนาดเล็ก การติดตั้งใช้งานอาจเลือก ในการสลับไบต์ กรณีที่การติดตั้งใช้งานพบ ส่วนหัวที่มี endian_tag เท่ากับ REVERSE_ENDIAN_CONSTANT แทนที่จะเป็น ENDIAN_CONSTANT มีการสลับไบต์จากรูปแบบที่คาดไว้

uint ENDIAN_CONSTANT = 0x12345678;
uint REVERSE_ENDIAN_CONSTANT = 0x78563412;

ไม่มีดัชนี

ฝังอยู่ใน class_def_item และ debug_info_item

ค่า NO_INDEX คงที่จะใช้เพื่อระบุว่า ไม่มีค่าดัชนี

หมายเหตุ: ค่านี้ไม่ได้กำหนดให้เป็น 0 เนื่องจากที่จริงแล้วมักจะเป็นดัชนีที่ถูกต้อง

ค่าที่เลือกสำหรับ NO_INDEX คือ แสดงเป็นไบต์เดี่ยวในการเข้ารหัส uleb128p1

uint NO_INDEX = 0xffffffff;    // == -1 if treated as a signed int

คำจำกัดความของ Access_flags

ฝังไว้ใน class_def_item, encoded_field, encoded_method และ ชั้นเรียนภายใน

Bitfields ของ Flag เหล่านี้ใช้เพื่อระบุการช่วยเหลือพิเศษและ พร็อพเพอร์ตี้โดยรวมของชั้นเรียนและสมาชิกในชั้นเรียน

* อนุญาตสำหรับคำอธิบายประกอบ InnerClass รายการเท่านั้น และต้องไม่อยู่ใน class_def_item

การเข้ารหัสแบบ UTF-8 ที่ปรับแล้ว

รูปแบบ .dex เป็นการลดความซับซ้อนของการสนับสนุนเดิมที่ง่ายขึ้น เข้ารหัสข้อมูลสตริงในรูปแบบ UTF-8 ที่แก้ไขแล้วตามมาตรฐานโดยปริยาย เรียกว่า MUTF-8 แบบฟอร์มนี้เหมือนกับ UTF-8 มาตรฐาน ยกเว้น

• ใช้เฉพาะการเข้ารหัสแบบ 1, 2 และ 3 ไบต์เท่านั้น
• Code Point ในช่วง U+10000 ... U+10ffff มีการเข้ารหัสเป็นคู่ตัวแทน โดยแต่ละ ซึ่งแสดงเป็นค่าที่เข้ารหัสแบบ 3 ไบต์
• จุดโค้ด U+0000 มีการเข้ารหัสในรูปแบบ 2 ไบต์
• ไบต์ค่า Null ธรรมดา (ค่า 0) แสดงถึงจุดสิ้นสุดของ สตริง เช่นเดียวกับการตีความภาษา C มาตรฐาน

2 รายการแรกข้างต้นสามารถสรุปเป็น MUTF-8 คือรูปแบบการเข้ารหัสสำหรับ UTF-16 แทนที่จะเป็น รูปแบบการเข้ารหัสสำหรับอักขระ Unicode

รายการ 2 รายการสุดท้ายข้างต้นช่วยให้สามารถรวม จุดรหัส U+0000 ในสตริง และ ยังคงแก้ไข แสดงเป็นสตริงค่าว่างแบบ C ในลักษณะ Null

อย่างไรก็ตาม การเข้ารหัสพิเศษของ U+0000 หมายความว่า UTF-8 ปกติ ผลลัพธ์ของการเรียกใช้ฟังก์ชัน C มาตรฐาน strcmp() ในสตริง MUTF-8 เพียง 2 คู่ แสดงผลลัพธ์แบบมีการรับรองที่ถูกต้องของการเปรียบเทียบสตริงที่ไม่เท่ากัน เมื่อเรียงลำดับ (ไม่ใช่แค่ความเท่าเทียม) สิ่งที่เป็นกังวลคือ วิธีเปรียบเทียบสตริง MUTF-8 คือการถอดรหัสอักขระทีละอักขระ และเปรียบเทียบค่าที่ถอดรหัสแล้ว (อย่างไรก็ตาม การติดตั้ง ที่ชาญฉลาดกว่านั้น ก็เป็นไปได้)

โปรดดูยูนิโค้ด มาตรฐานสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเข้ารหัสอักขระ อันที่จริง MUTF-8 ใกล้เคียงกับการเข้ารหัส (ซึ่งไม่ค่อยเป็นที่รู้จัก) มากกว่า CESU-8 เมื่อเทียบกับ UTF-8 ต่อบทความ

การเข้ารหัสค่า encrypted_value

ฝังในanalytics_element และ รหัส_array_item

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

รูปแบบค่า

รูปแบบอาร์เรย์ที่เข้ารหัส

รูปแบบคำอธิบายประกอบที่เข้ารหัส

รูปแบบ description_element

ไวยากรณ์สตริง

ไฟล์ .dex มีรายการอยู่หลายประเภทซึ่ง สุดท้ายคือสตริง คำจำกัดความแบบ BNF ต่อไปนี้ จะระบุไวยากรณ์ที่ยอมรับได้สำหรับสตริงเหล่านี้

ชื่อแบบง่าย

SimpleName เป็นพื้นฐานสำหรับไวยากรณ์ของชื่ออื่นๆ สิ่งต่างๆ รูปแบบ .dex ระบุละติจูดได้พอสมควร (ซึ่งมากกว่าภาษาต้นฉบับทั่วไป) สรุปสั้นๆ ประกอบด้วยอักขระที่เป็นตัวเลขและตัวอักษรที่มี ASCII ต่ำ บางชื่อ สัญลักษณ์ ASCII ต่ำเฉพาะ และจุดรหัสที่ไม่ใช่ ASCII ส่วนใหญ่ที่ไม่ ตัวควบคุม เว้นวรรค หรือสัญลักษณ์พิเศษ เริ่มจากเวอร์ชัน 040 รูปแบบนี้อนุญาตให้มีอักขระเว้นวรรคได้ (Unicode Zs หมวดหมู่) โปรดทราบว่าจุดรหัสสำหรับตัวแทน (ในช่วง U+d800 ... U+dfff) ไม่ พิจารณาอักขระชื่อที่ถูกต้องตามการตั้งค่า แต่เป็นอักขระเสริม Unicode ถูกต้อง (ซึ่งแสดงด้วยอักขระสุดท้าย แทนกฎสำหรับ SimpleNameChar) และควร ซึ่งแสดงในไฟล์เป็นคู่ของจุดรหัสตัวแทนใน MUTF-8 การเข้ารหัส

ชื่อสมาชิก

ใช้โดย Field_id_item และ method_id_item

MemberName คือชื่อของสมาชิกในชั้นเรียน ซึ่งสมาชิกที่เป็น วิธีการและชั้นเรียนภายใน

ชื่อเต็มของชั้นเรียน

FullClassName คือชื่อคลาสที่มีคุณสมบัติครบถ้วน ซึ่งรวมถึง ตัวระบุแพ็กเกจที่ไม่บังคับตามด้วยชื่อที่ต้องระบุ

TypeDescriptor

ใช้โดย type_id_item

TypeDescriptor คือตัวแทนของทุกประเภท รวมถึง ค่าดั้งเดิม คลาส อาร์เรย์ และ void ดูด้านล่างสำหรับ ความหมายของเวอร์ชันต่างๆ

คำอธิบายแบบย่อ

ใช้โดย Proto_id_item

ShortyDescriptor เป็นการแสดงเมธอดแบบสั้น รวมทั้งประเภทผลลัพธ์และพารามิเตอร์ ไม่มีความแตกต่างระหว่างประเภทการอ้างอิง (คลาสหรืออาร์เรย์) ต่างๆ แต่ ประเภทการอ้างอิงทั้งหมดจะแสดงด้วยอักขระ 'L' ตัวเดียว

ความหมายของ TypeDescriptor

นี่คือความหมายของตัวแปรแต่ละรายการของ TypeDescriptor

รายการและโครงสร้างที่เกี่ยวข้อง

ส่วนนี้ประกอบด้วยคำจำกัดความของรายการระดับบนสุดแต่ละรายการที่ อาจปรากฏในไฟล์ .dex

ส่วนหัว_รายการ

ปรากฏในส่วนหัว

การจัดข้อความ: 4 ไบต์

รายการแผนที่

ปรากฏในส่วนข้อมูล

อ้างอิงจาก header_item

การจัดข้อความ: 4 ไบต์

ซึ่งเป็นรายการเนื้อหาทั้งหมดของไฟล์ตามลำดับ ทั้งนี้ มีความซ้ำซ้อนเกี่ยวกับ header_item แต่มีจุดมุ่งหมายเพื่อให้อยู่ในรูปแบบที่ง่าย สำหรับการปรับปรุง ประเภทที่กำหนดต้องปรากฏมากที่สุดพร้อมกันในแผนที่ แต่จะไม่มี ข้อจำกัดเกี่ยวกับประเภทคำสั่งซื้อที่จะปรากฏในประเภทอื่นนอกเหนือจาก ของรูปแบบโฆษณาที่เหลือ (เช่น ส่วน header ต้องปรากฏก่อน ตามด้วย string_ids ฯลฯ) นอกจากนี้ รายการแผนที่จะต้อง เรียงลำดับตามออฟเซ็ตเริ่มต้นและต้องไม่ทับซ้อนกัน

รูปแบบรายการแมป [map_item]

พิมพ์รหัส

string_id_item

ปรากฏในส่วน string_ids

การจัดข้อความ: 4 ไบต์

ข้อมูลสตริง

ปรากฏในส่วนข้อมูล

การจัดข้อความ: ไม่มี (จัดข้อความแบบไบต์)

type_id_item

ปรากฏในส่วน type_ids

การจัดข้อความ: 4 ไบต์

โปรโตคอล_รหัส_รายการ

ปรากฏในส่วน protocol_ids

การจัดข้อความ: 4 ไบต์

ฟิลด์_รหัส_รายการ

ปรากฏในส่วนfield_ids

การจัดข้อความ: 4 ไบต์

method_id_item

ปรากฏในส่วน method_ids

การจัดข้อความ: 4 ไบต์

class_def_item

ปรากฏในส่วน class_defs

การจัดข้อความ: 4 ไบต์

รหัสเว็บไซต์การโทร [call_site_id_item]

ปรากฏในส่วน call_site_ids

การจัดข้อความ: 4 ไบต์

call_site_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: ไม่มี (จัดข้อความไบต์)

call_site_item คือ คีย์การเข้ารหัส_array_itemซึ่งมีองค์ประกอบที่สอดคล้องกับอาร์กิวเมนต์ ให้กับเมธอด Bootstrap Linker อาร์กิวเมนต์ 3 รายการแรก ได้แก่

1. แฮนเดิลเมธอดที่แสดงเมธอด Bootstrap Linker (VALUE_METHOD_HANDLE)
2. ชื่อเมธอดที่ Bootstrap Linker ควรระบุ (VALUE_STRING)
3. ประเภทเมธอดที่สอดคล้องกับประเภทของชื่อเมธอดที่จะแปลง (VALUE_METHOD_TYPE)

อาร์กิวเมนต์เพิ่มเติมคือค่าคงที่ที่ส่งผ่านไปยังเมธอด Bootstrap Linker อาร์กิวเมนต์เหล่านี้คือ ส่งผ่านตามลำดับ และไม่มี Conversion ประเภทใดๆ

แฮนเดิลเมธอดที่แสดงเมธอด Bootstrap Linker ต้องมีประเภทการแสดงผล java.lang.invoke.CallSite พารามิเตอร์ 3 ประเภทแรกได้แก่

1. java.lang.invoke.Lookup
2. java.lang.String
3. java.lang.invoke.MethodType

ประเภทพารามิเตอร์ของอาร์กิวเมนต์เพิ่มเติมจะกำหนดจากค่าคงที่

method_handle_item

ปรากฏในส่วน method_handles

การจัดข้อความ: 4 ไบต์

โค้ดประเภทแฮนเดิลของเมธอด

class_data_item

อ้างอิงจาก class_def_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: ไม่มี (จัดข้อความแบบไบต์)

หมายเหตุ: องค์ประกอบทั้งหมด field_id และ อินสแตนซ์ method_id รายการต้องอ้างอิงถึงคลาสที่กำหนดเดียวกัน

รูปแบบฟิลด์ที่เข้ารหัส

รูปแบบ Encrypted_method

รายชื่อประเภท [type_list]

อ้างอิงจาก class_def_item และ proto_id_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: 4 ไบต์

รูปแบบ type_item

code_item

อ้างอิงจาก Encrypt_method

ปรากฏในส่วนข้อมูล

การจัดข้อความ: 4 ไบต์

รูปแบบtry_item

รูปแบบรายการเข้ารหัส_ที่จับ_มือ

รูปแบบแฮนเดิลที่เข้ารหัส_เข้ารหัส

รูปแบบ encrypted_type_addr_pair

debug_info_item

อ้างอิงจาก code_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: ไม่มี (จัดข้อความแบบไบต์)

debug_info_item แต่ละรายการจะกำหนดไบต์โค้ดที่ได้แรงบันดาลใจจาก DWARF3 ทำให้สถานะของระบบ ซึ่งเมื่อแปลความหมายแล้ว และ (อาจ) ข้อมูลตัวแปรภายในสำหรับ code_item ลำดับเริ่มต้นด้วยความยาวตัวแปร ส่วนหัว (ความยาวจะขึ้นอยู่กับจำนวนเมธอด ) ตามด้วยไบต์โค้ดเครื่องสถานะแล้วสิ้นสุด กับขนาด DBG_END_SEQUENCE ไบต์

เครื่องสถานะประกอบด้วยรีจิสเตอร์ 5 รายการ รีจิสเตอร์ address แสดงการชดเชยคำแนะนำใน insns_item ที่เกี่ยวข้องในหน่วยโค้ด 16 บิต การลงทะเบียน address จะเริ่มต้นที่ 0 เมื่อเริ่มต้นแต่ละวัน debug_info ต่อเนื่องและต้องเพิ่มขึ้นอย่างเดียว การลงทะเบียน line จะแสดงหมายเลขบรรทัดต้นทาง ควรเชื่อมโยงกับรายการตารางตำแหน่งถัดไปซึ่งเกิดจาก สถานะของเครื่อง โดยจะเริ่มต้นในส่วนหัวของลำดับ และอาจ เปลี่ยนแปลงในทิศทางบวกหรือลบ แต่ต้องไม่น้อยกว่า 1 ทะเบียน source_file แสดงถึง ไฟล์ต้นฉบับที่รายการหมายเลขบรรทัดใช้อ้างอิง เริ่มต้นโดย ค่าของ source_file_idx ใน class_def_item ตัวแปรอีก 2 ตัว ได้แก่ prologue_end และ epilogue_begin เป็นแฟล็กบูลีน (เริ่มต้นกับ false) ที่ระบุว่ามีการปล่อยตำแหน่งถัดไปหรือไม่ ควรเป็นอารัมภบทหรือบทส่งท้ายของเมธอด เครื่องสถานะ ต้องติดตามชื่อและประเภทของตัวแปรในเครื่องล่าสุดที่ใช้งานอยู่ด้วย แต่ละรายจะลงทะเบียนเพื่อรับรหัส DBG_RESTART_LOCAL

ส่วนหัวจะเป็นดังต่อไปนี้

ค่าโค้ดไบต์มีดังนี้

รหัสการดำเนินการพิเศษ

Opcode ที่มีค่าระหว่าง 0x0a ถึง 0xff (รวม) ย้ายทั้ง line และ address จะลงทะเบียนในจำนวนน้อย แล้วแสดงรายการตารางอันดับใหม่ สูตรการหาส่วนเพิ่มเป็นดังนี้

DBG_FIRST_SPECIAL = 0x0a  // the smallest special opcode
DBG_LINE_BASE   = -4      // the smallest line number increment
DBG_LINE_RANGE  = 15      // the number of line increments represented

adjusted_opcode = opcode - DBG_FIRST_SPECIAL

line += DBG_LINE_BASE + (adjusted_opcode % DBG_LINE_RANGE)
address += (adjusted_opcode / DBG_LINE_RANGE)

ไดเรกทอรีคำอธิบายประกอบ [description_directory_item]

อ้างอิงจาก class_def_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: 4 ไบต์

หมายเหตุ: องค์ประกอบทั้งหมด field_id และ อินสแตนซ์ method_id รายการต้องอ้างอิงถึงคลาสที่กำหนดเดียวกัน

รูปแบบช่องคำอธิบายประกอบ

รูปแบบคำอธิบายประกอบของเมธอด

รูปแบบคำอธิบายประกอบ "พารามิเตอร์_"

ชุดคำอธิบายประกอบ [description_set_ref_list]

อ้างอิงจาก parameter_annotations_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: 4 ไบต์

รูปแบบคำอธิบายประกอบ_set_ref_item

ชุดคำอธิบายประกอบ [description_set_item]

อ้างอิงจาก description_directory_item, field_annotations_item, method_annotations_item และ description_set_ref_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: 4 ไบต์

รูปแบบ description_off_item

สินค้าคำอธิบายประกอบ

อ้างอิงจาก description_set_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: ไม่มี (จัดข้อความแบบไบต์)

ค่าระดับการเข้าถึง

ตัวเลือกเหล่านี้เป็นตัวเลือกสำหรับช่อง visibility ใน annotation_item:

รายการอาร์เรย์ที่เข้ารหัส

อ้างอิงจาก class_def_item

ปรากฏในส่วนข้อมูล

การจัดข้อความ: ไม่มี (จัดข้อความแบบไบต์)

hideapi_class_data_item

ส่วนนี้ประกอบด้วยข้อมูลเกี่ยวกับอินเทอร์เฟซที่จำกัดซึ่งแต่ละชั้นเรียนใช้

หมายเหตุ เราเปิดตัวฟีเจอร์ API ที่ซ่อนอยู่ใน Android 10.0 และใช้ได้เฉพาะกับไฟล์ DEX ของคลาสในเส้นทางคลาสการเปิดเครื่อง รายการ Flag ที่อธิบายไว้ด้านล่างอาจขยายการให้บริการในอนาคต ของ Android สำหรับข้อมูลเพิ่มเติม โปรดดู ข้อจำกัดในอินเทอร์เฟซที่ไม่ใช่ SDK

ประเภทแฟล็กข้อจำกัด:

คำอธิบายประกอบระบบ

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

คำอธิบายประกอบระบบจะแสดงในไฟล์ .dex เป็น ที่มีการตั้งค่าการแสดงผลเป็น VISIBILITY_SYSTEM

dalvik.annotation.AnnotationDefault

ปรากฏบนเมธอดในอินเทอร์เฟซคำอธิบายประกอบ

คำอธิบายประกอบ AnnotationDefault จะแนบไปกับแต่ละรายการ อินเทอร์เฟซคำอธิบายประกอบที่ต้องการระบุการเชื่อมโยงเริ่มต้น

dalvik.annotation.EnclosingClass

ปรากฏในชั้นเรียน

แนบคำอธิบายประกอบ EnclosingClass ไว้กับแต่ละชั้นเรียน ซึ่งอาจหมายถึงสมาชิกของอีกคลาสหนึ่ง หรือ ไม่ระบุชื่อแต่ไม่ได้กําหนดไว้ภายในเนื้อหาของเมธอด (เช่น แท็กสังเคราะห์ ภายใน) ทุกชั้นเรียนที่มีคำอธิบายประกอบนี้จะต้องมี คำอธิบายประกอบ InnerClass รายการ นอกจากนี้ ชั้นเรียนต้องไม่มี ทั้ง EnclosingClass และ EnclosingMethod

dalvik.annotation.EnclosingMethod

ปรากฏในชั้นเรียน

แนบคำอธิบายประกอบ EnclosingMethod ไว้กับแต่ละชั้นเรียน ซึ่งกำหนดไว้ภายในเนื้อหาของเมธอด ทุกชั้นเรียนที่มีสิ่งนี้ ต้องมีคำอธิบายประกอบ InnerClass ด้วย นอกจากนี้ ชั้นเรียนต้องไม่มีทั้ง EnclosingClass และคำอธิบายประกอบ EnclosingMethod

dalvik.annotation.InnerClass

ปรากฏในชั้นเรียน

แนบคำอธิบายประกอบ InnerClass ไว้กับแต่ละชั้นเรียน ซึ่งระบุไว้ในขอบเขตคำศัพท์ของคำนิยามของอีกชั้นหนึ่ง คลาสใดก็ตามที่มีคำอธิบายประกอบนี้จะต้องมีรายการใดรายการหนึ่ง EnclosingClass หรือคำอธิบายประกอบ EnclosingMethod คำอธิบายประกอบ

dalvik.annotation.Memberส่วนย่อย

ปรากฏในชั้นเรียน

แนบคำอธิบายประกอบ MemberClasses ไว้กับแต่ละชั้นเรียน ซึ่งจะประกาศคลาสของสมาชิก (ชั้นเรียนสมาชิกคือชั้นเรียนในชั้นโดยตรง ที่มีชื่อ)

dalvik.annotation.MethodParameters

ปรากฏในเมธอด

หมายเหตุ: คำอธิบายประกอบนี้เพิ่มเข้ามาหลังจาก Android 7.1 โดยจะไม่สนใจการแสดงข้อมูลใน Android รุ่นก่อนหน้า

คำอธิบายประกอบ MethodParameters เป็นคำอธิบายประกอบที่ไม่บังคับและใช้เพื่อ ระบุข้อมูลเมตาของพารามิเตอร์ เช่น ชื่อพารามิเตอร์และตัวแก้ไข

สามารถละเว้นคำอธิบายประกอบจากเมธอดหรือตัวสร้างได้อย่างปลอดภัยเมื่อ ไม่จำเป็นต้องระบุข้อมูลเมตาของพารามิเตอร์ขณะรันไทม์ java.lang.reflect.Parameter.isNamePresent() สามารถใช้ในการตรวจสอบ ดูว่ามีข้อมูลเมตาสำหรับพารามิเตอร์หรือไม่และการสะท้อนที่เชื่อมโยง เช่น java.lang.reflect.Parameter.getName() กลับไปใช้ลักษณะการทำงานเริ่มต้นขณะรันไทม์หากไม่มีข้อมูล

เมื่อรวมข้อมูลเมตาของพารามิเตอร์ คอมไพเลอร์จะต้องมีข้อมูล สำหรับคลาสที่สร้างขึ้น เช่น enum เนื่องจากข้อมูลเมตาของพารามิเตอร์ รวมถึงระบุว่าพารามิเตอร์เป็นพารามิเตอร์สังเคราะห์หรือมีข้อกำหนดหรือไม่

คำอธิบายประกอบ MethodParameters จะอธิบายแต่ละวิธีเท่านั้น พารามิเตอร์ ดังนั้น คอมไพเลอร์อาจข้ามคำอธิบายประกอบโดยสิ้นเชิงได้ สำหรับตัวสร้างและเมธอดที่ไม่มีพารามิเตอร์ เพื่อขนาดโค้ด และรันไทม์

อาร์เรย์ที่ระบุด้านล่างต้องมีขนาดเท่ากับ method_id_item โครงสร้าง dex ที่เชื่อมโยงกับเมธอด มิฉะนั้น จะมีการขว้าง java.lang.reflect.MalformedParametersException ที่ รันไทม์

ซึ่งก็คือ method_id_item.proto_idx -> proto_id_item.parameters_off -> type_list.size ต้องเหมือนกับ names().length และ accessFlags().length

เนื่องจาก MethodParameters อธิบายวิธีการอย่างเป็นทางการทั้งหมด พารามิเตอร์ใดๆ แม้แต่พารามิเตอร์ที่ไม่ได้ประกาศอย่างชัดแจ้งหรือโดยนัยในซอร์สโค้ด ขนาดของอาร์เรย์อาจแตกต่างจากลายเซ็นหรือข้อมูลเมตาอื่นๆ ข้อมูลที่อิงตามพารามิเตอร์ที่ชัดแจ้งที่ประกาศในแหล่งที่มาเท่านั้น โค้ด MethodParameters จะไม่มีข้อมูลใดๆ เกี่ยวกับ ประเภทพารามิเตอร์ตัวรับคำอธิบายประกอบที่ไม่มีอยู่ในเมธอดจริง ลายเซ็น

dalvik.annotation.Signature

ปรากฏในชั้นเรียน ฟิลด์ และเมธอด

มีคำอธิบายประกอบ Signature แนบอยู่กับชั้นเรียนแต่ละชั้น หรือ Method ที่กำหนดไว้ในแง่ของประเภทที่ซับซ้อนมากขึ้น แทนด้วย type_id_item รูปแบบ .dex ไม่ได้กำหนดรูปแบบของลายเซ็น รายการดังกล่าว มีไว้เพื่อแสดงลายเซ็นต้นฉบับ เพื่อให้การนำภาษานั้นๆ ไปใช้ได้ประสบความสำเร็จ อรรถศาสตร์ ด้วยเหตุนี้ โดยทั่วไปลายเซ็นจึงไม่ได้รับการแยกวิเคราะห์ (หรือได้รับการยืนยัน) ตามการใช้งานเครื่องเสมือน ลายเซ็นจะส่งถึงมือลูกค้าได้ง่ายๆ ไปจนถึง API และเครื่องมือระดับสูง (เช่น โปรแกรมแก้ไขข้อบกพร่อง) การใช้งาน ดังนั้น ควรเขียนลายเซ็นเพื่อไม่ให้ สมมติฐานเกี่ยวกับการรับเฉพาะลายเซ็นที่ถูกต้อง การป้องกันโดยชัดแจ้ง กับความเป็นไปได้ที่จะพบเนื้อหาต่างๆ ในเชิงไวยากรณ์ ลายเซ็นไม่ถูกต้อง

เนื่องจากสตริงลายเซ็นมักจะมี เนื้อหาที่ซ้ำกันอยู่มากมาย คำอธิบายประกอบ Signature ได้รับการระบุเป็นอาร์เรย์ของ สตริง โดยที่องค์ประกอบที่ซ้ำกันจะหมายถึงสตริงเดียวกัน ข้อมูลที่สำคัญ และลายเซ็นจะนำมาใช้เป็นการเชื่อมโยงของ ทุกสตริงในอาร์เรย์ ไม่มีกฎในการดึง แยกลายเซ็นออกเป็นสตริงต่างๆ ที่ขึ้นอยู่กับ เครื่องมือที่สร้างไฟล์ .dex ไฟล์

dalvik.annotation.Throws

ปรากฏในเมธอด

คำอธิบายประกอบ Throws จะแนบอยู่กับแต่ละวิธี ที่ประกาศให้มีประเภทข้อยกเว้นอย่างน้อยหนึ่งประเภท