GLES স্তর

অ্যান্ড্রয়েড ১০ (এপিআই লেভেল ২৯) এবং তার উচ্চতর ভার্সন চালিত ডিভাইসগুলিতে, OpenGL ES (GLES) লেয়ারিং উপলব্ধ। একটি ডিবাগযোগ্য অ্যাপ তার APK থেকে, তার বেস ডিরেক্টরি থেকে, অথবা একটি নির্বাচিত লেয়ার APK থেকে GLES লেয়ার লোড করতে পারে।

GLES স্তরের ব্যবহার Vulkan যাচাইকরণ স্তর ব্যবহারের অনুরূপ।

আবশ্যকতা

GLES স্তরগুলি শুধুমাত্র GLES সংস্করণ 2.0+ তে সমর্থিত।

স্তর আরম্ভকরণ

স্ট্যান্ডার্ড এন্ট্রি পয়েন্টগুলি পূরণ করার পরে, EGL লোডার একটি 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

৩. বহিরাগত 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 স্তর সক্ষম করতে পারেন। রিবুট জুড়ে প্রতি-অ্যাপ সেটিংস টিকে থাকে, যখন রিবুট করার সময় বিশ্বব্যাপী বৈশিষ্ট্যগুলি সাফ করা হয়।

অ্যান্ড্রয়েডের নিরাপত্তা মডেল এবং নীতিগুলি অন্যান্য প্ল্যাটফর্ম থেকে উল্লেখযোগ্যভাবে আলাদা। বহিরাগত স্তরগুলি লোড করার জন্য, নিম্নলিখিতগুলির মধ্যে একটি সত্য হতে হবে:

  • টার্গেট অ্যাপের ম্যানিফেস্ট ফাইলে নিম্নলিখিত মেটা-ডেটা উপাদান থাকে (শুধুমাত্র Android 11 (API লেভেল 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 লোডার ইনিশিয়ালাইজেশনে বর্ণিত নিম্নলিখিত দুটি ফাংশন লেয়ারগুলিকে অবশ্যই প্রকাশ করতে হবে:

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 লোডার জানে না, তাদের এক্সটেনশন খুঁজতে হবে, তাদের জন্য সক্রিয় লেয়ার ইনিশিয়ালাইজেশন প্রয়োজন। লেয়ারটি 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);
  }
}