diff options
author | Yuly Novikov <ynovikov@chromium.org> | 2018-02-08 17:58:46 -0500 |
---|---|---|
committer | Commit Bot <commit-bot@chromium.org> | 2018-03-23 22:09:24 +0000 |
commit | ad4f9642a655bd24205ef156b9fa511ee34f87fd (patch) | |
tree | 3685c7a8d6cbd9fbbb6a75a69043b434ed97c9e0 /doc | |
parent | e6a40d07d2721bb56862d84cd85842db1ad95866 (diff) | |
download | angle-ad4f9642a655bd24205ef156b9fa511ee34f87fd.tar.gz |
Allow ANGLE libs to have arbitrary suffix.
In order to work with tools which intercept EGL and GLES calls.
BUG=angleproject:2343
Change-Id: I63aec7a56648dc4b3e7f4aff7f7d1608709ba118
Reviewed-on: https://chromium-review.googlesource.com/920652
Commit-Queue: Yuly Novikov <ynovikov@chromium.org>
Reviewed-by: Jamie Madill <jmadill@chromium.org>
Reviewed-by: Corentin Wallez <cwallez@chromium.org>
Diffstat (limited to 'doc')
-rw-r--r-- | doc/DebuggingTips.md | 28 |
1 files changed, 27 insertions, 1 deletions
diff --git a/doc/DebuggingTips.md b/doc/DebuggingTips.md index 793a1f8d8a..55ef6d3e5b 100644 --- a/doc/DebuggingTips.md +++ b/doc/DebuggingTips.md @@ -34,4 +34,30 @@ This is done with the gn arg: angle_shared_libvulkan = true ``` -When capturing traces of gtest based tests built inside Chromium checkout, make sure to run the tests with `--single-process-tests` argument.
\ No newline at end of file +When capturing traces of gtest based tests built inside Chromium checkout, make sure to run the tests with `--single-process-tests` argument. + +## Running ANGLE under GAPID on Android + +[GAPID](https://github.com/google/gapid) can be used to capture a trace of the Vulkan or OpenGL ES command stream on Android. +For it to work, ANGLE's libraries must have different names from the system OpenGL libraries. +This is done with the gn arg: +``` +angle_libs_suffix = "_ANGLE" +``` + +All [NativeTest](https://chromium.googlesource.com/chromium/src/+/master/testing/android/native_test/java/src/org/chromium/native_test/NativeTest.java) based tests share the same activity name, `org.chromium.native_test.NativeUnitTestNativeActivity`. Thus, prior to capturing your test trace, the specific test APK must be installed on the device. When you build the test, a test launcher is generated, for example, `./out/Release/bin/run_angle_end2end_tests`. The best way to install the APK is to run this test launcher once. + +In GAPID's "Capture Trace" dialog, "Package / Action:" should be +``` +android.intent.action.MAIN:org.chromium.native_test/org.chromium.native_test.NativeUnitTestNativeActivity +``` + +The mandatory [extra intent argument](https://developer.android.com/studio/command-line/adb.html#IntentSpec) for starting the activity is `org.chromium.native_test.NativeTest.StdoutFile`. Without it the test APK crashes. Test filters can be specified via either the `org.chromium.native_test.NativeTest.CommandLineFlags` or the `org.chromium.native_test.NativeTest.Shard` argument. +Example "Intent Arguments:" values in GAPID's "Capture Trace" dialog: +``` +-e org.chromium.native_test.NativeTest.StdoutFile /sdcard/chromium_tests_root/out.txt -e org.chromium.native_test.NativeTest.CommandLineFlags "--gtest_filter=*ES2_VULKAN" +``` +or +``` +-e org.chromium.native_test.NativeTest.StdoutFile /sdcard/chromium_tests_root/out.txt --esal org.chromium.native_test.NativeTest.Shard RendererTest.SimpleOperation/ES2_VULKAN,SimpleOperationTest.DrawWithTexture/ES2_VULKAN +```
\ No newline at end of file |