|
|
# 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). The current version is 1.70.0.
|
|
|
|
|
|
Unpack and go into the directory:
|
|
|
|
|
|
```
|
|
|
tar -xzf boost_1_70_0.tar.bz2
|
|
|
cd boost_1_70_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-filesystem --with-date_time 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 adam admin 1717736 Apr 21 11:01 /usr/local/lib/libboost_filesystem.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
|
|
|
```
|
|
|
|
|
|
There might be some warnings, just ignore them.
|
|
|
|
|
|
Suppose you have checked `WEBCC_ENABLE_AUTOTEST` during the configuration, you can run it now.
|
|
|
|
|
|
```
|
|
|
$ cd autotest
|
|
|
$ ./webcc_autotest
|
|
|
[==========] Running 7 tests from 1 test case.
|
|
|
[----------] Global test environment set-up.
|
|
|
[----------] 7 tests from ClientTest
|
|
|
[ RUN ] ClientTest.Get_RequestFunc
|
|
|
[ OK ] ClientTest.Get_RequestFunc (1066 ms)
|
|
|
[ RUN ] ClientTest.Get_Shortcut
|
|
|
[ OK ] ClientTest.Get_Shortcut (1844 ms)
|
|
|
[ RUN ] ClientTest.Get_SSL
|
|
|
[ OK ] ClientTest.Get_SSL (2158 ms)
|
|
|
[ RUN ] ClientTest.Compression_Gzip
|
|
|
[ OK ] ClientTest.Compression_Gzip (913 ms)
|
|
|
[ RUN ] ClientTest.Compression_Deflate
|
|
|
[ OK ] ClientTest.Compression_Deflate (921 ms)
|
|
|
[ RUN ] ClientTest.KeepAlive
|
|
|
[ OK ] ClientTest.KeepAlive (5121 ms)
|
|
|
[ RUN ] ClientTest.GetImageJpeg
|
|
|
[ OK ] ClientTest.GetImageJpeg (1244 ms)
|
|
|
[----------] 7 tests from ClientTest (13267 ms total)
|
|
|
[----------] Global test environment tear-down
|
|
|
[==========] 7 tests from 1 test case ran. (13267 ms total)
|
|
|
[ PASSED ] 7 tests.
|
|
|
``` |