Version Your App
Vega supports setting version and build numbers for your apps. These properties are used to determine the order of submitted application packages to the Amazon Appstore, and are important for installation and update flows on devices.
When you update your app, both the version and build numbers must be greater than the previous version you submitted. You can learn more about app submission requirements in App Submission for Vega.
Set the app version
The version attribute for an app is set as freeform string, passed as a command argument when creating the application package. You can use the version attribute to describe the application version as a <major>.<minor>.<patch> semver, or use any other type of versioning scheme.
Pass the --build-version flag when invoking the build for your React Native for Vega app, from the command line or in a script.
From the command line
npx react-native build-kepler --build-version 1.2.3
From your script in package.json
"scripts": {
...
"build:release": "react-native build-kepler --build-type Release --build-version 1.2.3",
}
Set the app build number
The build number of an app is an increasing number (between 1 and 2^63-1) that represents a unique build of the application package. Set the build number as a command argument when creating the app package.
Pass the --build-number flag when invoking the build for your React Native for Vega app, from the command line or in a script.
From the command line
npx react-native build-kepler --build-number 101
From your script in package.json
"scripts": {
...
"build:release": "react-native build-kepler --build-type Release --build-number 101",
}
Check your version and build numbers
After you build your app, you can use the vpt tool to validate that the version and build number properties are correctly set in the app package. The VPT tool may be found under your SDK install location. In the terminal where you initialized the Vega SDK environment, run the below command, replacing <path-to-vpkg> with your app's path.
kepler exec vpt info <path-to-vpkg> --json
Here's an example ouput from this command, which displays the version and build numbers.
{
"title": "My Vega Application",
"id": "com.my.kepler.app",
"version": "1.2.3",
"build_number": 101,
"size": 19409829
}
Last updated: Sep 30, 2025
