طبقات GLES

على الأجهزة التي تعمل بنظام التشغيل Android 10 (مستوى واجهة برمجة التطبيقات 29) والإصدارات الأحدث، تكون طبقات OpenGL ES (GLES) المتوفرة. يمكن لتطبيق قابل لتصحيح الأخطاء تحميل طبقات GLES من حزمة APK الخاصة به من قاعدته أو من طبقة APK محددة.

يتشابه استخدام طبقة GLES مع استخدام طبقة التحقق من Vulkan.

المتطلبات

لا تتوافق طبقات GLES إلا مع الإصدار 2.0 أو الإصدارات الأحدث من GLES.

تهيئة الطبقة

بعد تعبئة نقاط الإدخال القياسية، ينشئ 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)

مع كل طبقة يعثر عليها LayerLoader في GLES، يتم استدعاءها "AndroidGLESLayer_Initialize": يمكنه التعرّف على قوائم وظائف libEGL وإجراء المكالمات AndroidGLESLayer_GetProcAddress لجميع الدوال المعروفة. الأمر متروك للطبقة لتحديد كيفية تتبع العنوان التالي. إذا اعترضت الطبقة دالة، فإنها تتبع عنوان الدالة. وإذا لم تعترض الطبقة الدالة، تعرض الدالة AndroidGLESLayer_GetProcAddress عنوان الدالة نفسه الذي كان عليه تمت بنجاح. بعد ذلك، تُعدِّل LayerLoader قائمة عناصر الجذب للدالة للإشارة إلى كنقطة دخول الطبقة.

لا تكون الطبقات غير مطلوبة للقيام بأي شيء بالمعلومات يوفّر كل من AndroidGLESLayer_Initialize وget_next_layer_proc_address، ولكن حيث يؤدي توفير البيانات إلى تسهيل الطبقات الموجودة، مثل أداة فحص وحدة معالجة الرسومات في Android RenderDoc، للدعم Android باستخدام هذه البيانات، يمكن للطبقة البحث عن الدوال بشكل مستقل بدلاً من في انتظار المكالمات على الرقم AndroidGLESLayer_GetProcAddress. إذا اختارت الطبقات قبل أن يستفسر القائم بالتحميل عن جميع نقاط الدخول، فإنها يجب أن يستخدم get_next_layer_proc_address. يجب على eglGetProcAddress يتم تمريرها لأسفل السلسلة إلى المنصة.

طبقات الأماكن

يبحث LayerLoader GLES عن طبقات في المواقع التالية، بالترتيب الأولوية:

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 وسياساته بشكل كبير من المنصات الأخرى من أجل تحميل طبقات خارجية، إحدى طبقات أحد يجب أن يكون ما يلي صحيحًا:

  • يتضمن ملف البيان للتطبيق المستهدَف ما يلي: عنصر البيانات الوصفية (لا ينطبق إلا إلى التطبيقات التي تستهدف Android 11 (المستوى 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>

إنشاء طبقة

يجب أن تكشف الطبقات الدالتين التاليتين الموضحتين في إعداد برنامج EGL Loader:

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);
  }
}