skia2/tools/skqp
Hal Canary 4080305f57 SkQP: add some scripts for admin
Change-Id: Idfba4c3e91eb048792ab395d4ab2e4a98ed8888c
Reviewed-on: https://skia-review.googlesource.com/98323
Reviewed-by: Hal Canary <halcanary@google.com>
Commit-Queue: Hal Canary <halcanary@google.com>
2018-01-22 22:28:06 +00:00
..
jni SkQP: replace blacklist with: DoNotExecuteInExperimentalMode and NoScoreInCompatibilityTestMode 2018-01-22 20:11:57 +00:00
gm_knowledge.cpp SkQP: replace blacklist with: DoNotExecuteInExperimentalMode and NoScoreInCompatibilityTestMode 2018-01-22 20:11:57 +00:00
gm_knowledge.h SkQP: replace blacklist with: DoNotExecuteInExperimentalMode and NoScoreInCompatibilityTestMode 2018-01-22 20:11:57 +00:00
gm_runner.cpp SkQP: replace blacklist with: DoNotExecuteInExperimentalMode and NoScoreInCompatibilityTestMode 2018-01-22 20:11:57 +00:00
gm_runner.h SkQP: replace blacklist with: DoNotExecuteInExperimentalMode and NoScoreInCompatibilityTestMode 2018-01-22 20:11:57 +00:00
inflate.py
make_apk.sh SkQP: add some scripts for admin 2018-01-22 22:28:06 +00:00
make_gmkb.go SkQP: replace blacklist with: DoNotExecuteInExperimentalMode and NoScoreInCompatibilityTestMode 2018-01-22 20:11:57 +00:00
make_known_tests.sh SkQP: add some scripts for admin 2018-01-22 22:28:06 +00:00
make_model.sh SkQP: add some scripts for admin 2018-01-22 22:28:06 +00:00
README.md SkQP: replace blacklist with: DoNotExecuteInExperimentalMode and NoScoreInCompatibilityTestMode 2018-01-22 20:11:57 +00:00
skqp_asset_manager.h
skqp.cpp SkQP: replace blacklist with: DoNotExecuteInExperimentalMode and NoScoreInCompatibilityTestMode 2018-01-22 20:11:57 +00:00
sysopen.py

SkQP

Motivation: Test an Android device's GPU and OpenGLES & Vulkan drivers with Skia and Skia's existing unit & rendering tests.

How To Use SkQP on your Android device:

  1. To build SkQP you need to install the Android NDK.

  2. Checkout depot_tools and Skia, then go to Skia's source directory:

    export PATH="${DEPOT_TOOLS_PATH}:$PATH"
    cd $SKIA_SOURCE_DIRECTORY
    
  3. Configure and build Skia for your device's architecture:

    arch='arm64'  # Also valid: 'arm', 'x68', 'x64'
    android_ndk="${HOME}/android-ndk"  # Or wherever you installed the NDK.
    mkdir -p out/${arch}-rel
    cat > out/${arch}-rel/args.gn << EOF
        ndk = "$android_ndk"
        ndk_api = 26
        target_cpu = "$arch"
        skia_embed_resources = true
        is_debug = false
    EOF
    tools/git-sync-deps
    bin/gn gen out/${arch}-rel
    ninja -C out/${arch}-rel skqp_lib
    
  4. Download meta.json from https://goo.gl/jBw3Dd . This is the data used to build the validation model.

  5. Generate the validation model data:

    go get -u go.skia.org/infra/golden/go/search
    go run tools/skqp/make_gmkb.go ~/Downloads/meta.json \
        platform_tools/android/apps/skqp/src/main/assets/gmkb
    

Run as an executable

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

    ninja -C out/${arch}-rel skqp
    adb shell "cd /data/local/tmp; rm -rf skqp_assets report"
    adb push platform_tools/android/apps/skqp/src/main/assets \
        /data/local/tmp/skqp_assets
    adb push out/${arch}-rel/skqp /data/local/tmp/
    adb shell "cd /data/local/tmp; ./skqp skqp_assets report"
    
  2. Get the error report if there are errors:

    adb pull /data/local/tmp/report /tmp/
    tools/skqp/sysopen.py /tmp/report/report.html
    

Run as an APK

  1. Install the Android SDK.

    mkdir ~/android-sdk
    ( cd ~/android-sdk; unzip ~/Downloads/sdk-tools-*.zip )
    yes | ~/android-sdk/tools/bin/sdkmanager --licenses
    export ANDROID_HOME=~/android-sdk
    
  2. Build the skqp.apk, load it on the device, and run the tests

    platform_tools/android/bin/android_build_app -C out/${arch}-rel skqp
    adb install -r out/${arch}-rel/skqp.apk
    adb logcat -c
    adb shell am instrument -w \
        org.skia.skqp/android.support.test.runner.AndroidJUnitRunner
    
  3. Find out where the report went (and look for Skia errors):

    adb logcat -d org.skia.skqp skia "*:S"
    
  4. Retrieve and view the report if there are any errors:

    adb pull /storage/emulated/0/Android/data/org.skia.skqp/files/output /tmp/
    tools/skqp/sysopen.py /tmp/output/skqp_report/report.html