Migrate from Cloud Streaming to Vega OS

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.

Important: When you migrate your cloud streaming app to Vega OS, you don't need to request removal from the Amazon Cloud App Program.

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:

Find the build number of your live app in the Developer Console.
Build your VPKG, making sure to properly set the versioning in that file.
Add an upcoming version of your app 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:

Vega developer tools installed. For details, see Install the Vega Developer Tools.
Your Android-based Fire OS project ported to a React Native for Vega project. To get started developing for Vega OS, see Develop for Vega.

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

Sign in to the Developer Console.
From the navigation bar, choose My Apps.
Find and open the Fire OS app that's enrolled in the Amazon Cloud App Program.
On the Upload Your App File screen, find your uploaded APK that is being cloud-streamed.

The Upload Your App File screen with an app enrolled in the Cloud App Program.
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.

Important: Don't use com.amazon.category.main as your VPKG package name. This value is a manifest intent category, not a package identifier. Your VPKG package name must match your Fire OS APK package name (for example, com.example.myapp).

Select the appropriate tab based on the tool you use to build your app.

Vega Studio
Vega CLI

To build your release VPKG file

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:
```
"scripts": {
  ...
  "build:release": "react-native build-vega --build-type Release --build-version 1.2.3 --build-number 101",
}
```
For more details on versioning, see Version Your App.
In VS Code, select the Vega extension icon from the activity bar to open the Vega Studio panel.
Select your project from Vega Studio > Projects.
Choose Release from the Build Mode section.
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:
```
<project-root>/build/armv7-release/<project-name>_armv7.vpkg
```
At the command prompt, you can verify the version and build number in your VPKG:
```
vega exec vpt info <path-to-vpkg> --json
```
Confirm that the version and build_number values in the output are greater than those of your live mini-VPKG.
Make sure your VPKG package name matches the Fire OS APK package name.

To build your release VPKG file

Navigate to your Vega project directory:
```
cd <your-project>
```
Note: If needed, run npm install to make sure your dependencies are up to date.
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:
```
"scripts": {
  ...
  "build:release": "react-native build-vega --build-type Release --build-version 1.2.3 --build-number 101",
}
```
Alternatively, pass the flags directly from the command line:
```
npx react-native build-vega --build-type Release --build-version 1.2.3 --build-number 101
```
For more details on versioning, see Version Your App.
Run the release build:
```
npm run build:release
```
The build creates VPKG files in the build folder. For app submission, use the VPKG file in the build/armv7-release folder:
```
<project-root>/build/armv7-release/<project-name>_armv7.vpkg
```
Verify the version and build number in your VPKG:
```
vega exec vpt info <path-to-vpkg> --json
```
Confirm that the version and build_number values in the output are greater than those of your live mini-VPKG.
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: Add an upcoming version of your app and upload your VPKG

In this step, you add an upcoming version 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.

Note: When you submit a VPKG, your app is automatically removed from the Cloud App Program.

Sign in to the Developer Console.
From the navigation bar, choose My Apps.
Find and open the Fire OS app that's enrolled in the Amazon Cloud App Program.
In the sidebar, choose Add Upcoming Version.
Select Confirm on the confirmation message that appears. You can use the upcoming version feature both for updating existing binary files and for adding new binary files.

In the sidebar, under Current Version, an Upcoming Version section opens. The Upcoming Version section has app submission screens that mirror your current version. Green check marks in the sidebar indicate that the required fields have been pre-filled with information copied from the live version of your app.
In the Upcoming Version section, on the Upload Your App File screen, upload your VPKG file.
Edit which binary supports Vega OS devices:
1. On the Target Your App screen, in the Supported devices section, choose Edit supported devices on your original APK file.
2. Select the Amazon Fire TV tab, and then deselect all devices under Amazon Vega TV. Select Save.
3. Now choose Edit supported devices on your VPKG file.
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 select Save.
Edit the information on the remaining app submission screens as needed. For details with the remaining screens, see Submit Your App to the Amazon Appstore.
On the Review & Submit screen, verify the updates and select Submit App.

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 updated: Aug 17, 2026