119 lines
3.5 KiB
Markdown
119 lines
3.5 KiB
Markdown
# Build on Mac
|
||
|
||
## Install Xcode
|
||
|
||
You should install Xcode as the step 0.
|
||
|
||
## Install CMake
|
||
|
||
Download the .dmg from [here](https://cmake.org/download/). Just double click and follow the instructions.
|
||
|
||
## Install Boost
|
||
|
||
Download the .tar.bz2 or .tar.gz from [here](https://www.boost.org/users/download/#live).
|
||
|
||
Unpack and go into the directory (suppose Boost version is 1.74):
|
||
|
||
```
|
||
tar -xzf boost_1_74_0.tar.bz2
|
||
cd boost_1_74_0
|
||
```
|
||
|
||
Run `bootstrap.sh` to generate `b2`:
|
||
|
||
```
|
||
./bootstrap.sh
|
||
```
|
||
|
||
You can change install prefix with `--prefix` option (default is `/usr/local`, need `sudo`), but I don't recommend.
|
||
|
||
Build and install:
|
||
|
||
```
|
||
sudo ./b2 --with-system --with-date_time --with-filesystem variant=debug link=static threading=multi -j4 install
|
||
```
|
||
|
||
Notes:
|
||
|
||
- Only build the specified libraries. `Asio` itself is header only so doesn’t have to be built.
|
||
Only build static libraries (`link=static`)
|
||
- The number after `-j` depends on the number of CPU cores you have.
|
||
- If you want to build release version libraries, set `variant=release`. The `debug` and `release` libraries have exactly the same name, so you cannot build them both at the same time.
|
||
- Don’t forget the `sudo` since the install prefix is `/usr/local`.
|
||
|
||
To clean the build, run `b2` with target "clean":
|
||
|
||
```
|
||
./b2 clean
|
||
```
|
||
|
||
The libraries are installed to `/usr/local/lib`. E.g.,
|
||
|
||
```
|
||
$ ls -l /usr/local/lib/libboost*
|
||
-rw-r--r-- 1 adam admin 540288 Apr 21 11:01 /usr/local/lib/libboost_date_time.a
|
||
-rw-r--r-- 1 root admin 2976 Apr 21 11:01 /usr/local/lib/libboost_system.a
|
||
...
|
||
```
|
||
|
||
The headers are installed to `/usr/local/include/boost`.
|
||
|
||
**IMPORTANT**
|
||
|
||
Remove the following directory otherwise CMake couldn’t find Boost.
|
||
|
||
```
|
||
sudo rm -r /usr/local/lib/cmake
|
||
```
|
||
|
||
This directory was installed by `b2`. I can’t see why it’s necessary.
|
||
|
||
## Install OpenSSL
|
||
|
||
Install with [Homebrew](https://brew.sh/) (the usage of Homebrew itself is out of the scope, please Google and learn it by yourself):
|
||
|
||
```
|
||
brew install openssl
|
||
```
|
||
|
||
Please note that it will be installed to `/usr/local/opt/openssl` instead of `/usr/local`.
|
||
|
||
## Install Zlib
|
||
|
||
Zlib should have already been provided by the system (`/usr/lib/libz.dylib`). If not, try to install with Homebrew.
|
||
|
||
## Build Webcc
|
||
|
||
Open CMake, set **Where is the source code** to Webcc root directory (e.g., `/Users/adam/github/webcc`), set **Where to build the binaries** to any directory (e.g., `/Users/adam/github/webcc_build`).
|
||
|
||
Check _**Grouped**_ and _**Advanced**_ two check boxes.
|
||
|
||
Click _**Configure**_ button. Select "Unix Makefiles" (or "Xcode") as the generator in the popup dialog.
|
||
|
||
In the center of CMake, you can see a lot of configure options which are grouped and might also be highlighted in RED.
|
||
|
||
|
||
|
||
Now change the options according to your need. E.g.,
|
||
|
||
|
||
|
||
Click _**Configure**_ button again, a message would say that OpenSSL couldn’t be found.
|
||
|
||
> Could NOT find OpenSSL, try to set the path to OpenSSL root folder in the system variable OPENSSL_ROOT_DIR (missing: OPENSSL_CRYPTO_LIBRARY OPENSSL_INCLUDE_DIR)
|
||
|
||
Don’t try to set the `OPENSSL_ROOT_DIR` system variable, it won’t work.
|
||
|
||
As aforementioned, the OpenSSL was installed by Homebrew, and it’s located in `/usr/local/opt/openssl`. Let’s tell CMake where it is.
|
||
|
||
|
||
|
||
Click _**Configure**_ button again. If everything is OK, click _**Generate**_ button.
|
||
|
||
Open Terminal, go to the build directory, run `make`. E.g.,
|
||
|
||
```
|
||
$ cd github/webcc_build
|
||
$ make -j4
|
||
```
|