เลเยอร์ GLES

การจัดเลเยอร์ OpenGL ES (GLES) พร้อมใช้งานในอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป แอปที่แก้ไขข้อบกพร่องได้จะโหลดเลเยอร์ GLES จาก APK ของตัวเอง จากไดเรกทอรีพื้นฐาน หรือจาก APK เลเยอร์ที่เลือก

การใช้งานเลเยอร์ GLES คล้ายกับการใช้งานเลเยอร์การตรวจสอบ Vulkan

ข้อกำหนด

เลเยอร์ GLES ใช้ได้กับ GLES เวอร์ชัน 2.0 ขึ้นไปเท่านั้น

การเริ่มต้นเลเยอร์

หลังจากป้อนข้อมูลจุดแรกเข้ามาตรฐานแล้ว EGL Loader จะสร้างอินสแตนซ์ 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 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 ของแอปเป้าหมายมีองค์ประกอบข้อมูลเมตาต่อไปนี้ (มีผลเฉพาะกับแอปที่กำหนดเป้าหมายเป็น 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);
  }
}