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