تتوفّر طبقات OpenGL ES (GLES) على الأجهزة التي تعمل بالإصدار 10 من نظام التشغيل Android (المستوى 29 لواجهة برمجة التطبيقات) والإصدارات الأحدث. يمكن للتطبيق القابل للتصحيح تحميل طبقات 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 GPU Inspector و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" />
عليك استخدام هذا الخيار لإنشاء ملف تعريفي لتطبيقك.
التطبيق المستهدف قابل للتصحيح. يمنحك هذا الخيار المزيد من معلومات تصحيح الأخطاء، ولكنه قد يؤثر سلبًا على أداء تطبيقك.
يعمل التطبيق المستهدَف على إصدار تصحيح أخطاء المستخدم من نظام التشغيل الذي يمنح إمكانية الوصول إلى الجذر.
لتفعيل الطبقات لكل تطبيق:
# 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); } }