Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support
Native
Skip to main content
The Amazon Cloud App Program uses cloud streaming to deliver existing Fire OS APKs to Vega OS devices. If your app is enrolled in this program and you have ported your code to React Native for Vega, use this guide to submit a Vega OS package to replace the cloud-streamed version.

Packages and versioning in Vega OS

If you have an Android or iOS app development background, versioning your Vega OS package file has a few key differences:
  • Package format: Instead of an APK (Android) or IPA (iOS), Vega OS uses a VPKG file as the app binary. When your submitted VPKG goes live in the Amazon Appstore, the mini-wrapper VPKG file used for cloud streaming is replaced automatically.
  • Versioning configuration: Android and iOS define versions in configuration files (build.gradle, Info.plist). On Vega OS, versions are set as build command flags or in package.json scripts, not in the manifest file.
    • Version number: On Android, you set versionName in the build.gradle file. On Vega OS, you pass the --build-version flag at build time as a freeform string (for example, 1.2.3).
    • Build number: On Android, you set versionCode as an integer in the build.gradle file. On Vega OS, you pass the --build-number flag at build time. Like Android’s versionCode, this must be an increasing integer.

Migration overview

During this process, you follow these high-level steps:
  1. Find the build number of your live app in the Developer Console.
  2. Build your VPKG, making sure to properly set the versioning in that file.
  3. Create a new Vega OS release and upload your VPKG. When you upload your VPKG file to the Developer Console, you change the supported devices for the Fire OS APK file and Vega OS VPKG file so that your new VPKG can target Vega OS devices.
After you submit your updates and Amazon approves your app, your app becomes available on Vega OS devices.

Prerequisites

Before you start, you must have:

Step 1: Find the build number of your live app

The VPKG file you build must have a greater version and build number than your live cloud-streamed Fire OS app. You can find your current app’s version name and build number in the Developer Console. To find the version name and build number of your live cloud-streamed app
  1. Sign in to the Developer Console.
  2. From the navigation bar, choose My Apps.
  3. Find and open the Fire OS app that’s enrolled in the Amazon Cloud App Program.
  4. On the Release Tracks screen, choose View next to your Fire OS release.
  5. Find your uploaded APK that is being cloud-streamed.
    In the uploaded files section, there is a note that indicates the app is in the Cloud App Program.

    An app enrolled in the Cloud App Program.

  6. Select Manifest on the uploaded APK. Make a note of the Version Name and Build Number.

Step 2: Build your VPKG

Build a release VPKG with a version and build number greater than those of your live cloud-streamed Fire OS APK. Select the appropriate tab based on the tool you use to build your app.
To build your release VPKG file
  1. In your package.json file, set the --build-version and --build-number flags to values greater than those noted in Step 1: Find the build number of your live app. Set --build-type to Release:
    For more details on versioning, see Version Your App.
  2. In VS Code, select the Vega extension icon from the activity bar to open the Vega Studio panel.
  3. Select your project from Vega Studio > Projects.
  4. Choose Release from the Build Mode section.
  5. Select the build icon (wrench) next to your project name to start the build. The build creates VPKG files in the build folder. For app submission, use the VPKG file in the build/armv7-release folder:
  6. At the command prompt, you can verify the version and build number in your VPKG:
    Confirm that the version and build_number values in the output are greater than those of your live mini-VPKG.
  7. Make sure your VPKG package name matches the Fire OS APK package name.
For more details on the build process for Vega apps, see Build Your App.

Before you submit

Before you submit your app, you can test it using Live App Testing (LAT). With LAT, you can distribute your app to a pre-defined set of testers before going live. To learn more, see Understanding Live App Testing for Vega.

Step 3: Create a new Vega OS release and upload your VPKG

In this step, you add a Vega OS release track to your existing app listing, upload your VPKG file, and reassign device targeting so that Vega OS devices receive the VPKG instead of the cloud-streamed APK. Amazon must approve your updates before your Vega OS app goes live.
  1. Sign in to the Developer Console.
  2. From the navigation bar, choose My Apps.
  3. Find and open the Fire OS app that’s enrolled in the Amazon Cloud App Program.
  4. Before you create your Vega OS release track, you must remove support for Vega OS devices on your Fire OS APK:
    1. On the Release Tracks screen, choose View on the Fire OS release.
    2. In the Supported devices section, choose View supported devices.
    3. Select the Amazon Fire TV tab, then select Deselect All under Amazon Vega TV.
    4. Choose Save.
    5. Choose Submit for Review.
  5. Now you can create your Vega OS release:
    1. On the Release Tracks screen, choose Create a release in the Vega OS section.
    2. In the App file(s) section, upload your VPKG file.
    3. In the Supported devices section, choose Edit supported devices.
    4. Select the Amazon Fire TV tab, and then select all devices that you want to support under Amazon Vega TV.
    5. Before saving your device selections, make sure to review the statement next to the checkbox about your app’s removal from the Cloud App Program. Click the box to acknowledge you understand, and then choose Save.
    6. Complete the remaining fields for the release, then choose Submit for Review.
After your app is published, a notice is sent to your existing users to update their app. After your users perform the update, they’re no longer using cloud streaming and are using your Vega OS app.
Last modified on November 16, 2026