Jcefbuild
Builds for JCef
Install / Use
/learn @jcefmaven/JcefbuildREADME
Build Specs:
<table> <tr> <td width="12%"></td> <td width="22%"><a href="#"><img src="https://raw.githubusercontent.com/simple-icons/simple-icons/ce334b5bda8d8d054cfde7ce35caf40651078a28/icons/linux.svg" alt="linux" width="32" height="32"></a><br/><b>amd64, arm64 & arm</b></td> <td width="22%"><a href="#"><img src="https://raw.githubusercontent.com/simple-icons/simple-icons/ce334b5bda8d8d054cfde7ce35caf40651078a28/icons/windows.svg" alt="windows" width="32" height="32"></a><br/><b>amd64 & i386</b></td> <td width="22%"><a href="#"><img src="https://raw.githubusercontent.com/simple-icons/simple-icons/ce334b5bda8d8d054cfde7ce35caf40651078a28/icons/windows.svg" alt="windows" width="32" height="32"></a><br/><b>arm64</b></td> <td width="22%"><a href="#"><img src="https://raw.githubusercontent.com/simple-icons/simple-icons/ce334b5bda8d8d054cfde7ce35caf40651078a28/icons/apple.svg" alt="apple" width="32" height="32"></a><br/><b>amd64 & arm64</b></td> </tr> <tr> <td><b>Java</b></td> <td>OpenJDK 11</td> <td>Oracle JDK 8</td> <td>Microsoft JDK 11</td> <td>Temurin JDK 8</td> </tr> <tr> <td><b>Compiler</b></td> <td>GCC 10</td> <td>VS 2019</td> <td>VS 2019</td> <td>Xcode 13</td> </tr> <tr> <td><b>Build</b></td> <td>Python 3.7; <code>ninja</code></td> <td>Python 3.7; <code>ninja</code></td> <td>Python 3.7; <code>ninja</code></td> <td>Python 2.7; <code>ninja</code>; SDK10.13</td> </tr> <tr> <td><b>Limitations</b></td> <td>-</td> <td>-</td> <td>No OSR mode (no Jogamp)</td> <td>Needs <a href="https://bitbucket.org/chromiumembedded/java-cef/issues/109/">custom structure</a> to run outside of a bundle</td> </tr> </table> </div>Downloading artifacts
You can find the most recent versions of the artifacts on the releases page of this repository.
Building your own projects
You have multiple options to build your own project using this repository. They are listed below.
Building another git repo using GitHub Actions
To build another git repo, simply fork this repository. Then go to the "Actions" tab of your forked repository,
activate the workflows and manually run the build-all (or build-<platform>) workflow with your repository and commit id/branch specified.
This will trigger a build of your desired repository and platforms.
To produce a build for MacOS, you will need to specify your code signing information or remove the signing and notarization steps from the action workflows.
Required Actions Secrets for signing and notarization:
+APPLE_API_KEY_BASE64: Your API key to access the Apple Notarization Service (in base64)
+APPLE_API_KEY_ISSUER: UUID of issuer (can be found along with your generated key in Apple Dev Console)
+APPLE_API_KEY_NAME: The name to be used for your API key on the runner (can be random)
+APPLE_API_KEY_ID: The ID of your key (10 digit code)
+APPLE_BUILD_CERTIFICATE_BASE64: Base64 encoded pkcs12 certificate file from Apple to use for signing
+APPLE_BUILD_CERTIFICATE_NAME: Your certificate name (usually starts with Developer ID Application)
+APPLE_P12_PASSWORD: Password of your pkcs12 certificate file
+APPLE_KEYCHAIN_PASSWORD: A random password to use for the keychain on the runner
+APPLE_TEAM_NAME: Your apple team name, part of the certificate name (10 digit id in brackets)`
You can obtain the api key here (make sure key has developer access) and the certificate here (choose Developer ID Application).
Building locally
To build locally, put your sources in the jcef directory of this repository, or leave it empty to clone a repository.
On Windows and Linux, make sure you installed docker (NOT the Snap version!). On MacOS, make sure you installed the build dependencies specified
here and ninja.
Then execute compile-<os>.<sh|bat> <arch> <buildType> [<gitrepo> <gitref>].
Specify an architecture (docker architectures, see script source for options) and build type (Release or Debug).
Optionally, you can specify a git repository and ref/branch to pull when no sources are present in the jcef folder.
Reporting bugs
Please only report bugs here that are related to the build process. Please report bugs in JCEF/CEF to the corresponding repository on Bitbucket.
Contributing
Feel free to open a pull request on this repository to improve its stability or artifact quality. Make sure to provide a valid GitHub Actions run for your pull requests to be accepted.
