Failed to install app with @amazon-devices/react-native-localize version ^2.1.X

Vega Open Beta Bug Reports
1

:warning: Before you continue

Before submitting a bug report, please review our troubleshooting documentation at Troubleshoot Issues | Vega Troubleshooting

If you still want to file a bug report, please make sure to fill in all the details below and provide the necessary information.

NOTE: PLEASE ONLY REPORT A SINGLE BUG USING THIS TEMPLATE.
If you’re experiencing multiple issues, please file a separate report for each.

:backhand_index_pointing_right: Bug Description

1. Summary

I updated @amazon-devices/react-native-localize to version ^2.1.9000000000. Installation to device failed for both Production and Debug builds.

App Name:

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. Update @amazon-devices/react-native-localize to ^2.1.9000000000
  2. Build the app: npm run build:debug
  3. Install to device.

3. Observed Behavior

App Failed to installed with the following error

Vega operation FAILED due to an irrecoverable error: Incomplete: Installing/Updating '/tmp/abcn-11.9.0_armv7.vpkg' ...error (Module dependency not found): error: Unable to install '/tmp/abcn-11.9.0_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.localize_2@ILocalize_1

4. Expected Behavior

App should install correctly

4.a Possible Root Cause & Temporary Workaround

@amazon-devices/react-native-localize@2.1.9000000000 declares a dependency on the com.amazon.kepler.localize_2 system module (interface ILocalize_1), which is not present on the current device firmware. The device only ships com.amazon.kepler.localize_1.

5. Logs or crash report

No Crash, just failed to install app

6. Environment

Please fill out the fields related to your bug below:

  • SDK Version: Active SDK Version: 0.23.9221 Vega CLI Version: 1.3.2

  • App State: [Foreground/Background]

  • OS Information:

    NAME="OS"
OE_VERSION="4.0.0"
OS_MAJOR_VERSION="1"
OS_MINOR_VERSION="1"
RELEASE_ID="14"
OS_VERSION="1.1"
BRANCH_CODE="TV Ship day60"
BUILD_DESC="OS 1.1 (TV Ship day60/4460)"
BUILD_FINGERPRINT="4.0.227617.0(3072cab629675a74)/4460N:user-external/release-keys"
BUILD_VARIANT="user-external"
BUILD_TAGS="release-keys"
BUILD_DATE="Fri Feb 20 16:02:43 UTC 2026"
BUILD_TIMESTAMP="1771603363"
VERSION_NUMBER="1401010446050"

7. Example Code Snippet / Screenshots / Screengrabs

N/A

:backhand_index_pointing_right: Playback Issues

N/a

:backhand_index_pointing_right: Additional Context

Any Additional Context you would like to provide?
Add any other relevant information, such as recent updates to the SDK, dependencies, or device OS that may affect the bug.

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

Hi @Adrian_Lafontaine_Globant,

Thank you for the detailed bug report on the react-native-localize installation failure.

The react-native-localize 2.1.x package declares a dependency on the com.amazon.kepler.localize_2 system module, but your device firmware (OS 1.1, build
1401010446050) only ships com.amazon.kepler.localize_1. The module hasn’t landed on your device via OTA yet.

This is the same class of issue that was reported with device_info_2 here: Missing com.amazon.kepler.device_info_2@IDeviceInfo_1 dependency ( Missing com.amazon.kepler.device_info_2@IDeviceInfo_1 dependency ) - and the fix is the same.

The fix: Enable Backward Compatibility

This lets your app install on devices regardless of whether they have localize_1 or localize_2:

  1. Install the compatibility library:
npm install @amazon-devices/kepler-compatibility
  1. Add this to your package.json under the kepler block:
{
  "kepler": {
    "backwardCompatibility": {
      "@amazon-devices/react-native-localize": {
        "needs": "2.0.0",
        "wants": "<=2.1.9000000000"
      }
    }
  }
}
  1. Add a runtime check where you call the localize APIs:
import { isPresentOnOS } from '@amazon-devices/kepler-compatibility';

const hasLocalize2 = isPresentOnOS("@amazon-devices/react-native-localize", "2.1.0");
  1. Rebuild and reinstall.

You can also confirm what modules your device currently has:

vega device shell
vpm list modules | grep localize

Some context on why this happened: The June 3 announcement ( Notice: Change impacting Debug Build for React Native Vega Applications (react-native-localize) ) recommended upgrading to 2.1.x to fix debug build crashes, but didn’t mention that some devices haven’t received localize_2 via OTA yet. So developers who followed that guidance are now hitting this install failure. Backward compatibility bridges that gap.

References:

Let us know if you run into anything else after applying the backward compatibility config.

Thanks for helping us improve the Vega platform.

Warm regards,
Aishwarya

5

Didn’t hav any problems with this and it worked perfectly.

Thank you very much! :smiley: