aboutsummaryrefslogtreecommitdiffhomepage
path: root/tools/skqp/README.md
blob: 0a0c8db671f5822480eaae9fc9184e8555a4df14 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

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](https://developer.android.com/ndk/).

2.  [Checkout depot\_tools and Skia](https://skia.org/user/download),
    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](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
-------------

0.  Install the [Android SDK](https://developer.android.com/studio/#command-tools).

        mkdir ~/android-sdk
        ( cd ~/android-sdk; unzip ~/Downloads/sdk-tools-*.zip )
        yes | ~/android-sdk/tools/bin/sdkmanager --licenses
        export ANDROID_HOME=~/android-sdk

1.  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

2.  Find out where the report went (and look for Skia errors):

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

3.  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