Diese Seite wurde von der Cloud Translation API übersetzt.

GLES-Ebenen

Auf Geräten mit Android 10 (API-Level 29) und höher ist die OpenGL ES-Ebene (GLES) verfügbar. Eine Debug-fähige App kann GLES-Ebenen aus ihrem APK von der Basis aus laden. oder aus einem ausgewählten Ebenen-APK.

Die Nutzung der GLES-Schicht ähnelt der Verwendung der Vulkan-Validierungsebene

Voraussetzungen

GLES-Ebenen werden nur ab GLES-Version 2.0 unterstützt.

Ebeneninitialisierung

Nach dem Ausfüllen von standardmäßigen Einstiegspunkten instanziiert der EGL Loader ein GLES. LayerLoader Wenn Debug-Ebenen aktiviert sind, sind die angegebenen LayerLoader-Scans für Layer wie das Vulkan loader.

Wenn das Layering aktiviert ist, sucht LayerLoader nach einem bestimmten Liste der Ebenen. Die Ebenenliste wird durch Dateinamen angegeben, die durch einen Doppelpunkt getrennt sind.

Der LayerLoader durchläuft die Ebenen in der von Ihnen angegebenen Reihenfolge, sodass die erste befindet sich direkt unter der Anwendung. Für jede Ebene wird mit dem LayerLoader verfolgt AndroidGLESLayer_Initialize und AndroidGLESLayer_GetProcAddress Einstiegspunkte. Die Layer müssen diese als ladebar sein.

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

AndroidGLESLayer_Initialize() stellt eine Kennung für die zu verwendende Ebene bereit. (layer_id) und einen Einstiegspunkt, der zum Nachschlagen von Funktionen unten aufgerufen werden kann auf der Ebene. Der Einstiegspunkt kann wie im folgenden Codebeispiel gezeigt verwendet werden:

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

AndroidGLESLayer_GetProcAddress übernimmt die Adresse des nächsten Anrufs im die die Ebene nach Abschluss aufrufen soll. Wenn es nur eine Ebene gibt, next verweist für die meisten Funktionen direkt auf den Treiber.

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

Für jede Schicht, die der GLES-LayerLoader findet, ruft er AndroidGLESLayer_Initialize, durchläuft die Funktionslisten und -aufrufe von libEGL AndroidGLESLayer_GetProcAddress für alle bekannten Funktionen. Es liegt an dem Layer wie die nächste Adresse nachverfolgt werden kann. Wenn die Schicht eine Funktion abfängt, wird die Adresse der Funktion verfolgt. Wenn die Schicht keine Funktion abfängt, AndroidGLESLayer_GetProcAddress gibt dieselbe Funktionsadresse zurück. bestanden. Mit LayerLoader wird dann die Liste der Funktions-Hooks aktualisiert, sodass sie auf den an den Einstiegspunkt der Ebene.

Die Ebenen müssen nichts mit den Informationen tun. AndroidGLESLayer_Initialize und get_next_layer_proc_address geben Folgendes an, aber erleichtert das Bereitstellen vorhandener Ebenen, z. B. Android GPU Inspector und RenderDoc zur Unterstützung Android Mit diesen Daten kann eine Ebene unabhängig nach Funktionen Warten auf Anrufe bei AndroidGLESLayer_GetProcAddress. Wenn die Ebenen initialisieren, bevor der Loader alle Einstiegspunkte abgefragt hat, muss get_next_layer_proc_address verwenden. eglGetProcAddress muss über die Kette an die Plattform weitergegeben werden.

Ebenen platzieren

Das GLES-LayerLoader sucht nach Ebenen an den folgenden Orten in der angegebenen Reihenfolge der Priorität:

1. Systemspeicherort für Root

Hierfür ist Root-Zugriff erforderlich

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. Basisverzeichnis der Anwendung

Die Zielanwendung muss debug-fähig sein oder Sie benötigen Root-Zugriff:

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

Bestimme die ABI deiner Ziel-App und installiere dann ein APK mit Ebenen, die Sie laden möchten:

adb install --abi armeabi-v7a layers.apk

4. Im APK der Ziel-App

Das folgende Beispiel zeigt, wie Ebenen im App-APK platziert werden:

$ 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

Ebenen aktivieren

Sie können GLES-Ebenen entweder pro App oder global aktivieren. Einstellungen für einzelne Apps bleiben erhalten während globale Properties beim Neustart gelöscht werden.

Das Sicherheitsmodell und die Richtlinien von Android unterscheiden sich deutlich von anderen Plattformen. Um externe Layers zu laden, muss eine der muss Folgendes zutreffen:

Die Manifestdatei der Ziel-App enthält Folgendes: meta-data element (gilt nur für für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind:

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

Sie sollten diese Option verwenden, um ein Profil für Ihre Anwendung zu erstellen.
Die Ziel-App ist debug-fähig. Mit dieser Option erhalten Sie weitere Informationen zur Fehlerbehebung, aber die Leistung Ihrer App beeinträchtigen könnte.
Die Ziel-App wird in einem UserDebug-Build des Betriebssystems ausgeführt, gewährt Root-Zugriff.

So aktivieren Sie Ebenen pro App:

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

So deaktivieren Sie Ebenen pro App:

# 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

So aktivieren Sie Ebenen global:

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

Ebene erstellen

Ebenen müssen die folgenden beiden Funktionen bereitstellen, die unter EGL-Loader-Initialisierung:

AndroidGLESLayer_Initialize
AndroidGLESLayer_GetProcAddress

Passive Ebenen

Für einen Layer, der nur eine Handvoll Funktionen abfängt, wird ein ist die passiv initialisierte Ebene optimal. Der passiv initialisierte Layer wartet damit GLES LayerLoader die benötigte Funktion initialisieren kann.

Das folgende Codebeispiel zeigt, wie eine passive Ebene erstellt wird.

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

Aktive Ebenen

Für formalisiertere Layer, die im Voraus vollständig initialisiert werden müssen, oder Layers die nach Erweiterungen suchen müssen, die dem EGL Loader nicht bekannt sind, aktiver Layer Initialisierung ist erforderlich. Die Ebene verwendet die get_next_layer_proc_address, die AndroidGLESLayer_Initialize für nach einer Funktion suchen. Die Ebene muss trotzdem auf AndroidGLESLayer_GetProcAddress-Anfragen vom Loader, damit die Plattform weiß wohin Anrufe weitergeleitet werden sollen. Im folgenden Codebeispiel wird gezeigt, wie Sie ein aktives Ebene.

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