สำหรับอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป เลเยอร์ OpenGL ES (GLES) พร้อมใช้งาน แอปที่แก้ไขข้อบกพร่องได้สามารถโหลดเลเยอร์ GLES จาก APK จากฐาน หรือจาก APK เลเยอร์ที่เลือกไว้
การใช้งานเลเยอร์ GLES คล้ายกับ การใช้งานเลเยอร์การตรวจสอบ Vulkan
ข้อกำหนด
เลเยอร์ GLES ได้รับการสนับสนุนเฉพาะใน GLES เวอร์ชัน 2.0 ขึ้นไป
การเริ่มต้นเลเยอร์
หลังจากป้อนข้อมูลจุดแรกเข้ามาตรฐานแล้ว ตัวโหลด EGL จะสร้าง GLES
LayerLoader หากเปิดใช้เลเยอร์แก้ไขข้อบกพร่อง การสแกน LayerLoader ที่ระบุไว้
ไดเรกทอรีของเลเยอร์ เช่น
ตัวโหลด Vulkan มีหลักเกณฑ์ดังนี้
หากเปิดใช้งานเลเยอร์ 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 พบ จะมีการเรียกใช้
AndroidGLESLayer_Initialize เดินรายการฟังก์ชันและการเรียกใช้ของ libEGL
AndroidGLESLayer_GetProcAddress สำหรับฟังก์ชันที่รู้จักทั้งหมด ขึ้นอยู่กับเลเยอร์
เพื่อกำหนดวิธีติดตามที่อยู่ถัดไป หากเลเยอร์ดักจับฟังก์ชัน
จะติดตามที่อยู่ของฟังก์ชัน หากเลเยอร์ไม่ได้ดักฟังฟังก์ชัน
AndroidGLESLayer_GetProcAddress แสดงผลที่อยู่ของฟังก์ชันเดิม
ผ่าน จากนั้น LayerLoader จะอัปเดตรายการฮุกฟังก์ชันให้ชี้ไปยัง
จุดแรกเข้าของเลเยอร์
เลเยอร์ไม่จำเป็นสำหรับการดำเนินการใดๆ กับข้อมูล
AndroidGLESLayer_Initialize และ get_next_layer_proc_address ให้ไว้ แต่
การนำเสนอข้อมูลทำให้เลเยอร์ที่มีอยู่ เช่น
เครื่องมือตรวจสอบ Android GPU และ
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 ของแอปเป้าหมายประกอบด้วยข้อมูลต่อไปนี้ องค์ประกอบข้อมูลเมตา (ใช้เฉพาะ สำหรับแอปที่กำหนดเป้าหมายเป็น 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);
}
}