The Amazon Fire (HD) series of devices is a very cost-effective way to test your ShiVa games on Android devices. They are of fairly high quality, have average hardware specs and are easy to work with. There are only few downsides:
– The FireOS is a slightly modified version of Android. All UI screenshots you take will look off to Google tablet users.
– The FireOS version will always trail stock Android, sometimes by a large margin. Build against the correct (older) Android SDK!
– Development setup is a little different, hence this document.
– No Google Play Store and no Google Play Services on stock installs!
FireOS is an Android platform. Please read our ShiVa Android documentation, everything mentioned there still applies to this platform. In short, you will need the usual Android development packages:
– Android Studio 1.5 or later
– Java 7 or later
– Android SDKs for version 2.3, 4.0 or later (via Android Studio)
– Android NDK (current, via Android Studio)
– ANT (1.9.x, only for direct APK builds without Android Studio)
– CYGWIN (Windows only)
Don’t forget to add everything to your ShiVa paths:
Furthermore, you need to install the Fire Tablet USB driver. Without this driver, your PC will not recognize the device.
Fire Tablet developer setup
You need to put your tablet into development mode before you can connect to it for USB debugging, APK file transfer, shell debugging etc.
On your Fire tablet, go to Settings. On your Fire tablet (2014 or 2015 models), tap Device Options > Developer Options. On a 2013 model Kindle Fire tablet, tap Device > Developer Options, or on a 2013 model Kindle Fire tablet, tap Security.
Most likely, the Developer Options are hidden on your tablet (Fire HD and newer). Tap the device serial number seven times to reveal the Developer Options menu.
Set Enable ADB to On, and then accept the pop-up warning message:
Next, you need to enable Unknown Sources in the Security menu:
Connecting the Tablet with the PC
You are now set up to connect both devices through USB. When you do so, a message will pop up on the tablet, asking you for permission on USB debugging, which you will give in order to gain ADB access.
ADB is installed in the Android SDK platform-tools folder. You can test the connection to your device using ADB in a CMD terminal window, like so:
Always CD to the correct directory before using ADB, otherwise you will get a “not found” error message.
The screenshot shows 3 important commands:
– getprop ro.build.version.sdk shows the version of the Android SDK platform you should build against
– getprop ro.build.version.release shows the version of Android your FireOS is based on
– shell connects you to the device shell for direct command entry
Building and installing
You can build for Android/FireOS from ShiVa using the Android export panel.
– APK will create a package that you must install manually through ADB (see below)
– Android Studio ZIP will create an archive that can be loaded into Android Studio (recommended)
Once you have unpacked the ZIP and loaded the project into Android Studio (accept new Gradle wrapper settings if asked for them), you can then hit the Build button, which will
– build an APK of your game
– transfer the APK to your device and install the game
– start the game
– output the log (incl. ShiVa logs) in the Android Monitor window:
If for some reason Android Studio does not recognize the Fire device connected to your PC, you can manually install it through ADB. First, locate the APK path in the Android Studio project build folder:
Then install it using adb install $packetname: