JCEF Fails to Initialize on KylinOS - "JCEF is not supported in this env or failed to initialize"

[xzxiaoshan]

I'm encountering an issue where JCEF fails to initialize on KylinOS, a Linux-based operating system developed in China, commonly used in government and enterprise environments.

The error message consistently reported is: JCEF is not supported in this env or failed to initialize

This issue occurs across multiple IntelliJ IDEA plugins that rely on JCEF for embedded browser functionality. I've tested several popular plugins from the JetBrains Plugin Marketplace, and all of them fail with the same error, indicating this is likely a platform-level compatibility issue rather than a plugin-specific bug.

Affected Plugins Tested

The following plugins were tested (all failed with the same error):

• EmbeddedBrowser
• Embedded Web Browser
• GBrowser
• MyBrowser
• BroBrowser

All plugins work correctly on standard Windows、MacOS distributions, but fail on KylinOS.

Environment Details

• Operating System: KylinOS (various versions, including Kylin V10)
• Architecture: x86_64 / ARM64 (tested on both)
• IDE: IntelliJ IDEA (latest stable version)
• JCEF Version: Bundled with IDE/plugins (typically based on java-cef 0.20+)
• Java Version: OpenJDK 11 / 17 (as bundled with IDEA)

Expected Behavior

JCEF should initialize and render embedded web content successfully on KylinOS, just as it does on other Linux distributions.

Actual Behavior

JCEF fails during initialization with the generic error: JCEF is not supported in this env or failed to initialize

No additional debug logs are shown by default, but I'm willing to enable verbose logging if guidance is provided.

Additional Notes

• KylinOS is based on Ubuntu/Debian but includes custom desktop environments and system libraries.
• The issue may stem from missing dependencies, unsupported GPU drivers, or detection logic in JCEF that does not recognize KylinOS as a valid Linux environment.
• It would be helpful if JCEF could:
  • Improve OS detection to include KylinOS.
  • Provide more detailed error logs during initialization failure.
  • Allow fallback or manual override for known-compatible Linux variants.

Request

Could you please:

1. Confirm whether KylinOS is officially supported?
2. Suggest any workaround or configuration to force JCEF initialization?
3. Consider adding KylinOS to the list of supported Linux environments?

I'm happy to assist with testing, logs, or system information to help resolve this.

Thank you!

[lxwhappy]

I'm encountering the same issue and urgently need a solution.

[xzxiaoshan]

Is there anyone here? Is there a way to solve this problem?

[magreenblatt]

KylinOS is not supported. Someone who uses that OS is welcome to debug issues. You might start by looking at how Chromium is built/modified to work on that OS. Or you can reach out to KylinSoft if you have a support agreement with them.

[xzxiaoshan]

@magreenblatt I tested Ubuntu v24 but it still doesn't work. Is it possible that even Linux doesn't work? Ubuntu is already a commonly used operating system.

[magreenblatt]

I believe Ubuntu 24 uses Wayland by default. You might try running with --ozone-platform=x11.