অ্যান্ড্রয়েড ১০ (এপিআই লেভেল ২৯) এবং এর চেয়ে উন্নত সংস্করণে চালিত ডিভাইসগুলোতে ওপেনজিএল ইএস (জিএলইএস) লেয়ারিং উপলব্ধ। একটি ডিবাগযোগ্য অ্যাপ তার এপিকে, বেস ডিরেক্টরি অথবা নির্বাচিত কোনো লেয়ারের এপিকে থেকে জিএলইএস লেয়ারগুলো লোড করতে পারে।
GLES লেয়ারের ব্যবহার Vulkan ভ্যালিডেশন লেয়ারের ব্যবহারের অনুরূপ।
প্রয়োজনীয়তা
GLES লেয়ারগুলো শুধুমাত্র GLES ভার্সন 2.0+ এ সমর্থিত।
স্তর প্রারম্ভিকীকরণ
স্ট্যান্ডার্ড এন্ট্রি পয়েন্টগুলো পূরণ করার পর, EGL লোডার একটি GLES LayerLoader ইনস্ট্যানশিয়েট করে। যদি ডিবাগ লেয়ারগুলো সক্রিয় থাকে, তাহলে LayerLoader ভলকান লোডারের মতোই লেয়ারের জন্য নির্দিষ্ট ডিরেক্টরিগুলো স্ক্যান করে।
লেয়ারিং সক্রিয় থাকলে, 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-এর মতো বিদ্যমান লেয়ারগুলোর পক্ষে অ্যান্ড্রয়েডকে সমর্থন করা সহজ হয়। এই ডেটার সাহায্যে, একটি লেয়ার AndroidGLESLayer_GetProcAddress এর কলের জন্য অপেক্ষা না করে স্বাধীনভাবে ফাংশনগুলো খুঁজে নিতে পারে। যদি লোডার সমস্ত এন্ট্রি পয়েন্ট কোয়েরি করার আগেই লেয়ারগুলো নিজেদের ইনিশিয়ালাইজ করতে চায়, তবে তাদের অবশ্যই get_next_layer_proc_address ব্যবহার করতে হবে। eglGetProcAddress অবশ্যই চেইনের মাধ্যমে প্ল্যাটফর্মে পাস করতে হবে।
স্তরগুলি রাখুন
GLES LayerLoader অগ্রাধিকারের ক্রম অনুসারে নিম্নলিখিত স্থানগুলিতে লেয়ারগুলি অনুসন্ধান করে:
১. রুটের জন্য সিস্টেমের অবস্থান
এর জন্য রুট অ্যাক্সেস প্রয়োজন।
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/
২. অ্যাপ্লিকেশনটির মূল ডিরেক্টরি
টার্গেট অ্যাপ্লিকেশনটি অবশ্যই ডিবাগযোগ্য হতে হবে, অথবা আপনার রুট অ্যাক্সেস থাকতে হবে:
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
৩. বাহ্যিক APK
আপনার টার্গেট অ্যাপ্লিকেশনের ABI নির্ধারণ করুন, তারপর আপনি যে লেয়ারগুলো লোড করতে চান, সেগুলো সম্বলিত একটি APK ইনস্টল করুন:
adb install --abi armeabi-v7a layers.apk
৪. টার্গেট অ্যাপ্লিকেশনের 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 লেয়ারগুলো অ্যাপ-ভিত্তিক অথবা বিশ্বব্যাপী সক্রিয় করতে পারেন। অ্যাপ-ভিত্তিক সেটিংস রিবুটের পরেও অপরিবর্তিত থাকে, কিন্তু বিশ্বব্যাপী বৈশিষ্ট্যগুলো রিবুটের সময় মুছে যায়।
অ্যান্ড্রয়েডের নিরাপত্তা মডেল এবং নীতিমালা অন্যান্য প্ল্যাটফর্ম থেকে উল্লেখযোগ্যভাবে ভিন্ন। এক্সটার্নাল লেয়ার লোড করার জন্য, নিম্নলিখিত শর্তগুলোর মধ্যে একটি অবশ্যই সত্য হতে হবে:
টার্গেট অ্যাপের ম্যানিফেস্ট ফাইলে নিম্নলিখিত মেটা-ডেটা এলিমেন্টটি অন্তর্ভুক্ত থাকে (শুধুমাত্র সেইসব অ্যাপের ক্ষেত্রে প্রযোজ্য যেগুলো অ্যান্ড্রয়েড ১১ (এপিআই লেভেল ৩০) বা তার উচ্চতর সংস্করণকে টার্গেট করে):
<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 লোডার প্রারম্ভিকীকরণে বর্ণিত নিম্নলিখিত দুটি ফাংশন প্রকাশ করতে হবে:
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); } }