Docs: extend Android emulator docs
No change to logic, only docs.
This extends Android emulator docs to address two issues:
1. x86 emulators don't work with arm-compiled APKs. Although this is,
in some sense, obvious, it's worth calling out since ARM-compiled
APKs are fairly common due to the popularity of the architecture.
2. Make it easier to find "Google APIs" images in the AVD creation
wizard. This explains you need to go to the "x86 Images" tab in the
wizard.
Bug: 955135, 918221
Test: tools/md_browser/md_browser.py
Test: Upload to gerrit > open file > click "gitiles"
Change-Id: Id87efe8c8b8c96dc01f72819bd8c31199507c416
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/1578071
Commit-Queue: Nate Fischer <[email protected]>
Reviewed-by: Andrew Grieve <[email protected]>
Cr-Commit-Position: refs/heads/master@{#653216}diff --git a/docs/android_emulator.md b/docs/android_emulator.md
index 394fac5..9a72634 100644
--- a/docs/android_emulator.md
+++ b/docs/android_emulator.md
@@ -2,6 +2,13 @@
Always use x86 emulators (or x86\_64 for testing 64-bit APKs). Although arm
emulators exist, they are so slow that they are not worth your time.
+*** note
+**Note:** apps with native code must be compiled specifically for the device
+architecture, so make sure your copy of the app supports x86. Also, be aware the
+Play Store may not display ARM-only applications for an x86 emulator. The steps
+below show how to locally compile chromium-based apps for x86.
+***
+
## Building for Emulation
You need to target the correct architecture via GN args:
```gn
@@ -27,14 +34,15 @@
### Choosing an Image
Android Studio's image labels roughly translate to the following:
-| AVD "Target" | GMS? | Build Properties |
-| --- | --- | --- |
-| Google Play | This has GMS | `user`/`release-keys` |
-| Google APIs | This has GMS | `userdebug`/`dev-keys` |
-| No label | AOSP image, does not have GMS | `eng`/`test-keys` |
+| AVD "Target" | Virtual Device Configuration tab | GMS? | Build Properties |
+| --- | --- | --- | --- |
+| Google Play | "Recommended" (the default tab) | This has GMS | `user`/`release-keys` |
+| Google APIs | "x86 Images" | This has GMS | `userdebug`/`dev-keys` |
+| No label | "x86 Images" | AOSP image, does not have GMS | `eng`/`test-keys` |
*** promo
-If you're not sure which to use, **choose Google APIs**.
+**Tip:** if you're not sure which to use, choose **Google APIs** under the **x86
+Images** tab in the Virtual Device Configuration wizard.
***
### Configuration
