xref: /aosp_15_r20/external/skia/site/docs/dev/testing/skqp.md (revision c8dee2aa9b3f27cf6c858bd81872bdeb2c07ed17)
1*c8dee2aaSAndroid Build Coastguard Worker
2*c8dee2aaSAndroid Build Coastguard Worker---
3*c8dee2aaSAndroid Build Coastguard Workertitle: "SkQP"
4*c8dee2aaSAndroid Build Coastguard WorkerlinkTitle: "SkQP"
5*c8dee2aaSAndroid Build Coastguard Worker
6*c8dee2aaSAndroid Build Coastguard Worker---
7*c8dee2aaSAndroid Build Coastguard Worker
8*c8dee2aaSAndroid Build Coastguard Worker
9*c8dee2aaSAndroid Build Coastguard WorkerDevelopment APKs of SkQP are kept in Google storage.  Each file in named
10*c8dee2aaSAndroid Build Coastguard Workerwith a abbreviated Git hash that points at the commit in the Skia repository it
11*c8dee2aaSAndroid Build Coastguard Workerwas built with.
12*c8dee2aaSAndroid Build Coastguard Worker
13*c8dee2aaSAndroid Build Coastguard WorkerThese are universal APKs that contain native libraries for armeabi-v7a,
14*c8dee2aaSAndroid Build Coastguard Workerarm64-v8a, x86, and x86\_64 architectures. The most recent is listed first.
15*c8dee2aaSAndroid Build Coastguard Worker
16*c8dee2aaSAndroid Build Coastguard WorkerThe listing can be found here:
17*c8dee2aaSAndroid Build Coastguard Worker[https://storage.googleapis.com/skia-skqp/apklist](https://storage.googleapis.com/skia-skqp/apklist)
18*c8dee2aaSAndroid Build Coastguard Worker
19*c8dee2aaSAndroid Build Coastguard WorkerIf you are looking at Android CTS failures, use the most recent commit on the
20*c8dee2aaSAndroid Build Coastguard Worker`origin/skqp/release` branch.
21*c8dee2aaSAndroid Build Coastguard Worker
22*c8dee2aaSAndroid Build Coastguard WorkerTo run tests:
23*c8dee2aaSAndroid Build Coastguard Worker
24*c8dee2aaSAndroid Build Coastguard Worker    adb install -r skqp-universal-{APK_SHA_HERE}.apk
25*c8dee2aaSAndroid Build Coastguard Worker    adb logcat -c
26*c8dee2aaSAndroid Build Coastguard Worker    adb shell am instrument -w org.skia.skqp
27*c8dee2aaSAndroid Build Coastguard Worker
28*c8dee2aaSAndroid Build Coastguard WorkerMonitor the output with:
29*c8dee2aaSAndroid Build Coastguard Worker
30*c8dee2aaSAndroid Build Coastguard Worker    adb logcat TestRunner org.skia.skqp skia DEBUG "*:S"
31*c8dee2aaSAndroid Build Coastguard Worker
32*c8dee2aaSAndroid Build Coastguard WorkerNote the test's output path on the device.  It will look something like this:
33*c8dee2aaSAndroid Build Coastguard Worker
34*c8dee2aaSAndroid Build Coastguard Worker    01-23 15:22:12.688 27158 27173 I org.skia.skqp:
35*c8dee2aaSAndroid Build Coastguard Worker    output written to "/storage/emulated/0/Android/data/org.skia.skqp/files/skqp_report_2019-02-28T102058"
36*c8dee2aaSAndroid Build Coastguard Worker
37*c8dee2aaSAndroid Build Coastguard WorkerRetrieve and view the report with:
38*c8dee2aaSAndroid Build Coastguard Worker
39*c8dee2aaSAndroid Build Coastguard Worker    OUTPUT_LOCATION="/storage/emulated/0/Android/data/org.skia.skqp/files/skqp_report_2019-02-28T102058"
40*c8dee2aaSAndroid Build Coastguard Worker    adb pull "$OUTPUT_LOCATION" /tmp/
41*c8dee2aaSAndroid Build Coastguard Worker
42*c8dee2aaSAndroid Build Coastguard Worker(Your value of `$OUTPUT_LOCATION` will differ from mine.
43*c8dee2aaSAndroid Build Coastguard Worker
44*c8dee2aaSAndroid Build Coastguard WorkerOpen the file `/tmp/output/skqp_report_2019-02-28T102058/report.html` .
45*c8dee2aaSAndroid Build Coastguard Worker
46*c8dee2aaSAndroid Build Coastguard Worker**Zip up that directory to attach to a bug report:**
47*c8dee2aaSAndroid Build Coastguard Worker
48*c8dee2aaSAndroid Build Coastguard Worker    cd /tmp
49*c8dee2aaSAndroid Build Coastguard Worker    zip -r skqp_report_2019-02-28T102058.zip skqp_report_2019-02-28T102058
50*c8dee2aaSAndroid Build Coastguard Worker    ls -l skqp_report_2019-02-28T102058.zip
51*c8dee2aaSAndroid Build Coastguard Worker
52*c8dee2aaSAndroid Build Coastguard Worker* * *
53*c8dee2aaSAndroid Build Coastguard Worker
54*c8dee2aaSAndroid Build Coastguard WorkerFor more information about building your own APK, refer to
55*c8dee2aaSAndroid Build Coastguard Workerhttps://skia.googlesource.com/skia/+/main/tools/skqp/README.md
56*c8dee2aaSAndroid Build Coastguard Worker
57