|
| 1 | +# Equo Chromium Community Edition (**V144**) |
| 2 | + |
| 3 | +The [Equo Chromium](https://www.equo.dev/chromium) Community Edition widget is a cross platform browser that allows users to create and render modern web-based UIs inside a Java application. It can be used in standalone Java applications, Windowless mode, Swing, SWT, or Eclipse RCP applications. |
| 4 | + |
| 5 | +No more custom code for each platform, no more installations of specific libraries for Linux, no more problems in Windows with IE, no more platform-dependant and browser-specific issues at all. This is a truly **cross platform** browser that runs seamlessly in all operating systems and in embedded devices. |
| 6 | + |
| 7 | +It is based on and uses the CEF Framework (https://bitbucket.org/chromiumembedded/cef). |
| 8 | + |
| 9 | +## Usage |
| 10 | + |
| 11 | +To use the Equo Chromium Community Edition widget add the following import sentence to your Java classes: |
| 12 | + |
| 13 | + |
| 14 | +```java |
| 15 | +import com.equo.chromium.swt.Browser; |
| 16 | +``` |
| 17 | + |
| 18 | +Below you can see an example of how to instantiate the browser in your application: |
| 19 | + |
| 20 | +```java |
| 21 | +import com.equo.chromium.swt.Browser |
| 22 | +public class SinglePagePart { |
| 23 | + public void createBrowser(Composite parent, String url) { |
| 24 | + Browser browser = new Browser(parent, SWT.NONE); |
| 25 | + browser.setLayoutData(new GridData(SWT.FILL, SWT.FILL, true, true)); |
| 26 | + browser.setUrl(url); |
| 27 | + } |
| 28 | +} |
| 29 | +``` |
| 30 | + |
| 31 | +## Examples |
| 32 | + |
| 33 | +Complete Sample projects can be found [here](https://github.com/equodev/chromium-samples). |
| 34 | + |
| 35 | +## Distribution |
| 36 | + |
| 37 | +The Equo Chromium Browser is provided as ready-to-use P2, MVN and OSGi repositories, which contain: |
| 38 | + |
| 39 | +- a Chromium bundle |
| 40 | +- a Chromium native library per platform fragments |
| 41 | +- a feature containing all the above |
| 42 | + |
| 43 | +### Repositories |
| 44 | + |
| 45 | +Repositories are available for Linux, Windows and macOS (x86_64 only) |
| 46 | + |
| 47 | +[Equo Chromium repositories](https://dl.equo.dev/chromium-swt-ce/oss/mvn/index.html) |
| 48 | + |
| 49 | +If you need support for other platforms (i.e 32 bits or ARM architectures) please [contact us](https://equo.dev/contact). |
| 50 | + |
| 51 | +## Equo documentation |
| 52 | + |
| 53 | +https://docs.equo.dev/main/getting-started/introduction.html |
| 54 | + |
| 55 | +## Contributing |
| 56 | + |
| 57 | +Thank you to all the people who are contributing to Equo Chromium! Please, read our [Contributors Guide](docs/CONTRIBUTING.md) if you want to contribute to this project. |
| 58 | + |
| 59 | +By contributing you agree to our [Code of Conduct](docs/CODE_OF_CONDUCT.md)'s terms. |
| 60 | + |
| 61 | +## Build |
| 62 | + |
| 63 | +This repo uses GIT LFS, please install (https://git-lfs.github.com/) before cloning. |
| 64 | + |
| 65 | +- Clone this repo. |
| 66 | +- `mvn clean package` |
| 67 | + |
| 68 | + |
| 69 | +## License |
| 70 | + |
| 71 | +[Equo Chromium](https://www.equo.dev/chromium) is dual-licensed under commercial and open source licenses (GPLv3). This repository is licensed under GPLv3. To get a commercial license and to not worry about the obligations associated with the GPLv3 license please contact the [Equo support team](https://www.equo.dev/schedule-a-demo). |
| 72 | + |
| 73 | +## Release Notes |
| 74 | + |
| 75 | +All the release notes for the Equo Chromium browser can be found [here](https://docs.equo.dev/chromium/144.x-ce/reference/release-notes.html). |
| 76 | + |
| 77 | +## Support |
| 78 | + |
| 79 | +If you need consultancy or support for having the widget integrated into your app, contact our [Enterprise support team](mailto:support@equo.dev). |
0 commit comments