How can we help?

Creating an Amazon Fire TV App (Java based) Follow

Prerequisites

  1. Install Android Studio
  2. Install Android Debug Bridge (ADB)
  3. Create an Amazon developer account

Note: IT or developer support is strongly recommended. Visit our Partner Marketplace for app production and publishing resources.

Downloading and Opening the Bundle

In order to generate an Amazon Fire TV Java based bundle using this SDK, you must first pull the latest source code from Zype's github repository. This can be found at "https://github.com/zype/zype-firebuilder".


Click the green Clone or download button on the right, and select Download ZIP.

image6.png

Next, pick a location on your computer to save the .zip file. Once the .zip file download is complete, unzip the file to reveal its contents.

Open Android Studio, and open the Application folder in Android Studio (File > Open > zype-firebuilder-master > Application).

image1.png

Building the App with the Template Variant

Navigate to Application > ZypeAPI > build.gradle

Update the file to use templateDebug as the defaultPublishConfig instead of zypeDebug. 

image9.png

Make sure to save your changes (File > Save All).

App Customizations (Required)

App Name

Navigate to app > res > values > strings.xml

You’ll need to update the app_name and app_name_short in the following strings.xml files:

  • strings.xml
  • strings.xml (template)

image3.png

Note: Your app_name and app_name_short can be the same.

You’ll need to update the app_name in the other remaining strings.xml files:

  • strings.xml (de)
  • strings.xml (de, template)
  • strings.xml (en)
  • strings.xml (en, template)
  • strings.xml (ja)
  • strings.xml (ja, template)

Make sure to save your changes (File > Save All).

Application ID

Navigate to Application > app > build.gradle

You’ll need to update the <APPLICATION_ID> from within this file.

image8.png

If you are resubmitting your Amazon Fire TV app, you should use the same application ID that is associated with your existing live app. 

Note: the defaultConfig and template applicationID should be the same (see image above). 

Images

Company Logo

Navigate to app > res > drawable > logo_company.png AND logo_company.png (template)

The image dimensions should be approximately 356 x 108 px and have a transparent background. You should keep the image file name as logo_company.

App Icon

Navigate to app > res > mipmap

You will need to replace the image in all of the following ic_launcher files (-mdpi, -mdpi, template, -hdpi, -hdpi template, -xhdpi, -xhdpi template, -xxhdpi, -xxhdpi template). You should keep all of the image file names as ic_launcher.

The image dimensions should be approximately 512 x 512 px.

Root Playlist, App and OAuth Keys

Navigate to ZypeAPI > src > template > java > com > zype > fire > api > ZypeSettings.java

You'll need to replace the following Client Settings - ClientID, ClientSecret, AppKey and RootPlaylistID in order to pull in your content, playlists and metadata information stored in Zype.

image7.png

These keys can be found in your Zype account by creating an Amazon Fire TV app under the 'Manage Apps' section.

Make sure to save your changes (File > Save All).

App Customizations (Optional)

Brand Color

To use your brand color for highlighting buttons and widgets, navigate to app > res > values > custom.xml

Update the accent color resource: <color name="accent">#00AEEF</color>

Monetization

Navigate to ZypeAPI > src > template > java > com > zype > fire > api > ZypeSettings.java

Set the subscription details to true/false as you see fit.

Disable Native Subscription: public static final boolean NATIVE_SUBSCRIPTION_ENABLED = false;

Enable Native Subscription: public static final boolean NATIVE_SUBSCRIPTION_ENABLED = true;

Disable Universal Subscription: public static final boolean UNIVERSAL_SUBSCRIPTION_ENABLED = false;

Enable Universal Subscription: public static final boolean UNIVERSAL_SUBSCRIPTION_ENABLED = true;

image4.png

Note: Advertising is supported as part of the template.   

If you are monetizing through Native Subscription, you must set up Native In-App Subscriptions within your Amazon developer account and Android Studio. Please read and complete the following documentation HERE.

Make sure that you save all your changes (File > Save All). Then, proceed to generating your signed APK. 

Generate Signed APK

Please following these step-by-step instructions for signing an APK here.

image5.png

You’ll want to generate a key and keystore and proceed to manually signing your APK.  

The .apk file that is generated during the signing process will be what you upload to your Amazon developer account and submit to the marketplace. 

 

 

Comments

Please sign in to leave a comment.