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

Side by Side Diff: docs/android_test_instructions.md

Issue 1314513007: [Docs]: Update to match style guide. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: fixes Created 5 years, 3 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 unified diff | Download patch
« no previous file with comments | « no previous file | docs/common_build_tasks.md » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 # Android Test Instructions 1 # Android Test Instructions
2 2
3 Device Setup Tests are runnable on physical devices or emulators. See the 3 Device Setup Tests are runnable on physical devices or emulators. See the
4 instructions below for setting up either a physical device or an emulator. 4 instructions below for setting up either a physical device or an emulator.
5 5
6 [TOC] 6 [TOC]
7 7
8 ## Physical Device Setup **ADB Debugging** 8 ## Physical Device Setup **ADB Debugging**
9 9
10 In order to allow the ADB to connect to the device, you must enable USB 10 In order to allow the ADB to connect to the device, you must enable USB
11 debugging: 11 debugging:
12 * Before Android 4.1 (Jelly Bean): 12
13 * Go to "System Settings" 13 * Before Android 4.1 (Jelly Bean):
14 * Go to "Developer options" 14 * Go to "System Settings"
15 * Check "USB debugging". 15 * Go to "Developer options"
16 * Un-check "Verify apps over USB". 16 * Check "USB debugging".
17 * On Jelly Bean, developer options are hidden by default. To unhide them: 17 * Un-check "Verify apps over USB".
18 * Go to "About phone" 18 * On Jelly Bean, developer options are hidden by default. To unhide them:
19 * Tap 10 times on "Build number" 19 * Go to "About phone"
20 * The "Developer options" menu will now be available. 20 * Tap 10 times on "Build number"
21 * Check "USB debugging". 21 * The "Developer options" menu will now be available.
22 * Un-check "Verify apps over USB". 22 * Check "USB debugging".
23 * Un-check "Verify apps over USB".
23 24
24 ### Screen 25 ### Screen
25 26
26 You MUST ensure that the screen stays on while testing: `adb shell svc power 27 You MUST ensure that the screen stays on while testing: `adb shell svc power
27 stayon usb` Or do this manually on the device: Settings -> Developer options 28 stayon usb` Or do this manually on the device: Settings -> Developer options
28 -> Stay Awake. 29 -> Stay Awake.
29 30
30 If this option is greyed out, stay awake is probably disabled by policy. In that 31 If this option is greyed out, stay awake is probably disabled by policy. In that
31 case, get another device or log in with a normal, unmanaged account (because the 32 case, get another device or log in with a normal, unmanaged account (because the
32 tests will break in exciting ways if stay awake is off). 33 tests will break in exciting ways if stay awake is off).
33 34
34 ### Enable Asserts! 35 ### Enable Asserts!
35 36
36 `adb shell setprop debug.assert 1` 37 adb shell setprop debug.assert 1
37 38
38 ### Disable Verify Apps 39 ### Disable Verify Apps
39 40
40 You may see a dialog like 41 You may see a dialog like
41 [this one](http://www.samsungmobileusa.com/simulators/ATT_GalaxyMega/mobile/scre ens/06-02_12.jpg), 42 [this one](http://www.samsungmobileusa.com/simulators/ATT_GalaxyMega/mobile/scre ens/06-02_12.jpg),
42 which states, _Google may regularly check installed apps for potentially harmful 43 which states, _Google may regularly check installed apps for potentially harmful
43 behavior._ This can interfere with the test runner. To disable this dialog, run: 44 behavior._ This can interfere with the test runner. To disable this dialog, run:
44 `adb shell settings put global package_verifier_enable 0` 45 `adb shell settings put global package_verifier_enable 0`
45 46
46 ## Emulator Setup 47 ## Emulator Setup
(...skipping 40 matching lines...) Expand 10 before | Expand all | Expand 10 after
87 Alternatively, you can create an run your own emulator using the tools provided 88 Alternatively, you can create an run your own emulator using the tools provided
88 by the Android SDK. When doing so, be sure to enable GPU emulation in hardware 89 by the Android SDK. When doing so, be sure to enable GPU emulation in hardware
89 settings, since Chromium requires it to render. 90 settings, since Chromium requires it to render.
90 91
91 ## Building Tests 92 ## Building Tests
92 93
93 It may not be immediately obvious where your test code gets compiled to, so here 94 It may not be immediately obvious where your test code gets compiled to, so here
94 are some general rules: 95 are some general rules:
95 96
96 * If your test code lives under /content, it will probably be built as part of 97 * If your test code lives under /content, it will probably be built as part of
97 the content\_shell\_test\_apk * If your test code lives under /chrome (or 98 the content_shell_test_apk
98 higher), it will probably be built as part of the chrome\_public\_test\_apk * 99 * If your test code lives under /chrome (or higher), it will probably be built
99 (Please fill in more details here if you know them). 100 as part of the chrome_public_test_apk
101 * (Please fill in more details here if you know them).
100 102
101 NB: We used to call the chrome\_public\_test\_apk the 103 NB: We used to call the chrome_public_test_apk the
102 chromium\_shell\_test\_apk. There may still be references to this kicking 104 chromium_shell_test_apk. There may still be references to this kicking
103 around, but wherever you see chromium\_shell\_test you should replace with 105 around, but wherever you see chromium_shell_test you should replace with
104 chrome\_public\_test. 106 chrome_public_test.
105 107
106 Once you know what to build, just do it like you normally would build anything 108 Once you know what to build, just do it like you normally would build anything
107 else, e.g.: `ninja -C out/Release chrome_public_test_apk` 109 else, e.g.: `ninja -C out/Release chrome_public_test_apk`
108 110
109 ## Running Tests 111 ## Running Tests
110 112
111 All functional tests are run using `build/android/test_runner.py`. 113 All functional tests are run using `build/android/test_runner.py`.
112 Tests are sharded across all attached devices. In order to run tests, call: 114 Tests are sharded across all attached devices. In order to run tests, call:
113 `build/android/test_runner.py <test_type> [options]` 115 `build/android/test_runner.py <test_type> [options]`
114 For a list of valid test types, see `test_runner.py --help`. For 116 For a list of valid test types, see `test_runner.py --help`. For
(...skipping 138 matching lines...) Expand 10 before | Expand all | Expand 10 after
253 See 255 See
254 https://sites.google.com/a/chromium.org/dev/developers/testing/webkit-layout-tes ts 256 https://sites.google.com/a/chromium.org/dev/developers/testing/webkit-layout-tes ts
255 257
256 ## Running GPU tests 258 ## Running GPU tests
257 259
258 (e.g. the "Android Debug (Nexus 7)" bot on the chromium.gpu waterfall) 260 (e.g. the "Android Debug (Nexus 7)" bot on the chromium.gpu waterfall)
259 261
260 See http://www.chromium.org/developers/testing/gpu-testing for details. Use 262 See http://www.chromium.org/developers/testing/gpu-testing for details. Use
261 --browser=android-content-shell. Examine the stdio from the test invocation on 263 --browser=android-content-shell. Examine the stdio from the test invocation on
262 the bots to see arguments to pass to src/content/test/gpu/run\_gpu\_test.py. 264 the bots to see arguments to pass to src/content/test/gpu/run\_gpu\_test.py.
OLDNEW
« no previous file with comments | « no previous file | docs/common_build_tasks.md » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698