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

Unified Diff: docs/android_test_instructions.md

Issue 2627003006: Fix a typo and adjust formatting (Closed)
Patch Set: Created 3 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 5254d01e758e5ee0c8d488a502e493b65fd22a86..5bd33bca79dbd603236fafb91e2436afd7325bde 100644
--- a/docs/android_test_instructions.md
+++ b/docs/android_test_instructions.md
@@ -16,7 +16,8 @@ debugging:
* Go to "Developer options"
* Check "USB debugging".
* Un-check "Verify apps over USB".
-* On Jelly Bean and above, developer options are hidden by default. To unhide them:
+* On Jelly Bean and above, developer options are hidden by default. To unhide
+ them:
* Go to "About phone"
* Tap 10 times on "Build number"
* The "Developer options" menu will now be available.
@@ -25,9 +26,9 @@ debugging:
#### Screen
-You MUST ensure that the screen stays on while testing: `adb shell svc power
-stayon usb` Or do this manually on the device: Settings -> Developer options
--> Stay Awake.
+You **must** ensure that the screen stays on while testing: `adb shell svc power
+stayon usb` Or do this manually on the device: Settings -> Developer options ->
+Stay Awake.
If this option is greyed out, stay awake is probably disabled by policy. In that
case, get another device or log in with a normal, unmanaged account (because the
@@ -35,15 +36,20 @@ tests will break in exciting ways if stay awake is off).
#### Enable Asserts
- adb shell setprop debug.assert 1
+```
+adb shell setprop debug.assert 1
+```
#### Disable Verify Apps
-You may see a dialog like
-[this one](http://www.samsungmobileusa.com/simulators/ATT_GalaxyMega/mobile/screens/06-02_12.jpg),
+You may see a dialog like [this
+one](http://www.samsungmobileusa.com/simulators/ATT_GalaxyMega/mobile/screens/06-02_12.jpg),
which states, _Google may regularly check installed apps for potentially harmful
behavior._ This can interfere with the test runner. To disable this dialog, run:
-`adb shell settings put global package_verifier_enable 0`
+
+```
+adb shell settings put global package_verifier_enable 0
+```
### Emulator Setup
@@ -51,9 +57,9 @@ behavior._ This can interfere with the test runner. To disable this dialog, run:
Use an emulator (i.e. Android Virtual Device, AVD): Enabling Intel's
Virtualizaton support provides the fastest, most reliable emulator configuration
-available (i.e. x86 emulator with GPU acceleration and KVM support).
-Remember to build with `target_arch=ia32` for x86. Otherwise installing the APKs
-will fail with `INSTALL_FAILED_NO_MATCHING_ABIS`.
+available (i.e. x86 emulator with GPU acceleration and KVM support). Remember to
+build with `target_arch=ia32` for x86. Otherwise installing the APKs will fail
+with `INSTALL_FAILED_NO_MATCHING_ABIS`.
1. Enable Intel Virtualization support in the BIOS.
@@ -83,8 +89,8 @@ will fail with `INSTALL_FAILED_NO_MATCHING_ABIS`.
```
This script will attempt to use GPU emulation, so you must be running the
- emulators in an environment with hardware rendering available. See
- `avd.py --help` for more details.
+ emulators in an environment with hardware rendering available. See `avd.py
+ --help` for more details.
#### Option 2
@@ -95,7 +101,7 @@ settings, since Chromium requires it to render.
## Building Tests
If you're adding a new test file, you'll need to explicitly add it to a gn
-target. If you're adding a test to an existing file, you won't to make gn
+target. If you're adding a test to an existing file, you won't need to make gn
changes, but you may be interested in where your test winds up. In either case,
here are some guidelines for where a test belongs:
@@ -111,19 +117,19 @@ second directory rather than the top-level one.
Java test files vary a bit more widely than their C++ counterparts:
- - Instrumentation test files -- i.e., tests that will run on a device --
-typically belong in either `<top-level directory>_javatests` or
-`<top-level directory>_test_java`. Regardless, they'll wind up getting packaged
-into one of a few test APKs:
- - `android_webview_test_apk` for anything in `//android_webview`
- - `content_shell_test_apk` for anything in `//content` or below
- - `chrome_public_test_apk` for most things in `//chrome`
- - `chrome_sync_shell_test_apk` in a few exceptional cases
- - JUnit or Robolectric test files -- i.e., tests that will run on the host --
-typically belong in `<top-level directory>_junit_tests` (e.g. `base_junit_tests`
-for `//base`), though here again there are cases (particularly in
-`//components`) where suites are split at the second directory rather than the
-top-level one.
+- Instrumentation test files -- i.e., tests that will run on a device --
+ typically belong in either `<top-level directory>_javatests` or `<top-level
+ directory>_test_java`. Regardless, they'll wind up getting packaged into one
+ of a few test APKs:
+ - `android_webview_test_apk` for anything in `//android_webview`
+ - `content_shell_test_apk` for anything in `//content` or below
+ - `chrome_public_test_apk` for most things in `//chrome`
+ - `chrome_sync_shell_test_apk` in a few exceptional cases
+- JUnit or Robolectric test files -- i.e., tests that will run on the host --
+ typically belong in `<top-level directory>_junit_tests` (e.g.
+ `base_junit_tests` for `//base`), though here again there are cases
+ (particularly in `//components`) where suites are split at the second
+ directory rather than the top-level one.
Once you know what to build, just do it like you normally would build anything
else, e.g.: `ninja -C out/Release chrome_public_test_apk`
@@ -161,7 +167,7 @@ tune2fs -e continue android_emulator_sdk/sdk/system-images/android-24/x86/userda
## Symbolizing Crashes
-Crash stacks are logged and can be viewed using adb logcat. To symbolize the
+Crash stacks are logged and can be viewed using `adb logcat`. To symbolize the
traces, define `CHROMIUM_OUTPUT_DIR=$OUTDIR` where `$OUTDIR` is the argument you
pass to `ninja -C`, and pipe the output through
`third_party/android_platform/development/scripts/stack`. If
@@ -269,8 +275,8 @@ ninja -C out/Release android_webview_test_apk
out/Release/bin/run_android_webview_test_apk [-vv]
```
-In order to run a subset of tests, use -f to filter based on test
-class/method or -A/-E to filter using annotations.
+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:
« 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