Appsee OpenGL ES (Android) Integration Instructions

Important Note

Video recording is not supported when running in Emulator. Please use a real device to test video recordings.
  1. Configure your project with gradle if you haven't done so.
    If you are not using gradle, you can install Appsee manually.
  2. Add the Appsee as a dependency to your build.gradle file: dependencies {
      implementation 'com.appsee:appsee-android-gl:+'
  3. Add the API Key to your AndroidManifest.xml file (before the closing </application> tag):
    <meta-data android:name="com.appsee.ApiKey" android:value="YOUR API KEY" /> Your API keys are available in the Appsee dashboard.
    You will need to register or login in order to view your API keys.
  4. In every activity that is an entry point to your app* add: import com.appsee.Appsee;and add a call to Appsee.start inside the onCreate method:
    Appsee.start(); *Entry activities are usually those which have a custom <intent-filter> element in the AndroidManifest.xml file.
  5. If you are using a GLSurfaceView.Renderer, replace the following line: myGLSurfaceView.setRenderer(myRenderer); With this line: myGLSurfaceView.setRenderer(
    new AppseeGLSurfaceViewRenderer(myGLSurfaceView, myRenderer));

    In case you are using your own render loop:

    1. Call:
      Appsee.onGLSurfaceChanged(mySurfaceView, width, height); at the beginning of your onSurfaceChanged method.
    2. Call:
      Appsee.onBeginRenderLoop(); at the beginning of your onDrawFrame method.
    3. Call:
      Appsee.appendGLFrame(); at the end of your onDrawFrame method.
  6. If you're using ProGuard, add the following configuration to the "proguard-project.txt" file: -keep class com.appsee.** { *; }
    -dontwarn com.appsee.** ;
    -keep class** { *; }
    -keep interface** { *; }
    -keep class androidx.** { *; }
    -keep interface androidx.** { *; }
    -keepattributes SourceFile,LineNumberTable
    And remove the following, if defined: -renamesourcefileattribute SourceFile
That's it, you're good to go!
Now, launch your app, use it for a few seconds and minimize the app to the background.
Visit the dashboard to view your first tracked session.

What's next?

You can review the full API reference docs to customize your Appsee implementation.
Here are a few important topics to review: If you have any questions or need any assistance please contact us at