Chromium
This guide describes how to work with the Chromium build used by JxBrowser.
You do not need to install Chromium or Google Chrome on the target environment to use JxBrowser. JxBrowser uses and deploys its own Chromium build.
Binaries
Chromium binaries for each supported platform are located inside correspondent JxBrowser JARs:
jxbrowser-win32-8.0.0.jar
– Chromium binaries for Windows 32-bit.jxbrowser-win64-8.0.0.jar
– Chromium binaries for Windows 64-bit.jxbrowser-mac-8.0.0.jar
– Chromium binaries for macOS.jxbrowser-mac-arm-8.0.0.jar
– Chromium binaries for macOS Apple Silicon.jxbrowser-linux64-8.0.0.jar
– Chromium binaries for Linux 64-bit.jxbrowser-linux64-arm-8.0.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:
Using the
jxbrowser.chromium.dir
system property.It can be done either by
System.setProperty()
method:JavaKotlinSystem.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"
Via the
EngineOptions
when constructing theEngine
:JavaKotlinEngine 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.
The directory cannot be located on a network drive.
Verification
Each JxBrowser version is compatible only with the same version of the binaries. For example, JxBrowser 8.0.0.1 will not work with the binaries from JxBrowser 8.0.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"))
If the compatible binaries are already extracted, JxBrowser will not extract them again. Otherwise, JxBrowser will extract the binaries again and override the existing files.
Custom delivery
Starting with JxBrowser 7.35, developers can get the full control of delivering Chromium binaries to the environment. This capability is intended for advanced use cases, such as downloading binaries from the network, or using a custom compression algorithm.
To customize the delivery, implement BinariesDelivery
interface and deliver the binaries when you need them:
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())
If the compatible binaries are already extracted, JxBrowser will not call the custom delivery.
Sandbox
Windows
JxBrowser supports Chromium Sandbox on Windows. Sandbox is enabled by default, but you can disable it via the
appropriate Engine
option:
Engine engine = Engine.newInstance(EngineOptions.newBuilder(renderingMode)
.disableSandbox()
.build());
val engine = Engine(renderingMode) {
sandboxDisabled = true
}
Linux and macOS
Currently, Sandbox is supported on Windows platform only.