Chromium

Binaries

Chromium binaries for each supported platform are located inside correspondent JxBrowser JARs:

• jxbrowser-win32-8.2.0.jar – Chromium binaries for Windows 32-bit.
• jxbrowser-win64-8.2.0.jar – Chromium binaries for Windows 64-bit.
• jxbrowser-mac-8.2.0.jar – Chromium binaries for macOS.
• jxbrowser-mac-arm-8.2.0.jar – Chromium binaries for macOS Apple Silicon.
• jxbrowser-linux64-8.2.0.jar – Chromium binaries for Linux 64-bit.
• jxbrowser-linux64-arm-8.2.0.jar – Chromium binaries for Linux ARM 64-bit.

Location

By default, JxBrowser extracts Chromium binaries to the user’s temp directory on Linux and macOS, and to AppData\Local\JxBrowser directory on Windows.

Here is how to change the directory where JxBrowser will extract the binaries:

1. Using the jxbrowser.chromium.dir system property.

   It can be done either by System.setProperty() method:

   Java

   Kotlin

   System.setProperty("jxbrowser.chromium.dir", "Users/Me/.jxbrowser");
   

   System.setProperty("jxbrowser.chromium.dir", "Users/Me/.jxbrowser")
   

   or through a JVM parameter:

   -Djxbrowser.chromium.dir="Users/Me/.jxbrowser"
   

2. Via the EngineOptions when constructing the Engine :

   Java

   Kotlin

   var engine = Engine.newInstance(EngineOptions.newBuilder(renderingMode)
           .chromiumDir(Paths.get("Users/Me/.jxbrowser"))
           .build());
   

   val engine = Engine(renderingMode) {
       chromiumDir = Path("Users/Me/.jxbrowser")
   

The directory path can be either relative or absolute.

Verification

Each JxBrowser version is compatible only with the same version of the binaries. For example, JxBrowser 8.2.0.1 will not work with the binaries from JxBrowser 8.2.0.

To make sure that the Chromium binaries are compatible with the current JxBrowser version, the library verifies the binaries.

Extraction

By default, JxBrowser extracts binaries from a corresponding JAR file when Engine is first created. If you need to extract binaries earlier, use this code:

// Use the default directory.
ChromiumBinaries.deliverToDefaultDirectory();
// Or use an arbitrary directory.
ChromiumBinaries.deliverTo(Paths.get("/path/to/binaries"));

// Use the default directory.
ChromiumBinaries.deliverToDefaultDirectory()
// Or use an arbitrary directory.
ChromiumBinaries.deliverTo(Path("/path/to/binaries"))

class TuneBinaryDelivery implements BinariesDelivery {
    public void deliverTo(Path chromiumDir) {
        // Pseudocode:
        // Path downloadedArchive = SharedNetworkDrive.download("jxbrowser-win64.gz");
        // Gzip.extract(downloadedArchive, chromiumDir);
// Use the default directory.
ChromiumBinaries.deliverToDefaultDirectory(new TuneBinaryDelivery());
// Or use an arbitrary directory.
ChromiumBinaries.deliverTo(chromiumDir, new TuneBinaryDelivery());

class TuneBinaryDelivery : BinariesDelivery {
    override fun deliverTo(chromiumDir: Path) {
        // Pseudocode:
        // Path downloadedArchive = SharedNetworkDrive.download("jxbrowser-win64.gz");
        // Gzip.extract(downloadedArchive, chromiumDir);
// Use the default directory.
ChromiumBinaries.deliverToDefaultDirectory(TuneBinaryDelivery())
// Or use an arbitrary directory.
ChromiumBinaries.deliverTo(chromiumDir, TuneBinaryDelivery())

var engine = Engine.newInstance(EngineOptions.newBuilder(renderingMode)
        .disableSandbox()
        .build());

val engine = Engine(renderingMode) {
    sandboxDisabled = true