1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
# Building Ice for C++ on macOS
This file describes the Ice source distribution, including information about
compiler requirements, third-party dependencies, and instructions for building
and testing the distribution. If you prefer, you can install a [Homebrew][1]
package instead.
## C++ Build Requirements
### Operating Systems and Compilers
Ice was extensively tested using the operating systems and compiler versions
listed for our [supported platforms][2].
### Third-Party Libraries
Ice has dependencies on a number of third-party libraries:
- [bzip][3] 1.0
- [Expat][4] 2.1
- [LMDB][5] 0.9 (LMDB is not required with the C++11 mapping)
- [mcpp][6] 2.7.2 (with patches)
Expat and bzip are included with your system.
You can install LMDB and mcpp using [Homebrew][7]:
```
brew install lmdb mcpp
```
## Building Ice
Review the top-level [config/Make.rules](../config/Make.rules) in your build
tree and update the configuration if needed. The comments in the file provide
more information.
In a command window, change to the `cpp` subdirectory:
```
cd cpp
```
Run `make` to build the Ice C++ libraries, services and test suite. Set `V=1` to
get a more detailed build output. You can build only the libraries and services
with the `srcs` target, or only the tests with the `tests` target. For example:
```
make V=1 -j8 srcs
```
### Build configurations and platforms
The C++ source tree supports multiple build configurations and platforms. To
see the supported configurations and platforms:
```
make print V=supported-configs
make print V=supported-platforms
```
To build all the supported configurations and platforms:
```
make CONFIGS=all PLATFORMS=all -j8
```
### C++11 mapping
The C++ source tree supports two different language mappings (C++98 and C++11).
The default build uses the C++98 mapping. The C++11 mapping is a new mapping
that uses new language features.
To build the C++11 mapping, use build configurations that are prefixed with
`cpp11`, for example:
```
make CONFIGS=cpp11-shared -j8
```
### Ice Xcode SDK
The build system supports building Xcode SDKs for Ice. These SDKs allow you to
easily develop Ice applications with Xcode. To build Xcode SDKs, use the
`xcodesdk` configurations:
```
make CONFIGS=xcodesdk -j8 srcs # Build the C++98 mapping Xcode SDK
make CONFIGS=cpp11-xcodesdk -j8 srcs # Build the C++11 mapping Xcode SDK
```
The Xcode SDKs are built into `ice/sdk`.
## Installing a C++ Source Build
Simply run `make install`. This will install Ice in the directory specified by
the `prefix` variable in `../config/Make.rules`.
After installation, make sure that the `<prefix>/bin` directory is in your
`PATH`.
If you choose to not embed a `runpath` into executables at build time (see your
build settings in `../config/Make.rules`) or did not create a symbolic link from
the `runpath` directory to the installation directory, you also need to add the
library directory to your `DYLD_LIBRARY_PATH`.
When compiling Ice programs, you must pass the location of the
`<prefix>/include` directory to the compiler with the `-I` option, and the
location of the library directory with the `-L` option.
If building a C++11 program, you must define the `ICE_CPP11_MAPPING` macro
during compilation with the `-D` option (for example `clang++
-DICE_CPP11_MAPPING`) and add the `++11` suffix to the library name when linking
(such as `-lIce++11`).
The Ice Xcode SDKs are installed in `<prefix>/sdk`.
## Building the Test Suite
`make all` or `make tests` builds the test suite for the platform(s) and
configuration(s) you selected.
However, in order to run the test suite on `iphoneos`, you need to build the
C++98 Test Controller app or C++11 Test Controller app from Xcode:
- Build the test suite with `make` for the `xcodedsk` or `cpp11-xcodesdk`
configuration, and the `iphoneos` platform.
- Open the C++ Test Controller project located in the
`cpp/test/ios/controller` directory.
- Build the `C++98 Test Controller` or the `C++11 Test Controller` app (it must
match the configuration(s) selected when building the test suite).
## Running the Test Suite
Python is required to run the test suite. Additionally, the Glacier2 tests
require the Python module `passlib`, which you can install with the command:
```
pip install passlib
```
After a successful source build, you can run the tests as shown below. If
everything worked out, you should see lots of `ok` messages. In case of a
failure, the tests abort with `failed`.
### macOS
```
python allTests.py # default config and default platform
python allTests --config=... --platform=... # use the specified config and platform
```
### iOS Simulator
```
python allTests.py --config=xcodesdk --platform=iphonesimulator --controller-app
python allTests.py --config=cpp11-xcodesdk --platform=iphonesimulator --controller-app
```
### iOS
- Start the `C++98 Test Controller` or the `C++11 Test Controller` app on your
iOS device, from Xcode.
- On your Mac:
```
python allTests.py --config=xcodesdk --platform=iphoneos # C++98 controller
python allTests.py --confg=cpp11-xcodesdk --platform=iphoneos # C++11 controller
```
All the test clients and servers run on the iOS device, not on your Mac
computer.
[1]: https://doc.zeroc.com/display/Rel/Using+the+macOS+Binary+Distribution+for+Ice+3.7.0
[2]: https://doc.zeroc.com/display/Rel/Supported+Platforms+for+Ice+3.7.0
[3]: http://bzip.org
[4]: https://libexpat.github.io
[5]: https://symas.com/lightning-memory-mapped-database/
[6]: https://github.com/zeroc-ice/mcpp
[7]: https://brew.sh
|
