Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(85)

Unified Diff: docs/android_test_instructions.md

Issue 1634043003: [Android] Update android test instructions. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Created 4 years, 11 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « no previous file | no next file » | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: docs/android_test_instructions.md
diff --git a/docs/android_test_instructions.md b/docs/android_test_instructions.md
index 616a970b63b5ce8dc664a719643d69010987f6d3..71131ab94cef017d7137a9fdcc8f7d7f7dc5c828 100644
--- a/docs/android_test_instructions.md
+++ b/docs/android_test_instructions.md
@@ -114,9 +114,11 @@ else, e.g.: `ninja -C out/Release chrome_public_test_apk`
## Running Tests
-All functional tests are run using `build/android/test_runner.py`.
+All functional tests are run using `build/android/test_runner.py`, either
+directly or via a generated wrapper script in `<output directory>/bin/`.
Tests are sharded across all attached devices. In order to run tests, call:
`build/android/test_runner.py <test_type> [options]`
+(or `<generated wrapper script> [options]`).
For a list of valid test types, see `test_runner.py --help`. For
help on a specific test type, run `test_runner.py <test_type> --help`.
@@ -130,7 +132,8 @@ out\_android, then do `export CHROMIUM_OUT_DIR=out_android` before running the
command below. You have to do this even if your "out" directory is a symlink
pointing to "out_android". You can also use `--output-directory` to point to the
path of your output directory, for example,
-`--output-directory=out_android/Debug`.
+`--output-directory=out_android/Debug`. (The generated wrapper scripts handle
+this automatically.)
## INSTALL\_FAILED\_CONTAINER\_ERROR or INSTALL\_FAILED\_INSUFFICIENT\_STORAGE
@@ -205,11 +208,10 @@ build/android/test_runner.py junit -s chrome_junit_tests --release -vvv
ninja -C out/Release content_unittests_apk
# Run a test suite
-build/android/test_runner.py gtest -s content_unittests --release -vvv
+out/Release/bin/run_content_unittests [-vv]
# Run a subset of tests
-build/android/test_runner.py gtest -s content_unittests --release -vvv \
---gtest-filter ByteStreamTest.*
+out/Release/bin/run_content_unittests [-vv] --gtest-filter ByteStreamTest.*
```
## Instrumentation Tests
@@ -219,8 +221,8 @@ UNLOCKED. Otherwise, the test will timeout trying to launch an intent.
Optionally you can disable screen lock under Settings -> Security -> Screen Lock
-> None.
-Next, you need to build the app, build your tests, install the application APK,
-and then run your tests (which will install the test APK automatically).
+Next, you need to build the app, build your tests, and then run your tests
+(which will install the APK under test and the test APK automatically).
Examples:
@@ -233,12 +235,8 @@ ninja -C out/Release content_shell_apk
# Build the tests themselves
ninja -C out/Release content_shell_test_apk
-# Install the code under test
-build/android/adb_install_apk.py out/Release/apks/ContentShell.apk
-
-# Run the test (will automagically install the test APK)
-build/android/test_runner.py instrumentation --test-apk=ContentShellTest \
---isolate-file-path content/content_shell_test_apk.isolate --release -vv
+# Run the test (will automagically install the APK under test and the test APK)
+out/Release/bin/run_content_shell_test_apk [-vv]
```
ChromePublic tests:
@@ -250,12 +248,8 @@ ninja -C out/Release chrome_public_apk
# Build the tests themselves
ninja -C out/Release chrome_public_test_apk
-# Install the code under test
-build/android/adb_install_apk.py out/Release/apks/ChromePublic.apk
-
-# Run the test (will automagically install the test APK)
-build/android/test_runner.py instrumentation --test-apk=ChromePublicTest \
---isolate-file-path chrome/chrome_public_test_apk.isolate --release -vv
+# Run the test (will automagically install the APK under test and the test APK)
+out/Release/bin/run_chrome_public_test_apk [-vv]
```
AndroidWebView tests:
@@ -263,37 +257,31 @@ AndroidWebView tests:
```shell
ninja -C out/Release android_webview_apk
ninja -C out/Release android_webview_test_apk
-build/android/adb_install_apk.py out/Release/apks/AndroidWebView.apk \
-build/android/test_runner.py instrumentation --test-apk=AndroidWebViewTest \
---test_data webview:android_webview/test/data/device_files --release -vvv
+out/Release/bin/run_android_webview_test_apk [-vv]
```
-Use adb\_install\_apk.py to install the app under test, then run the test
-command. In order to run a subset of tests, use -f to filter based on test
+In order to run a subset of tests, use -f to filter based on test
class/method or -A/-E to filter using annotations.
Filtering examples:
```shell
# Run a test suite
-build/android/test_runner.py instrumentation --test-apk=ContentShellTest
+out/Debug/bin/run_content_shell_test_apk
# Run a specific test class
-build/android/test_runner.py instrumentation --test-apk=ContentShellTest -f \
-AddressDetectionTest
+out/Debug/bin/run_content_shell_test_apk -f AddressDetectionTest.*
# Run a specific test method
-build/android/test_runner.py instrumentation --test-apk=ContentShellTest -f \
+out/Debug/bin/run_content_shell_test_apk -f \
AddressDetectionTest#testAddressLimits
# Run a subset of tests by size (Smoke, SmallTest, MediumTest, LargeTest,
# EnormousTest)
-build/android/test_runner.py instrumentation --test-apk=ContentShellTest -A \
-Smoke
+out/Debug/bin/run_content_shell_test_apk -A Smoke
# Run a subset of tests by annotation, such as filtering by Feature
-build/android/test_runner.py instrumentation --test-apk=ContentShellTest -A \
-Feature=Navigation
+out/Debug/bin/run_content_shell_test_apk -A Feature=Navigation
```
You might want to add stars `*` to each as a regular expression, e.g.
« no previous file with comments | « no previous file | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698