2017-12-11 22:46:26 +00:00
|
|
|
|
|
|
|
SkQP
|
|
|
|
====
|
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
How to run the SkQP tests
|
|
|
|
-------------------------
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
1. Install Chromium's depot\_tools
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
git clone 'https://chromium.googlesource.com/chromium/tools/depot_tools.git'
|
|
|
|
export PATH="${PWD}/depot_tools:${PATH}"
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
2. Install the [Android NDK](https://developer.android.com/ndk/downloads/).
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
cd ~
|
|
|
|
unzip ~/Downloads/android-ndk-*.zip
|
2018-01-25 15:01:01 +00:00
|
|
|
ANDROID_NDK=~/android-ndk-* # Or wherever you installed the Android NDK.
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
3. Install the [Android SDK](https://developer.android.com/studio/#command-tools)
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
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.
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-25 16:30:05 +00:00
|
|
|
Put `adb` in your `PATH`.
|
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
4. Get the right version of Skia:
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
git clone https://skia.googlesource.com/skia.git
|
|
|
|
cd skia
|
2018-01-25 15:01:01 +00:00
|
|
|
git checkout origin/skqp/dev # or whatever release tag you need
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-25 15:01:01 +00:00
|
|
|
5. Download dependencies, the model, and configure the build. (If you want to
|
|
|
|
test another architecture, replace `arm` with `x86`, `x64`, or `arm64`.)
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
python tools/skqp/download_model
|
2018-01-30 16:30:48 +00:00
|
|
|
python tools/skqp/setup_resources
|
2018-01-24 18:42:38 +00:00
|
|
|
python tools/git-sync-deps
|
|
|
|
python tools/skqp/generate_gn_args out/skqp-arm "$ANDROID_NDK" arm
|
|
|
|
bin/gn gen out/skqp-arm
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
6. Build, install, and run.
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
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/android.support.test.runner.AndroidJUnitRunner
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
7. Monitor the output with:
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
adb logcat org.skia.skqp skia "*:S"
|
2017-12-11 22:46:26 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
Note the test's output path on the device. It will look something like this:
|
2017-12-21 20:13:20 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
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"
|
2017-12-21 20:13:20 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
8. Retrieve and view the report with:
|
2017-12-12 14:42:14 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
OUTPUT_LOCATION="/storage/emulated/0/Android/data/org.skia.skqp/files/output"
|
|
|
|
adb pull $OUTPUT_LOCATION /tmp/
|
|
|
|
tools/skqp/sysopen.py /tmp/output/skqp_report/report.html
|
2017-12-12 14:42:14 +00:00
|
|
|
|
2018-01-25 15:01:01 +00:00
|
|
|
Run as a non-APK executable
|
|
|
|
---------------------------
|
2018-01-19 18:08:23 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
1. Follow steps 1-5 as above.
|
2018-01-19 18:08:23 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
2. Build the SkQP program, load files on the device, and run skqp:
|
2018-01-19 18:08:23 +00:00
|
|
|
|
2018-01-24 18:42:38 +00:00
|
|
|
ninja -C out/skqp-arm skqp
|
2018-01-25 16:30:05 +00:00
|
|
|
python tools/skqp/run_skqp_exe out/skqp-arm
|
2017-12-12 14:42:14 +00:00
|
|
|
|