Skip to content

Commit 2bb26a5

Browse files
magreenblattmagreenblatt
committed
docs: Update build requirements to match CEF
1 parent 3acefcf commit 2bb26a5

2 files changed

Lines changed: 35 additions & 30 deletions

File tree

‎CMakeLists.txt‎

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,8 @@
1111
# CMake-generated project formats that have been tested with JCEF include:
1212
#
1313
# Linux: Ninja, GCC 7.5.0+, Unix Makefiles
14-
# MacOS: Ninja, Xcode 12.2 to 13.0
15-
# Windows: Ninja, Visual Studio 2019+
14+
# MacOS: Ninja, Xcode 13.3 to 16.4
15+
# Windows: Ninja, Visual Studio 2022
1616
#
1717
# Ninja is a cross-platform open-source tool for running fast builds using
1818
# pre-installed platform toolchains (GNU, clang, Xcode or MSVC). It can be
@@ -23,7 +23,7 @@
2323
#
2424
# The below requirements must be met to build JCEF.
2525
#
26-
# - CMake version 3.19 or newer.
26+
# - CMake version 3.21 or newer.
2727
#
2828
# - Linux requirements:
2929
# Currently supported distributions include Debian 10 (Buster), Ubuntu 18
@@ -35,15 +35,14 @@
3535
# libgtk3.0-dev (required by the cefclient target only)
3636
#
3737
# - MacOS requirements:
38-
# Xcode 12.2 to 13.0 building on MacOS 10.15.4 (Catalina) or newer. Only
39-
# 64-bit builds are supported. The Xcode command-line tools must also be
40-
# installed. Newer Xcode versions may not have been been tested and are not
41-
# recommended.
38+
# Xcode 13.5 to 16.4 building on MacOS 12.0 (Monterey) or newer. The Xcode
39+
# command-line tools must also be installed. Newer Xcode versions may not have
40+
# been been tested and are not recommended.
4241
#
4342
# - Windows requirements:
44-
# Visual Studio 2019 or newer building on Windows 7 or newer. Windows 10
45-
# 64-bit is recommended. Newer versions will likely also work but may not have
46-
# been tested.
43+
# Visual Studio 2022 building on Windows 10 or newer. Windows 10/11 64-bit is
44+
# recommended. Newer versions will likely also work but may not have been
45+
# tested.
4746
#
4847
# BUILD EXAMPLES
4948
#
@@ -86,33 +85,33 @@
8685
# > ninja
8786
#
8887
# To perform a Windows build using a 32-bit CEF binary distribution:
89-
# Using the Visual Studio 2019 IDE:
90-
# > cmake -G "Visual Studio 16" -A Win32 ..
88+
# Using the Visual Studio 2022 IDE:
89+
# > cmake -G "Visual Studio 17" -A Win32 ..
9190
# Open jcef.sln in Visual Studio and select Build > Build Solution.
9291
#
93-
# Using Ninja with Visual Studio 2019 command-line tools:
92+
# Using Ninja with Visual Studio 2022 command-line tools:
9493
# (this path may be different depending on your Visual Studio installation)
95-
# > "C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\VC\Auxiliary\Build\vcvars32.bat"
94+
# > "C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvars32.bat"
9695
# > cmake -G "Ninja" -DCMAKE_BUILD_TYPE=Debug ..
9796
# > ninja
9897
#
9998
# To perform a Windows build using a 64-bit CEF binary distribution:
100-
# Using the Visual Studio 2019 IDE:
101-
# > cmake -G "Visual Studio 16" -A x64 ..
99+
# Using the Visual Studio 2022 IDE:
100+
# > cmake -G "Visual Studio 17" -A x64 ..
102101
# Open jcef.sln in Visual Studio and select Build > Build Solution.
103102
#
104-
# Using Ninja with Visual Studio 2019 command-line tools:
103+
# Using Ninja with Visual Studio 2022 command-line tools:
105104
# (this path may be different depending on your Visual Studio installation)
106-
# > "C:\Program Files (x86)\Microsoft Visual Studio\2019\Professional\VC\Auxiliary\Build\vcvars64.bat"
105+
# > "C:\Program Files\Microsoft Visual Studio\2022\Professional\VC\Auxiliary\Build\vcvars64.bat"
107106
# > cmake -G "Ninja" -DCMAKE_BUILD_TYPE=Debug ..
108107
# > ninja
109108

110109
#
111110
# Shared configuration.
112111
#
113112

114-
# For VS2019 and Xcode 12+ support.
115-
cmake_minimum_required(VERSION 3.19)
113+
# For VS2022 and Xcode 12+ support.
114+
cmake_minimum_required(VERSION 3.21)
116115

117116
# Only generate Debug and Release configuration types.
118117
set(CMAKE_CONFIGURATION_TYPES Debug Release)

