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
Skip to main content
This page helps you resolve common issues that occur when debugging Vega apps with Vega Studio. If you don’t find a solution to your specific problem here, post an issue in the Developer Forum for additional support.

The app terminates unexpectedly during debugging, interrupting the session

Cause: The Lifecycle Manager (LCM) terminates apps that don’t send heartbeat signals. Breakpoints pause your app, preventing heartbeats, causing termination. Solution: Verify your device supports timeout disabling.
  1. From the device’s shell, run:
  2. Look for the --disable-app-timeout flag in the debug command output.
  3. Prevent app termination using one of these options: Option 1: Using Vega Studio (Recommended) a. Open your launch.json file. b. Add or modify the disableAppTimeout setting to true:
    c. Save and restart your debugging session. Option 2: Using Vega CLI a. Disable timeouts for your component:
    b. Launch your app:
    c. Attach your debugger in Vega Studio.
  4. Re-enable timeouts after debugging using one of these options:
    • Vega Studio: Launch the app without the debug configuration
    • Vega CLI: Run then relaunch app
    For information about launching your app, see Run your app.
Example template for launching and debugging Vega and Turbo Module apps:

GDB native debugging error: liblzma.5.dylib not found

Error:
Cause: GDB can’t find the required XZ compression library (liblzma.5.dylib) which is a dependency for native debugging. Solution: Install or reinstall the XZ library:
  1. Install the XZ library:
  2. If already installed, try reinstalling:
  3. Verify symbolic links:
    If the problem persists, try these additional steps:
  4. Clear Homebrew cache:
  5. Update Homebrew:
Additional considerations
  1. Verify that you have the latest version of Homebrew.
  2. Some macOS versions might require additional security configurations for GDB.
  3. Confirm that you have the necessary permissions to access the library locations.

Last modified on November 14, 2025