GLES katmanları

Android 10 (API düzeyi 29) ve sonraki sürümleri çalıştıran cihazlarda OpenGL ES (GLES) katmanı kullanılabilir. Hata ayıklaması yapılabilir bir uygulama, temelinden APK'sından GLES katmanlarını yükleyebilir dizinden veya seçili katman APK'sından.

GLES katmanı kullanımı şuna benzer: Vulkan doğrulama katmanı kullanımı.

Gereksinimler

GLES katmanları yalnızca GLES 2.0 ve sonraki sürümlerde desteklenir.

Katman başlatma

Standart giriş noktaları doldurulduktan sonra EGL Yükleyici bir GLES örneği oluşturur LayerLoader Hata ayıklama katmanları etkinse LayerLoader taramaları belirtildi katmanlar için dizinler (ör. Vulkan yükleyici ekler.

Katman oluşturma etkinse LayerLoader, belirtilen bir değeri arar ve numaralandırır katman listesi. Katman listesi, iki nokta üst üste ile ayrılmış dosya adlarıyla belirtilir.

LayerLoader, katmanları belirttiğiniz sırada aktarır. Dolayısıyla ilk katman, katmanın hemen altındadır. Her katman için LayerLoader AndroidGLESLayer_Initialize ve AndroidGLESLayer_GetProcAddress giriş noktası. Katmanlar şunları sağlamalıdır: arayüzlerin yüklenebilir olmasını sağlayın.

typedef void* (*PFNEGLGETNEXTLAYERPROCADDRESSPROC)(void*, const char*);
void* AndroidGLESLayer_Initialize(void* layer_id, PFNEGLGETNEXTLAYERPROCADDRESSPROC get_next_layer_proc_address))

AndroidGLESLayer_Initialize(), katmanın kullanılması için bir tanımlayıcı sağlar (layer_id) ve aşağıdaki işlevleri aramak için çağrılabilecek bir giriş noktası katman. Giriş noktası, aşağıdaki kod örneğinde gösterildiği gibi kullanılabilir:

const char* func = "eglFoo";
void* gpa = get_next_layer_proc_address(layer_id, func);

AndroidGLESLayer_GetProcAddress, şu süre içinde sonraki aramanın adresini alacak: katmanın çağrılması gereken bir zincire göre yapılır. Sadece tek bir katman varsa next, çoğu işlev için doğrudan sürücüye işaret eder.

typedef __eglMustCastToProperFunctionPointerType EGLFuncPointer;
void* AndroidGLESLayer_GetProcAddress(const char *funcName, EGLFuncPointer next)

GLES LayerLoader tarafından bulduğu her katman için AndroidGLESLayer_Initialize, libEGL uygulamasının işlev listelerini ve çağrılarını yürütür Bilinen tüm işlevler için AndroidGLESLayer_GetProcAddress. Her şey bir arada sonraki adresin nasıl takip edileceğini belirler. Katman bir işleve müdahale ediyorsa fonksiyonun adresini izler. Katman bir işleve müdahale etmiyorsa AndroidGLESLayer_GetProcAddress, öncekiyle aynı işlev adresini döndürür başarılı oldu. Ardından LayerLoader, işlev kancası listesini katmanın giriş noktasını seçin.

Katmanların, bu bilgilerle herhangi bir işlem yapması gerekmez AndroidGLESLayer_Initialize ve get_next_layer_proc_address sağlar ancak verilerin sağlanması, mevcut katmanlar gibi Android GPU Denetleyicisi ve RenderDoc Android Bir katman, bu verilerle çalışırken değil, AndroidGLESLayer_GetProcAddress numaralı telefona yapılan aramalar bekleniyor. Katmanlar yükleyici tüm giriş noktalarını sorgulamadan önce kendisini ilk kullanıma hazırlar. get_next_layer_proc_address kullanmalıdır. eglGetProcAddress zincirden platforma iletilmelidir.

Yer katmanları

GLES LayerLoader, aşağıdaki konumlardaki katmanları sırayla arar: (öncelik):

1. Kök için sistem konumu

Bu işlem için kök erişim gerekir

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. Uygulamanın temel dizini

Hedef uygulama hata ayıklanabilir olmalı veya kök erişiminiz olmalıdır:

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. Harici APK

Hedef uygulamanızın ABI'sini belirleyin, ardından aşağıdakileri içeren bir APK yükleyin: yüklemek istediğiniz katmanlar:

adb install --abi armeabi-v7a layers.apk

4. Hedef uygulamanın APK'sında

Aşağıdaki örnekte, uygulama APK'sına katmanların nasıl yerleştirileceği gösterilmektedir:

$ 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

Katmanları etkinleştir

GLES katmanlarını uygulama başına veya genel olarak etkinleştirebilirsiniz. Uygulamaya özgü ayarlar kalıcı tüm yeniden başlatma işlemleri sırasında genel özellikler temizlenir.

Android'in güvenlik modeli ve politikaları birbirinden farklıdır diğer platformlardan çok daha fazla. Harici katmanları yüklemek için şu değer doğru olmalıdır:

  • Hedef uygulamanın manifest dosyasında şunlar yer alır: meta-data element (yalnızca yalnızca Android 11 (API düzeyi 30) veya sonraki sürümleri hedefleyen uygulamalar için geçerlidir:

    <meta-data android:name="com.android.graphics.injectLayers.enable" android:value="true" />

    Uygulamanızın profilini çıkarmak için bu seçeneği kullanmalısınız.

  • Hedef uygulamada hata ayıklanabilir. Bu seçenek, daha fazla hata ayıklama bilgisi sunar. uygulamanızın performansını olumsuz yönde etkileyebilir.

  • Hedef uygulama, işletim sisteminin Userdebug derlemesinde kök erişimi verir.

Uygulama başına katmanları etkinleştirmek için:

# 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>

Uygulama başına katmanları devre dışı bırakmak için:

# 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

Katmanları genel olarak etkinleştirmek için:

# This attempts to load layers for all applications, including native
# executables
adb shell setprop debug.gles.layers <layer1:layer2:layerN>

Katman oluşturma

Katmanlar, EGL Yükleyiciyi başlatma:

AndroidGLESLayer_Initialize
AndroidGLESLayer_GetProcAddress

Pasif katmanlar

Yalnızca birkaç işleve müdahale eden bir katmanda, pasif olarak başlatılmış katman optimum olmalıdır. Pasif olarak başlatılan katman bekleme süresinde fonksiyonunu başlatmak için GLES LayerLoader kodunu kullanın.

Aşağıdaki kod örneğinde pasif bir katmanın nasıl oluşturulacağı gösterilmektedir.

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

Etkin katmanlar

Önceden tamamen başlatılması gereken daha resmileştirilmiş katmanlar veya bilinmeyen uzantıları aramaları gereken uzantıları (ör. etkin katman) başlatma gereklidir. Katman AndroidGLESLayer_Initialize sağlayan get_next_layer_proc_address bir fonksiyon arar. Katman yine de Yükleyiciden AndroidGLESLayer_GetProcAddress istek göndererek platformun bilmesini sağlayın aramaları nereye yönlendireceğinizi seçin. Aşağıdaki kod örneğinde, etkin bir katmanıdır.

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