App Installation Fails on Device After Upgrading Vega Version from 0.2.x to 0.21.4726

Vega Open Beta Bug Reports
1

:backhand_index_pointing_right: Bug Description

1. Summary

I was originally using the Kepler SDK version 0.2.x series. However, after upgrading the SDK version to 0.21.4726, when I try to build the application and install it on a physical device, I encounter the following error:

Kepler operation FAILED due to an irrecoverable error: Failed to install build/armv7-release/sample-app.vpkg on device ~~~~(device)~~~: Failed: Installing/Updating '/tmp/sample-app_armv7.vpkg' ...error (Module dependency not found)
: error: Unable to install '/tmp/sample-app_armv7.vpkg' as the required dependencies are not found on the device.
help: Please update your device software to the latest version or install the missing dependencies.
The following module dependencies declared in the application manifest are not found:
  - /com.amazon.kepler.keplercrypto_2@IKeplercrypto_1

Additional logs can be found at /Users/[user-name]/.kepler/logs
error Command failed with exit code 254.

Bug Severity
Select one that applies

  • Impacts operation of app
  • Blocks current development
  • Improvement suggestion
  • Issue with documentation (If selected, please share the doc link and describe the issue)
  • Other

2. Steps to Reproduce

  1. Upgrade the SDK version to 0.21.4726
  2. Delete the node_modules and build directories, and clear the cache
  3. Run yarn install
  4. Build the application
  5. Install the release build file onto a physical device. *Example command: kepler run-kepler build/armv7-release/sample-app_armv7.vpkg com.amazondeveloper.sampleApp.main

3. Observed Behavior

Explain what actually happened, noting any discrepancies or malfunctions.

4. Expected Behavior

Describe what you expected the SDK to do under normal operation.

<!-- Answer here -->

4.a Possible Root Cause & Temporary Workaround

Fill out anything you have tried. If you don’t know, N/A is acceptable

<!-- Answer here -->

5. Logs or crash report

The below logs


Kepler operation FAILED due to an irrecoverable error: Failed to install build/armv7-release/sample-app.vpkg on device ~~~~(device)~~~: Failed: Installing/Updating '/tmp/sample-app_armv7.vpkg' ...error (Module dependency not found)
: error: Unable to install '/tmp/sample-app_armv7.vpkg' as the required dependencies are not found on the device.
help: Please update your device software to the latest version or install the missing dependencies.
The following module dependencies declared in the application manifest are not found:
  - /com.amazon.kepler.keplercrypto_2@IKeplercrypto_1

Additional logs can be found at /Users/[user-name]/.kepler/logs
error Command failed with exit code 254.

6. Environment

Please fill out the fields related to your bug below:

  • SDK Version: 0.21.4726

  • App State: [Foreground/Background]

  • OS Information
    Please ssh into the device via kepler exec vda shelland copy the output from cat /etc/os-releaseinto the answer section below. Note, if you don’t have a simulator running or device attached kepler exec vda shell will respond with vda: no devices/emulators found

    <!-- Answer here if applicable -->
3

Hi @jo.shinozaki

Thanks for writing.
Based on the error snippet you shared, I can see you are facing a version compatibility issue between Kepler SDK 0.21.4726 and your Fire TV device’s runtime environment.

Kepler SDK 0.21.4726 introduces a new dependency:

com.amazon.kepler.keplercrypto_2@IKeplercrypto_1

The crypto module is a core Kepler dependency that can’t be bypassed and the device runtime must support it.
Your Fire TV device doesn’t have this newer crypto module installed.
The device’s Kepler runtime is older than what SDK 0.21.4726 requires.

You can set up your device following the documentation here.

If you still need assistance, please share the error logs for us to look into.

Warm regards,
Ivy

4

Hi @Ivy_Mahajan ,
Thank you for your quick response.

My Fire TV OS is already updated to the latest version (OS1.1 - 1001010444250), but I’m still encountering this compatibility issue.

5

@jo.shinozaki , can you please share all the relevant logs?

Warm regards,
Ivy

6

Hi @Ivy_Mahajan ,
I attach the log when I installed my application to a physical device.

Thank you,
Jo Shinozaki
kepler-2025-11-14.log (7.3 KB)

7

Thanks @jo.shinozaki, I’m checking internally and will keep you posted.
In the meantime, please confirm if the below dependancy is installed:

com.amazon.kepler.keplercrypto_2@IKeplercrypto_1

Warm regards,
Ivy

8

Hi @jo.shinozaki

We were not able to reproduce your issue.
Can we get the journalctl logs for the issue please ?

Warm regards,
Ivy

9

Hi @Ivy_Mahajan ,
Thank you for researching this issue.

I have attached my journalctl log file. I added the setting /com.amazon.kepler.keplercrypto_2@IKeplercrypto_1to manifest.toml as shown below.
[[needs.module]]
id=“/com.amazon.kepler.keplercrypto_2@IKeplercrypto_1”

Best regards,
Jo Shinozaki

logfile_forum.txt (631.4 KB)

10

Hi @jo.shinozaki,

From the logs, the app installation is failing because it needs module /com.amazon.kepler.keplercrypto_2@IKeplercrypto_1 but isn’t getting it.

Could you please share:

  1. Your exact Vega OS version

  2. Minimal reproducible code demonstrating the issue

This information will help us investigate further.

Warm regards,
Aishwarya

11

Hi @amen

The issue was resolved when I switched the installation device to a commercial Fire TV Stick. The error mentioned above occurred because I was testing on a device provided to us before its official release (a pre-production or developer unit).

Thank you,
Jo Shinozaki