ในอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป การเลเยอร์ OpenGL ES (GLES) จะ พร้อมใช้งาน แอปที่แก้ไขข้อบกพร่องได้จะโหลดเลเยอร์ GLES จาก APK ของแอป จากไดเรกทอรีฐาน หรือจาก APK ของเลเยอร์ที่เลือกได้
การใช้งานเลเยอร์ GLES จะคล้ายกับการใช้งานเลเยอร์การตรวจสอบ Vulkan
ข้อกำหนด
เลเยอร์ GLES รองรับเฉพาะ GLES เวอร์ชัน 2.0 ขึ้นไป
การเริ่มต้นเลเยอร์
หลังจากป้อนข้อมูลจุดแรกเข้ามาตรฐานแล้ว โปรแกรมโหลด EGL จะสร้างอินสแตนซ์ GLES
LayerLoader
หากเปิดใช้เลเยอร์การแก้ไขข้อบกพร่อง LayerLoader
จะสแกนไดเรกทอรีที่ระบุ
เพื่อหาเลเยอร์ เช่น Vulkan Loader
หากเปิดใช้การเลเยอร์ LayerLoader
จะค้นหาและแจงนับรายการเลเยอร์ที่ระบุ
รายการเลเยอร์จะระบุโดยชื่อไฟล์ที่คั่นด้วยโคลอน
LayerLoader
จะเคลื่อนผ่านเลเยอร์ตามลำดับที่คุณระบุ ดังนั้นเลเยอร์แรกจะอยู่ใต้แอปพลิเคชันโดยตรง สำหรับแต่ละเลเยอร์ LayerLoader
จะติดตาม AndroidGLESLayer_Initialize
และ
AndroidGLESLayer_GetProcAddress
จุดแรกเข้า เลเยอร์ต้องมีอินเทอร์เฟซต่อไปนี้จึงจะโหลดได้
typedef void* (*PFNEGLGETNEXTLAYERPROCADDRESSPROC)(void*, const char*); void* AndroidGLESLayer_Initialize(void* layer_id, PFNEGLGETNEXTLAYERPROCADDRESSPROC get_next_layer_proc_address))
AndroidGLESLayer_Initialize()
ระบุตัวระบุสำหรับเลเยอร์ที่จะใช้
(layer_id
) และจุดแรกเข้าที่เรียกใช้เพื่อค้นหาฟังก์ชันด้านล่าง
เลเยอร์ได้ คุณใช้จุดแรกเข้าได้ตามที่แสดงในตัวอย่างโค้ดต่อไปนี้
const char* func = "eglFoo"; void* gpa = get_next_layer_proc_address(layer_id, func);
AndroidGLESLayer_GetProcAddress
จะใช้ที่อยู่ของการเรียกถัดไปใน
เชนที่เลเยอร์ควรเรียกเมื่อเสร็จสิ้น หากมีเลเยอร์เดียว
next
จะชี้ไปยังไดรเวอร์โดยตรงสำหรับฟังก์ชันส่วนใหญ่
typedef __eglMustCastToProperFunctionPointerType EGLFuncPointer; void* AndroidGLESLayer_GetProcAddress(const char *funcName, EGLFuncPointer next)
สำหรับแต่ละเลเยอร์ที่ GLES LayerLoader
พบ GLES จะเรียกใช้
AndroidGLESLayer_Initialize
เดินทางผ่านรายการฟังก์ชันของ libEGL
และเรียกใช้
AndroidGLESLayer_GetProcAddress
สำหรับฟังก์ชันที่รู้จักทั้งหมด เลเยอร์มีหน้าที่
กำหนดวิธีติดตามที่อยู่ถัดไป หากเลเยอร์สกัดกั้นฟังก์ชัน
เลเยอร์จะติดตามที่อยู่ของฟังก์ชัน หากเลเยอร์ไม่ได้สกัดกั้นฟังก์ชัน
AndroidGLESLayer_GetProcAddress
จะแสดงผลที่อยู่ฟังก์ชันเดียวกันกับที่
ส่งผ่าน จากนั้น LayerLoader
จะอัปเดตรายการ Hook ฟังก์ชันให้ชี้ไปยัง
จุดแรกเข้าของเลเยอร์
เลเยอร์ไม่จำเป็นต้องดำเนินการใดๆ กับข้อมูลที่ AndroidGLESLayer_Initialize
และ get_next_layer_proc_address
ระบุ แต่
การระบุข้อมูลจะช่วยให้เลเยอร์ที่มีอยู่ เช่น
Android GPU Inspector และ
RenderDoc รองรับ
Android ได้ง่ายขึ้น ข้อมูลดังกล่าวช่วยให้เลเยอร์ค้นหาฟังก์ชันได้อย่างอิสระแทนที่จะ
รอการเรียกใช้ AndroidGLESLayer_GetProcAddress
หากเลเยอร์เลือกที่จะ
เริ่มต้นด้วยตัวเองก่อนที่โปรแกรมโหลดจะค้นหาจุดแรกเข้าทั้งหมด เลเยอร์
ต้องใช้ get_next_layer_proc_address
eglGetProcAddress
ต้อง
ส่งต่อในเชนไปยังแพลตฟอร์ม
วางเลเยอร์
GLES LayerLoader
จะค้นหาเลเยอร์ในตำแหน่งต่อไปนี้ตามลำดับ
ความสำคัญ
1. ตำแหน่งของระบบสำหรับรูท
การดำเนินการนี้ต้องมีสิทธิ์เข้าถึงระดับรูท
adb root adb disable-verity adb reboot adb root adb shell setenforce 0 adb shell mkdir -p /data/local/debug/gles adb push <layer>.so /data/local/debug/gles/
2. ไดเรกทอรีฐานของแอปพลิเคชัน
แอปพลิเคชันเป้าหมายต้องดีบักได้ หรือคุณต้องมีสิทธิ์เข้าถึงระดับรูท
adb push libGLTrace.so /data/local/tmp adb shell run-as com.android.gl2jni cp /data/local/tmp/libGLTrace.so . adb shell run-as com.android.gl2jni ls | grep libGLTrace libGLTrace.so
3. APK ภายนอก
กำหนด ABI ของแอปพลิเคชันเป้าหมาย จากนั้นติดตั้ง APK ที่มีเลเยอร์ที่คุณต้องการโหลด
adb install --abi armeabi-v7a layers.apk
4. ใน APK ของแอปพลิเคชันเป้าหมาย
ตัวอย่างต่อไปนี้แสดงวิธีวางเลเยอร์ใน APK ของแอปพลิเคชัน
$ jar tf GLES_layers.apk lib/arm64-v8a/libGLES_glesLayer1.so lib/arm64-v8a/libGLES_glesLayer2.so lib/arm64-v8a/libGLES_glesLayer3.so lib/armeabi-v7a/libGLES_glesLayer1.so lib/armeabi-v7a/libGLES_glesLayer2.so lib/armeabi-v7a/libGLES_glesLayer3.so resources.arsc AndroidManifest.xml META-INF/CERT.SF META-INF/CERT.RSA META-INF/MANIFEST.MF
เปิดใช้เลเยอร์
คุณเปิดใช้เลเยอร์ GLES ได้ทั้งต่อแอปหรือทั่วโลก การตั้งค่าต่อแอปจะยังคงอยู่ เมื่อรีบูต ในขณะที่พร็อพเพอร์ตี้ส่วนกลางจะถูกล้างเมื่อรีบูต
โมเดลและนโยบายด้านความปลอดภัยของ Android แตกต่าง จากแพลตฟอร์มอื่นๆ อย่างมาก หากต้องการโหลดเลเยอร์ภายนอก ข้อใดข้อหนึ่งต่อไปนี้ต้องเป็นจริง
ไฟล์ Manifest ของแอปเป้าหมายมีข้อมูลต่อไปนี้ องค์ประกอบ meta-data (มีผลเฉพาะกับแอปที่กำหนดเป้าหมายเป็น Android 11 (API ระดับ 30) ขึ้นไป)
<meta-data android:name="com.android.graphics.injectLayers.enable" android:value="true" />
คุณควรใช้ตัวเลือกนี้เพื่อสร้างโปรไฟล์แอปพลิเคชัน
แอปเป้าหมายสามารถแก้ไขข้อบกพร่องได้ ตัวเลือกนี้จะให้ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติม แต่ก็อาจส่งผลเสียต่อประสิทธิภาพของแอป
แอปเป้าหมายจะทำงานบนบิลด์ userdebug ของระบบปฏิบัติการซึ่ง ให้สิทธิ์เข้าถึงระดับรูท
วิธีเปิดใช้เลเยอร์ต่อแอป
# Enable layers adb shell settings put global enable_gpu_debug_layers 1 # Specify target application adb shell settings put global gpu_debug_app <package_name> # Specify layer list (from top to bottom) # Layers are identified by their filenames, such as "libGLLayer.so" adb shell settings put global gpu_debug_layers_gles <layer1:layer2:layerN> # Specify packages to search for layers adb shell settings put global gpu_debug_layer_app <package1:package2:packageN>
วิธีปิดใช้เลเยอร์ต่อแอป
# Delete the global setting that enables layers adb shell settings delete global enable_gpu_debug_layers # Delete the global setting that selects target application adb shell settings delete global gpu_debug_app # Delete the global setting that specifies layer list adb shell settings delete global gpu_debug_layers_gles # Delete the global setting that specifies layer packages adb shell settings delete global gpu_debug_layer_app
วิธีเปิดใช้เลเยอร์ทั่วโลก
# This attempts to load layers for all applications, including native # executables adb shell setprop debug.gles.layers <layer1:layer2:layerN>
สร้างเลเยอร์
เลเยอร์ต้องแสดงฟังก์ชัน 2 อย่างต่อไปนี้ตามที่อธิบายไว้ในการเริ่มต้นโปรแกรมโหลด EGL
AndroidGLESLayer_Initialize AndroidGLESLayer_GetProcAddress
เลเยอร์แบบพาสซีฟ
สำหรับเลเยอร์ที่สกัดกั้นฟังก์ชันเพียงไม่กี่ฟังก์ชัน การใช้เลเยอร์ที่เริ่มต้นแบบพาสซีฟจะดีที่สุด เลเยอร์ที่เริ่มต้นแบบพาสซีฟจะรอให้ GLES LayerLoader
เริ่มต้นฟังก์ชันที่ต้องการ
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างเลเยอร์แบบพาสซีฟ
namespace { std::unordered_map<std::string, EGLFuncPointer> funcMap; EGLAPI EGLBoolean EGLAPIENTRY glesLayer_eglChooseConfig ( EGLDisplay dpy, const EGLint *attrib_list, EGLConfig *configs, EGLint config_size, EGLint *num_config) { EGLFuncPointer entry = funcMap["eglChooseConfig"]; typedef EGLBoolean (*PFNEGLCHOOSECONFIGPROC)( EGLDisplay, const EGLint*, EGLConfig*, EGLint, EGLint*); PFNEGLCHOOSECONFIGPROC next = reinterpret_cast<PFNEGLCHOOSECONFIGPROC>(entry); return next(dpy, attrib_list, configs, config_size, num_config); } EGLAPI EGLFuncPointer EGLAPIENTRY eglGPA(const char* funcName) { #define GETPROCADDR(func) if(!strcmp(funcName, #func)) { \ return (EGLFuncPointer)glesLayer_##func; } GETPROCADDR(eglChooseConfig); // Don't return anything for unrecognized functions return nullptr; } EGLAPI void EGLAPIENTRY glesLayer_InitializeLayer( void* layer_id, PFNEGLGETNEXTLAYERPROCADDRESSPROC get_next_layer_proc_address) { // This function is purposefully empty, since this layer does not proactively // look up any entrypoints } EGLAPI EGLFuncPointer EGLAPIENTRY glesLayer_GetLayerProcAddress( const char* funcName, EGLFuncPointer next) { EGLFuncPointer entry = eglGPA(funcName); if (entry != nullptr) { funcMap[std::string(funcName)] = next; return entry; } return next; } } // namespace extern "C" { __attribute((visibility("default"))) EGLAPI void AndroidGLESLayer_Initialize( void* layer_id, PFNEGLGETNEXTLAYERPROCADDRESSPROC get_next_layer_proc_address) { return (void)glesLayer_InitializeLayer(layer_id, get_next_layer_proc_address); } __attribute((visibility("default"))) EGLAPI void* AndroidGLESLayer_GetProcAddress( const char *funcName, EGLFuncPointer next) { return (void*)glesLayer_GetLayerProcAddress(funcName, next); } }
เลเยอร์ที่ใช้งานอยู่
สำหรับเลเยอร์ที่เป็นทางการมากขึ้นซึ่งต้องเริ่มต้นอย่างเต็มรูปแบบตั้งแต่แรก หรือเลเยอร์
ที่ต้องค้นหาส่วนขยายที่ EGL Loader ไม่รู้จัก คุณจะต้องเริ่มต้นเลเยอร์ที่ใช้งานอยู่
เลเยอร์ใช้get_next_layer_proc_address
ที่ AndroidGLESLayer_Initialize
จัดเตรียมไว้เพื่อ
ค้นหาฟังก์ชัน เลเยอร์ยังคงต้องตอบกลับคำขอ AndroidGLESLayer_GetProcAddress
จากโปรแกรมโหลดเพื่อให้แพลตฟอร์มทราบว่าจะกำหนดเส้นทางการเรียกไปยังที่ใด ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างเลเยอร์ที่ใช้งานอยู่
namespace { std::unordered_map<std::string, EGLFuncPointer> funcMap; EGLAPI EGLBoolean EGLAPIENTRY glesLayer_eglChooseConfig ( EGLDisplay dpy, const EGLint *attrib_list, EGLConfig *configs, EGLint config_size, EGLint *num_config) { EGLFuncPointer entry = funcMap["eglChooseConfig"]; typedef EGLBoolean (*PFNEGLCHOOSECONFIGPROC)( EGLDisplay, const EGLint*, EGLConfig*, EGLint, EGLint*); PFNEGLCHOOSECONFIGPROC next = reinterpret_cast<PFNEGLCHOOSECONFIGPROC>(entry); return next(dpy, attrib_list, configs, config_size, num_config); } EGLAPI EGLFuncPointer EGLAPIENTRY eglGPA(const char* funcName) { #define GETPROCADDR(func) if(!strcmp(funcName, #func)) { \ return (EGLFuncPointer)glesLayer_##func; } GETPROCADDR(eglChooseConfig); // Don't return anything for unrecognized functions return nullptr; } EGLAPI void EGLAPIENTRY glesLayer_InitializeLayer( void* layer_id, PFNEGLGETNEXTLAYERPROCADDRESSPROC get_next_layer_proc_address) { // Note: This is where the layer would populate its function map with all the // functions it cares about const char* func = “eglChooseConfig”; funcMap[func] = get_next_layer_proc_address(layer_id, func); } EGLAPI EGLFuncPointer EGLAPIENTRY glesLayer_GetLayerProcAddress( const char* funcName, EGLFuncPointer next) { EGLFuncPointer entry = eglGPA(funcName); if (entry != nullptr) { return entry; } return next; } } // namespace extern "C" { __attribute((visibility("default"))) EGLAPI void AndroidGLESLayer_Initialize( void* layer_id, PFNEGLGETNEXTLAYERPROCADDRESSPROC get_next_layer_proc_address) { return (void)glesLayer_InitializeLayer(layer_id, get_next_layer_proc_address); } __attribute((visibility("default"))) EGLAPI void* AndroidGLESLayer_GetProcAddress( const char *funcName, EGLFuncPointer next) { return (void*)glesLayer_GetLayerProcAddress(funcName, next); } }