‎docs/branches_and_building.md‎

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -23,11 +23,11 @@ Ongoing development of JCEF occurs on the [master branch](https://github.com/chr
2323

2424
# Building from Source Code
2525

26-
Building JCEF from source code is currently supported on Windows, Linux and Mac OS X for 64-bit Oracle Java targets. 32-bit builds are also possible on Windows and Linux but they are untested.
26+
Building JCEF from source code is currently supported on Windows, Linux and MacOS for 64-bit Oracle Java targets. 32-bit builds are also possible on Windows and Linux but they are untested.
2727

2828
To build JCEF from source code you should begin by installing the build prerequisites for your operating system and development environment. For all platforms this includes:
2929

30-
* [CMake](http://cmake.org/download/) version 3.19 or newer.
30+
* [CMake](http://cmake.org/download/) version 3.21 or newer.
3131
* [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git).
3232
* [Java](https://java.com/en/download/) version 7 to 14.
3333
* [Python](https://www.python.org/downloads/) version 2.6+ or 3+.
@@ -36,15 +36,15 @@ For Linux platforms:
3636

3737
* Currently supported distributions include Debian 10 (Buster), Ubuntu 18 (Bionic Beaver), and related. Ubuntu 18.04 64-bit with GCC 7.5.0+ is recommended. Newer versions will likely also work but may not have been tested. Required packages include: build-essential, libgtk-3-dev.
3838

39-
For Mac OS X platforms:
39+
For MacOS platforms:
4040

4141
* [Apache Ant](https://ant.apache.org/bindownload.cgi) is required to build the Java app bundle.
4242
* Java version newer than 8u121 is required.
43-
* Xcode 12.2 to 13.0 building on MacOS 10.15.4 (Catalina) or newer. The Xcode command-line tools must also be installed. Only 64-bit builds are supported on macOS.
43+
* Xcode 13.5 to 16.4 building on MacOS 12.0 (Monterey) or newer. The Xcode command-line tools must also be installed.
4444

4545
For Windows platforms:
4646

47-
* Visual Studio 2019 or newer building on Windows 7 or newer. Windows 10 64-bit are recommended.
47+
* Visual Studio 2022 building on Windows 10 or newer. Windows 10/11 64-bit is recommended.
4848

4949
## Building with Docker or GitHub Actions
5050

@@ -83,14 +83,20 @@ cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release ..
8383
# Build using Make.
8484
make -j4
8585

86-
# Mac OS X: Generate 64-bit Xcode project files.
86+
# MacOS: Generate 64-bit Xcode project files.
8787
cmake -G "Xcode" -DPROJECT_ARCH="x86_64" ..
8888
# Open jcef.xcodeproj in Xcode
8989
# - Select Scheme > Edit Scheme and change the "Build Configuration" to "Release"
9090
# - Select Product > Build.
9191

92-
# Windows: Generate 64-bit VS2019 project files.
93-
cmake -G "Visual Studio 16" -A x64 ..
92+
# MacOS: Generate ARM64 Xcode project files.
93+
cmake -G "Xcode" -DPROJECT_ARCH="arm64" ..
94+
# Open jcef.xcodeproj in Xcode
95+
# - Select Scheme > Edit Scheme and change the "Build Configuration" to "Release"
96+
# - Select Product > Build.
97+
98+
# Windows: Generate 64-bit VS2022 project files.
99+
cmake -G "Visual Studio 17" -A x64 ..
94100
# Open jcef.sln in Visual Studio
95101
# - Select Build > Configuration Manager and change the "Active solution configuration" to "Release"
96102
# - Select Build > Build Solution.
@@ -105,7 +111,7 @@ cd /path/to/java-cef/src/tools
105111
compile.bat win64
106112
```
107113

108-
On Mac OS X the JCEF Java classes are already built by the CMake project.
114+
On MacOS the JCEF Java classes are already built by the CMake project.
109115

110116
3\. On Windows and Linux test that the resulting build works using the _run.[bat\|sh]_ tool. You can either run the simple example (see java/simple/MainFrame.java) or the detailed one (see java/detailed/MainFrame.java) by appending "detailed" or "simple" to the _run.[bat\|sh]_ tool. This example assumes that the "Release" configuration was built in step 1 and that you want to use the detailed example.
111117

@@ -114,7 +120,7 @@ cd /path/to/java-cef/src/tools
114120
run.bat win64 Release detailed
115121
```
116122

117-
On Mac OS X run jcef\_app for the detailed example. Either use the command-line or double-click on jcef\_app in Finder.
123+
On MacOS run jcef\_app for the detailed example. Either use the command-line or double-click on jcef\_app in Finder.
118124

119125
```sh
120126
cd /path/to/java-cef/src/jcef_build/native/Release

0 commit comments

Comments
 (0)