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.
Bug Description
1. Summary
The WebView-based app fails to load when built in Debug mode, crashing with a SIGSEGV error.
However, the same app works correctly when built in Release mode.
This behavior is consistently reproducible across all developers on the team, and has been verified using:
-
Vega CLI
-
VS Code Vega Extension
App Name:
App Link on Amazon Appstore :
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
- Clone the project and install dependencies.
- Build and run the app in Debug mode using:
-
Vega CLI or
-
VS Code Vega Extension.
-
- Launch the app.
- Observe that the app crashes or WebView fails to load with a SIGSEGV error.
- Build and run the same codebase in Release mode.
- Observe that the app loads and functions correctly.
Note: This issue occurs for every developer on the team, on multiple machines.]
3. Observed Behavior
Explain what actually happened, noting any discrepancies or malfunctions.
App crashes or WebView fails to load when running a Debug build.
Crash is accompanied by a SIGSEGV error.
Issue is reproducible 100% of the time in Debug mode.
No crash occurs in Release mode; the app works as expected.
4. Expected Behavior
Describe what you expected the SDK to do under normal operation.
The app should load and function correctly in both Debug and Release modes.
Debug builds should not crash or fail to load the WebView.
4.a Possible Root Cause & Temporary Workaround
Fill out anything you have tried. If you don’t know, N/A is acceptable
May be related to Debug-specific configuration, symbols, or runtime differences in Vega / WebView handling.
5. Logs or crash report
(Please make sure to provide relevant logs as attachment)
For crash issues, please refer this guide for faster troubleshooting: Detect Where the App Crash Originates | Design and Develop Vega Apps
-
For issues with Kepler Studio Extension, please share log files from below folders:
~/.vscode/extensions/amazon.kepler-extension-<version>/ExtensionLogs ~/.vscode/extensions/amazon.kepler-ui-extension-<version>/ExtensionLogs8#crash_1769582650_5000_5000_399_427645511_JSThread.acr (335.9 KB)
7#crash_1769582563_5000_5000_29870_384595111_JSThread.acr (337.4 KB)
6. Environment
Please fill out the fields related to your bug below:
-
SDK Version: Active SDK Version: 0.22.5600
Vega CLI Version: 1.2.13 -
App State:
[Foreground] -
OS Information
Please ssh into the device viakepler exec vda shelland copy the output fromcat /etc/os-releaseinto the answer section below. Note, if you don’t have a simulator running or device attachedkepler exec vda shellwill respond withvda: no devices/emulators foundNAME="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/4454)" BUILD_FINGERPRINT="4.0.198430.0(3072cab629675a74)/4454N:user-external/release-keys" BUILD_VARIANT="user-external" BUILD_TAGS="release-keys" BUILD_DATE="Sat Dec 20 04:05:59 UTC 2025" BUILD_TIMESTAMP="1766203559" VERSION_NUMBER="1401010445450"
Q: Are there any special headers required to reproduce the issue you are facing?
[N/A or Insert Headers]
Additionally please provide the following if possible
Provide Screenshots / Screengrabs / Logs. Please include as much information as you can that will help debug.
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 -->