This repository contains the embedded browser component for the Eclipse Signalling Engineering Toolbox (Eclipse SET) based on the Chromium Embedded Framework. This component is based upon an older component which was formerly integrated into the Eclipse Platform. It provides a simple to use and modern (Chromium 118) embedded web browser component for SWT.
In Eclipse SET the browser component is used to quickly integrate several subcomponents (e.g. a modern PDF Viewer) by leveraging the wide Javascript ecosystem of available libraries.
In general this browser component can also be used separately from Eclipse SET. The easiest way to accomplish this is to import the maven artifacts made available from this repository.
org.eclipse.set.browsercontains the Java main code to integrate CEF into the SWT browser infrastructure.org.eclipse.set.browser.libcontains the interfacing code to communicate with CEF and provide a browser.org.eclipse.set.browser.cef.win32is a repackaged variant of the official CEF Builds which easily integrates as an OSGi feature. This should be added to your product and provides CEF with the required resources.
After doing so, you can use the org.eclipse.set.browser.Browser class to create a new browser instance. As this component is derived from the Eclipse Platform browser implementation it generally follows the same APIs, so most existing usages of a SWT browser can be reused. For some general examples, see the the SWT snippets website under Browser, which are generally applicable if you change the imports from org.eclipse.swt to org.eclipse.set.
Note: While we attempt to keep the browser up to date as much as possible, there may be delays towards getting a new CEF/Chromium version into this component. As a result we highly suggest to not use this browser component with untrusted websites (e.g. the internet).
The CEF/Chromium version being used can be found in CEF_VERSION.txt.
Currently only Windows x64 is supported.
For detailed build instructions see BUILD_INSTRUCTIONS.md.
If you are interested in contributing, please see CONTRIBUTING.md for details.