Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bfergerson/journey
JCEF-powered cross-platform web browser
https://github.com/bfergerson/journey
cef chromium chromium-embedded-framework jcef jxbrowser webview
Last synced: about 2 months ago
JSON representation
JCEF-powered cross-platform web browser
- Host: GitHub
- URL: https://github.com/bfergerson/journey
- Owner: BFergerson
- License: apache-2.0
- Created: 2019-05-15T03:40:19.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-11T14:40:18.000Z (almost 2 years ago)
- Last Synced: 2024-10-17T05:08:05.700Z (2 months ago)
- Topics: cef, chromium, chromium-embedded-framework, jcef, jxbrowser, webview
- Language: Java
- Homepage:
- Size: 274 KB
- Stars: 99
- Watchers: 7
- Forks: 26
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Journey
[](https://travis-ci.com/CodeBrig/Journey)
[](https://ci.appveyor.com/project/BFergerson/journey/branch/master)
Journey is a JCEF-powered cross-platform web browser created to address a need for an open-source JxBrowser alternative.
No attempt has been made to go feature-to-feature with JxBrowser. Journey namely aims to provide the same level of cross-platform capability. This is accomplished by providing a reliable means of building and distributing the CEF native files with Travis-CI/AppVeyor, JitPack, and GitHub.
Issues/PRs are welcome for increasing the capability of Journey to be on par with that of JxBrowser.
### Features
- Linux (64bit) support
- macOS (64bit) support
- Windows (32bit/64bit) support
- Release distributions (CDN via GitHub)
- Online/offline CEF native file access
## Installation
### Gradle
```groovy
repositories {
jcenter()
maven { url "https://jitpack.io" }
}
dependencies {
compile 'com.github.codebrig:journey:0.4.0-online'
//or use the offline version (includes native CEF files for all platforms; ~300MB)
//compile 'com.github.codebrig:journey:0.4.0-offline'
}
```
### Maven
```xml
jitpack.io
https://jitpack.io
com.github.codebrig
journey
0.4.0-online
```
## Usage
```java
import com.codebrig.journey.JourneyBrowserView;
import javax.swing.*;
import java.awt.*;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
public class JourneyBrowser {
public static void main(String[] args) {
JourneyBrowserView browser = new JourneyBrowserView("https://google.com");
JFrame frame = new JFrame();
frame.getContentPane().add(browser, BorderLayout.CENTER);
frame.setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE);
frame.addWindowListener(new WindowAdapter() {
@Override
public void windowClosing(WindowEvent e) {
browser.getCefApp().dispose();
frame.dispose();
}
});
frame.setTitle("Journey");
frame.setSize(1000, 600);
frame.setVisible(true);
}
}
```
## JCEF Test Browser
### Linux (64bit)
```sh
curl -L -O https://github.com/CodeBrig/Journey/releases/download/0.4.0-78-assets/jcef-distrib-linux64.zip
unzip jcef-distrib-linux64.zip
export LD_LIBRARY_PATH=/usr/lib/jvm/java-8-openjdk-amd64/jre/lib/amd64:$(pwd)/linux64/bin/lib/linux64
java -cp "linux64/bin/*" tests.detailed.MainFrame
```
### macOS (64bit)
```sh
curl -L -O https://github.com/CodeBrig/Journey/releases/download/0.4.0-69-assets/jcef-distrib-macintosh64.zip
unzip jcef-distrib-macintosh64.zip
mv ./macosx64/bin/jcef_app.app .
JAVA_PATH="./jcef_app.app/Contents/Java"
FRAMEWORKS_PATH="./jcef_app.app/Contents/Frameworks"
RESOURCES_DIR_PATH="$(pwd)/jcef_app.app/Contents/Frameworks/Chromium Embedded Framework.framework/Resources"
java -cp "$JAVA_PATH:$JAVA_PATH/*" -Djava.library.path=$JAVA_PATH tests.detailed.MainFrame --framework-dir-path=$FRAMEWORKS_PATH/Chromium\ Embedded\ Framework.framework --browser-subprocess-path=$FRAMEWORKS_PATH/jcef\ Helper.app/Contents/MacOS/jcef\ Helper --resources-dir-path="$RESOURCES_DIR_PATH" --disable-gpu
```
### Windows (64bit) [PowerShell]
```
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
wget https://github.com/CodeBrig/Journey/releases/download/0.4.0-78-assets/jcef-distrib-windows64.zip -OutFile jcef-distrib-windows64.zip
Expand-Archive jcef-distrib-windows64.zip .
java -cp "./win64/bin;./win64/bin/*" "-Djava.library.path=./win64/bin/lib/win64" tests.detailed.MainFrame
```
## Version Matrix
| Journey Version | JCEF Version (Linux) | JCEF Version (macOS) | JCEF Version (Windows) |
|---------------------|----------------------|----------------------|----------------------|
| 0.4.0 (2019-11-30) | [78.2.7.237](https://bitbucket.org/chromiumembedded/java-cef/commits/1e3a9146226d3df8a7f0c9c03989d220ac26ca49) (2019-11-14) | [69.0.3497.100](https://bitbucket.org/chromiumembedded/java-cef/commits/235e3a844380b72761643324e1d9b7713cae3b63) (2018-11-01) | [78.2.7.237](https://bitbucket.org/chromiumembedded/java-cef/commits/1e3a9146226d3df8a7f0c9c03989d220ac26ca49) (2019-11-14) |
| 0.3.3 (2019-07-13) | [75.0.13.220](https://bitbucket.org/chromiumembedded/java-cef/commits/13ae2d6074bc00a31888fb752dd45f9cf254725d) (2019-07-09) | [69.0.3497.100](https://bitbucket.org/chromiumembedded/java-cef/commits/235e3a844380b72761643324e1d9b7713cae3b63) (2018-11-01) | [75.0.13.220](https://bitbucket.org/chromiumembedded/java-cef/commits/13ae2d6074bc00a31888fb752dd45f9cf254725d) (2019-07-09) |
| 0.2.18 (2019-06-30)
0.2.17 (2019-06-12) | [73.1.11.216](https://bitbucket.org/chromiumembedded/java-cef/commits/6b140efeef4e566b6a68025b1dcea9b2da6e6e57) (2019-05-21) | [69.0.3497.100](https://bitbucket.org/chromiumembedded/java-cef/commits/235e3a844380b72761643324e1d9b7713cae3b63) (2018-11-01) | [73.1.11.216](https://bitbucket.org/chromiumembedded/java-cef/commits/6b140efeef4e566b6a68025b1dcea9b2da6e6e57) (2019-05-21) |
| 0.2.16 (2019-06-10) | [73.1.11.215](https://bitbucket.org/chromiumembedded/java-cef/commits/d348788e3347fa4d2a421773463f7dd62da60991) (2019-05-10) | [69.0.3497.100](https://bitbucket.org/chromiumembedded/java-cef/commits/235e3a844380b72761643324e1d9b7713cae3b63) (2018-11-01) | [73.1.11.215](https://bitbucket.org/chromiumembedded/java-cef/commits/d348788e3347fa4d2a421773463f7dd62da60991) (2019-05-10) |
| 0.1.1 (2019-05-21) | [73.1.11.215](https://bitbucket.org/chromiumembedded/java-cef/commits/d348788e3347fa4d2a421773463f7dd62da60991) (2019-05-10) | n/a | [73.1.11.215](https://bitbucket.org/chromiumembedded/java-cef/commits/d348788e3347fa4d2a421773463f7dd62da60991) (2019-05-10) |