OLD | NEW |
1 # Android Test Instructions | 1 # Android Test Instructions |
2 | 2 |
3 [TOC] | 3 [TOC] |
4 | 4 |
5 ## Device Setup | 5 ## Device Setup |
6 | 6 |
7 ### Physical Device Setup | 7 ### Physical Device Setup |
8 | 8 |
9 #### ADB Debugging | 9 #### ADB Debugging |
10 | 10 |
(...skipping 103 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
114 second directory rather than the top-level one. | 114 second directory rather than the top-level one. |
115 | 115 |
116 ### Java | 116 ### Java |
117 | 117 |
118 Java test files vary a bit more widely than their C++ counterparts: | 118 Java test files vary a bit more widely than their C++ counterparts: |
119 | 119 |
120 - Instrumentation test files -- i.e., tests that will run on a device -- | 120 - Instrumentation test files -- i.e., tests that will run on a device -- |
121 typically belong in either `<top-level directory>_javatests` or `<top-level | 121 typically belong in either `<top-level directory>_javatests` or `<top-level |
122 directory>_test_java`. Regardless, they'll wind up getting packaged into one | 122 directory>_test_java`. Regardless, they'll wind up getting packaged into one |
123 of a few test APKs: | 123 of a few test APKs: |
124 - `android_webview_test_apk` for anything in `//android_webview` | 124 - `webview_instrumentation_test_apk` for anything in `//android_webview` |
125 - `content_shell_test_apk` for anything in `//content` or below | 125 - `content_shell_test_apk` for anything in `//content` or below |
126 - `chrome_public_test_apk` for most things in `//chrome` | 126 - `chrome_public_test_apk` for most things in `//chrome` |
127 - `chrome_sync_shell_test_apk` in a few exceptional cases | 127 - `chrome_sync_shell_test_apk` in a few exceptional cases |
128 - JUnit or Robolectric test files -- i.e., tests that will run on the host -- | 128 - JUnit or Robolectric test files -- i.e., tests that will run on the host -- |
129 typically belong in `<top-level directory>_junit_tests` (e.g. | 129 typically belong in `<top-level directory>_junit_tests` (e.g. |
130 `base_junit_tests` for `//base`), though here again there are cases | 130 `base_junit_tests` for `//base`), though here again there are cases |
131 (particularly in `//components`) where suites are split at the second | 131 (particularly in `//components`) where suites are split at the second |
132 directory rather than the top-level one. | 132 directory rather than the top-level one. |
133 | 133 |
134 Once you know what to build, just do it like you normally would build anything | 134 Once you know what to build, just do it like you normally would build anything |
(...skipping 128 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
263 # Build the tests themselves | 263 # Build the tests themselves |
264 ninja -C out/Release chrome_public_test_apk | 264 ninja -C out/Release chrome_public_test_apk |
265 | 265 |
266 # Run the test (will automagically install the APK under test and the test APK) | 266 # Run the test (will automagically install the APK under test and the test APK) |
267 out/Release/bin/run_chrome_public_test_apk [-vv] | 267 out/Release/bin/run_chrome_public_test_apk [-vv] |
268 ``` | 268 ``` |
269 | 269 |
270 AndroidWebView tests: | 270 AndroidWebView tests: |
271 | 271 |
272 ```shell | 272 ```shell |
273 ninja -C out/Release android_webview_apk | 273 ninja -C out/Release webview_instrumentation_apk |
274 ninja -C out/Release android_webview_test_apk | 274 ninja -C out/Release webview_instrumentation_test_apk |
275 out/Release/bin/run_android_webview_test_apk [-vv] | 275 out/Release/bin/run_webview_instrumentation_test_apk [-vv] |
276 ``` | 276 ``` |
277 | 277 |
278 In order to run a subset of tests, use -f to filter based on test class/method | 278 In order to run a subset of tests, use -f to filter based on test class/method |
279 or -A/-E to filter using annotations. | 279 or -A/-E to filter using annotations. |
280 | 280 |
281 Filtering examples: | 281 Filtering examples: |
282 | 282 |
283 ```shell | 283 ```shell |
284 # Run a test suite | 284 # Run a test suite |
285 out/Debug/bin/run_content_shell_test_apk | 285 out/Debug/bin/run_content_shell_test_apk |
(...skipping 20 matching lines...) Expand all Loading... |
306 | 306 |
307 See [Layout Tests](testing/layout_tests.md). | 307 See [Layout Tests](testing/layout_tests.md). |
308 | 308 |
309 ## Running GPU tests | 309 ## Running GPU tests |
310 | 310 |
311 (e.g. the "Android Debug (Nexus 7)" bot on the chromium.gpu waterfall) | 311 (e.g. the "Android Debug (Nexus 7)" bot on the chromium.gpu waterfall) |
312 | 312 |
313 See https://www.chromium.org/developers/testing/gpu-testing for details. Use | 313 See https://www.chromium.org/developers/testing/gpu-testing for details. Use |
314 `--browser=android-content-shell`. Examine the stdio from the test invocation on | 314 `--browser=android-content-shell`. Examine the stdio from the test invocation on |
315 the bots to see arguments to pass to `src/content/test/gpu/run_gpu_test.py`. | 315 the bots to see arguments to pass to `src/content/test/gpu/run_gpu_test.py`. |
OLD | NEW |