Skip to content
This repository has been archived by the owner on Apr 17, 2021. It is now read-only.

Latest commit

 

History

History
38 lines (28 loc) · 3 KB

device_reference.md

File metadata and controls

38 lines (28 loc) · 3 KB

Echo Show device reference

- Fire OS 5: Based on Android 5.1 (Lollipop, API level 22)
- Fire OS 6: Based on Android 7.1 (Nougat, API level 25)
Series Release Code OS Size Resources DPI Emulator Resolution Available Height*
5 2019 AEOCH ? ? large ? ? 960x480 456dp
2 2018 AEOBP 5 10.1" xlarge mdpi WXGA 10.1 1280x800 770dp
1 2017 AEOKN 5 7" large mdpi ? 1024x600 570dp

We recommend developing on Android tablet emulators for developer efficiency: the recommended Android emulator images are mentioned above.

However, we ultimately recommend verifying behavior on device: the behavior on device differs from the emulator. Important note: locally built apps cannot be installed on production Echo Show devices so if you do not have a developer device, use the emulators.

  • Note that available height does not match actual height. Available height is the device's actual resolution minus space for the toolbar and similar "screen decorations". You can retrieve the available height values by querying resources.configuration.screenHeightDp on device. See documentation for details.

Known differences between Echo Show devices and Android tablet emulators

From a user experience perspective, we've noticed the following differences:

  • Device notifications appear differently (we don't think there are any on Echo Show)
  • Swiping from the top of the Echo Show screen will reveal a navigation bar including settings: this is different from the android settings and notification tray
  • The bottom navigation view (back, home, recent apps) does not exist on the Echo Show
  • The Echo Show supports some voice commands with Firefox such as, "Alexa, open Firefox" and emulators do not
  • The Echo Show's physical screen has different pixel densities than the Android emulator, making the images look stretched in different ways

From an implementation perspective, we've noticed the following differences:

  • onStop is not called when the device times out (#172)
  • If more than one WebView is created on the Echo Show device, the app will crash unlike Android

Distinguishing devices in code

We distinguish devices using the screen height metric from the Android resources system:

  • All devices will use resources with no qualifiers (e.g. layout)
  • Devices will use the largest qualified file that is smaller than or equal to their available height

See the table above to see which screen size metric each device uses.

We previously used screen size, but were forced to change because the series 5 shares the same bucket as the series 1, despite being substantially smaller.