tree: b4f2f69fcf2d3a4eb770fe6d506047b7ab88086d [path history] [tgz]
  1. jni/
  2. download_model
  3. generate_gn_args
  4. gm_knowledge.cpp
  5. gm_knowledge.h
  6. gm_runner.cpp
  7. gm_runner.h
  11. make_gmkb.go
  14. make_universal_apk
  16. remove_unneeded_assets
  17. run_skqp_exe
  18. setup_resources
  19. skqp.cpp
  20. skqp_asset_manager.h
  22. upload_model


SkQP (Skia Quality Program) is a component of the Android CTS (Compatablity Test Suite) that tests an Android device‘s GPU and OpenGLES & Vulkan drivers using Skia’s existing unit & rendering tests.

How to run the SkQP tests

  1. Get the dependencies:

    • You will need Java JDK 8, git, and python.

    • Install Chromium's depot_tools. Add it to your PATH.

      git clone ''
      export PATH="${PWD}/depot_tools:${PATH}"
    • Install the Android NDK.

      ( cd ~; unzip ~/Downloads/android-ndk-*.zip )
      ANDROID_NDK=$(ls ~/android-ndk-*)   # Or wherever you installed the Android NDK.
    • Install the Android SDK. Set the ANDROID_HOME environment variable.

      mkdir ~/android-sdk
      ( cd ~/android-sdk; unzip ~/Downloads/sdk-tools-*.zip )
      yes | ~/android-sdk/tools/bin/sdkmanager --licenses
      export ANDROID_HOME=~/android-sdk  # Or wherever you installed the Android SDK.

      Put adb in your PATH.

      export PATH="${PATH}:${ANDROID_HOME}/platform-tools"
  2. Get the right version of Skia:

    git clone
    cd skia
    git checkout origin/skqp/dev  # or whatever release tag you need
  3. Download dependencies and the model:

    python tools/skqp/download_model
    python tools/skqp/setup_resources
    python tools/git-sync-deps
  4. Configure the build:

    python tools/skqp/generate_gn_args out/skqp-arm "$ANDROID_NDK" \
           --arch arm \
           --api_level 26
    bin/gn gen out/skqp-arm

    If you want to test another architecture, replace arm with x86, x64 or arm64. Run ‘python tools/skqp/generate_gn_args -h’ for all options.

  5. Build, install, and run.

    platform_tools/android/bin/android_build_app -C out/skqp-arm skqp
    adb install -r out/skqp-arm/skqp.apk
    adb logcat -c
    adb shell am instrument -w org.skia.skqp
  6. Monitor the output with:

    adb logcat org.skia.skqp skia "*:S"

    Note the test's output path on the device. It will look something like this:

    01-23 15:22:12.688 27158 27173 I org.skia.skqp:
    output written to "/storage/emulated/0/Android/data/org.skia.skqp/files/output"
  7. Retrieve and view the report with:

    adb pull $OUTPUT_LOCATION /tmp/
    tools/skqp/ /tmp/output/skqp_report/report.html

Running a single test

To run a single test, for example gles/aarectmodes:

adb shell am instrument -e class 'org.skia.skqp.SkQPRunner#gles/aarectmodes' -w org.skia.skqp

Unit tests can be run with the unitTest/ prefix:

adb shell am instrument -e class 'org.skia.skqp.SkQPRunner#unitTest/GrSurface -w org.skia.skqp

Run as a non-APK executable

  1. Follow steps 1-4 as above.

  2. Build the SkQP program, load files on the device, and run skqp:

    ninja -C out/skqp-arm skqp
    python tools/skqp/run_skqp_exe out/skqp-arm