Android 10 (एपीआई लेवल 29) और उसके बाद के वर्शन वाले डिवाइसों पर, OpenGL ES (GLES) लेयरिंग उपलब्ध है. डीबग करने लायक ऐप्लिकेशन, अपने APK से और बेस से जीएलईएस लेयर लोड कर सकता है या चुनी हुई लेयर वाले APK से डाउनलोड करने के लिए कहें.
GLES लेयर का इस्तेमाल, Vulkan की पुष्टि करने वाली लेयर के इस्तेमाल से मिलता-जुलता है.
ज़रूरी शर्तें
GLES लेयर सिर्फ़ GLES के 2.0 और उसके बाद के वर्शन पर काम करती हैं.
लेयर को शुरू करना
स्टैंडर्ड एंट्री पॉइंट की जानकारी अपने-आप भरने के बाद, ईजीएल लोडर जीएलईएस को इंस्टैंशिएट करता है
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
अपने टारगेट ऐप्लिकेशन के एबीआई का पता लगाएं. इसके बाद, ऐसी लेयर वाला 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>
लेयर बनाना
लेयर में नीचे दिए गए वे दो फ़ंक्शन होने चाहिए जिनके बारे में इसमें बताया गया है ईजीएल लोडर शुरू करना:
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 लोडर, सक्रिय लेयर के बारे में नहीं पता होते
शुरू करना ज़रूरी है. लेयर, किसी फ़ंक्शन को खोजने के लिए, AndroidGLESLayer_Initialize
से मिले get_next_layer_proc_address
का इस्तेमाल करती है. लेयर को अब भी लोडर के 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); } }