The following procedures describe how to run the Kindle Fire emulator. The emulator is a simulated hardware device that includes the Kindle Fire software and runs on your development computer. You can use the Kindle Fire emulator to test and debug your apps. For information about the system requirements for your development computer and for information about installing the emulator, see System Requirements for the Kindle Fire Emulator.
The Kindle Fire emulator consists of:
- Emulator components, installed when you set up your development environment.
- Android Virtual Devices (AVDs) to load on the emulator for each Kindle Fire tablet that you want to emulate. An AVD specifies the Kindle Fire system image and includes device configuration and storage.
The emulator loads the AVD that you specify, and then loads the system image and specified resources to create the emulation environment.
To launch the Kindle Fire emulator, use the Amazon AVD Launcher to set up and run an AVD that is preconfigured with the correct settings for Kindle Fire emulation. For information about using this tool, see Installing and Running the Amazon AVD Launcher.
As an alternative, a second way to launch the emulator is by using the Android Virtual Device Manager, where you manually specify the settings to emulate a Kindle Fire tablet. To configure an AVD manually by using Android Virtual Device Manager, see Using Android AVD Manager to Configure the Emulator. To help ensure that you correctly configure Kindle Fire emulation, we recommend that you use the Amazon AVD Launcher instead.
When the Kindle Fire emulator runs, it displays three buttons, except when emulating Kindle Fire (1st Generation) and Kindle Fire (2nd Generation) where it displays one button.
Click and drag down the menu bar at the top of the screen.
For Kindle Fire (1st Generation), click the gear icon for Tools at the top of the screen.
Rotating the Screen
To toggle between portrait and landscape mode, do one of the following:
- On a numeric keypad, with NumLock turned off, press 7 or 9.
- On a keyboard, press CTRL+F11. On OS X, you may need to press Ctrl+Fn+F11, depending on your keyboard preferences. Note: Occasionally, when emulating Kindle Fire (1st Generation), the operating system does not signal to an active app when the screen rotates from landscape to portrait. To rotate the app to portrait mode, exit the app, rotate to landscape and then portrait, and then run the app.
To enable location-based services in the emulator, do the following:
- Launch the Kindle Fire emulator, if it is not already running.
- In the emulator user interface, open Settings, and then tap Location-based Services.
- Tap On, and then tap OK.
For information about sending mock coordinates to the emulator, in the Android documentation see Providing Mock Location Data.
When possible, make sure to design your app to use any location provider that is available on the system. If you need to use a specific location provider, design your app to gracefully degrade when the location provider is not available. With this strategy, you can reuse your app on different devices and emulator environments with minimal code changes.
|Return to Kindle Fire|