docs: troubleshoot "Failed to create CEF browser" on Linux Simulator (#4882)#4900
Merged
shai-almog merged 1 commit intomasterfrom May 9, 2026
Merged
Conversation
…4882) Documents the UnsatisfiedLinkError some Linux users hit when the Simulator loads the bundled CEF, along with the JAVA_HOME / LD_LIBRARY_PATH IDE-launcher workaround. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Contributor
|
Developer Guide build artifacts are available for download from this workflow run:
Developer Guide quality checks:
Unused image preview:
|
Contributor
Cloudflare Preview
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
UnsatisfiedLinkError: ... libjawt.so: version 'SUNWprivate_1.1' not foundthat some users hit when the Simulator instantiates aBrowserComponentvia the bundled CEF.libjcef.so/libjawt.socannot find compatible JDK native libraries becauseLD_LIBRARY_PATHdoes not resolve them) and gives an IDE-launcher workaround settingJAVA_HOMEandLD_LIBRARY_PATH.CN.getProperty(...)and notes that the issue does not affect packaged native apps.Addresses #4882.
Test plan
docs/developer-guide/The-Components-Of-Codename-One.asciidocand confirm the new "Troubleshooting 'Failed to create CEF browser' on Linux" subsection appears underBrowserComponent & WebBrowserand the surrounding sections still link correctly.🤖 Generated with Claude Code