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
|
# Building Ice for C++ on Windows
This file describes how to build Ice for C++ from sources on Windows, and how
to test the resulting build.
ZeroC provides [Ice binary distributions][1] for various platforms and compilers,
including Windows and Visual Studio, so building Ice from sources is usually
unnecessary.
## Build Requirements
### Operating Systems and Compilers
Ice was extensively tested using the operating systems and compiler versions
listed for our [supported platforms][2].
The build requires the [Ice Builder for Visual Studio][8], you must install
version 4.2.0 or greater to build Ice.
### 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.16
- [mcpp][6] 2.7.2 (with patches)
You do not need to build these packages yourself, as ZeroC supplies
[Nuget][7] packages for all these third party dependencies.
The Ice build system for Windows downloads and installs Nuget and these
Nuget packages when you build Ice for C++. The third-party packages
are installed in the ``ice/cpp/msbuild/packages`` folder.
## Building Ice
Open a command prompt for example, when using Visual Studio 2015, you have
several alternatives:
- VS2015 x86 Native Tools Command Prompt
- VS2015 x64 Native Tools Command Prompt
Using the first configurations produces 32-bit binaries, while the second
configurations produce 64-bit binaries.
In the command window, change to the `cpp` subdirectory:
cd cpp
Now you're ready to build Ice:
Msbuild msbuild\ice.proj
This will build the Ice for C++ developer kit and the Ice for C++ test suite.
When using Visual Studio 2015 it will also build Ice for UWP (Universal Windows
Platform) and Ice for UWP test suite.
The build will create debug libraries and binaries for the default platform. If you
want to build release libraries and binaries you can do so by setting the Msbuild
`Configuration` property to `Release`:
MSbuild msbuild\ice.proj /p:Configuration=Release
The supported values for the Configuration property are `Debug` and `Release`
If you wan to build libraries and binaries for a different platform you need to
set the MSbuild `Platform` property, Ice for C++ supports `Win32` and `x64` platforms,
with Ice for UWP there is Additionally support for `ARM` platform.
For example to build release binaries and libraries for Windows `x64` platform use:
MSbuild msbuild\ice.proj /p:Configuration=Release /p:Platform=x64
To build Ice for UWP debug libraries for `ARM` platform use:
MSbuild msbuild\ice.proj /p:Configuration=Debug /p:Platform=ARM
If you want to skip building the test suite you can use the `BuildDist` MSbuild
target:
MSbuild msbuild\ice.proj /t:BuildDist /p:Configuration=Release /p:Platform=x64
It is also possible to build all supported platforms and configurations at once,
with the following command:
MSbuild msbuild\ice.proj /p:BuildAllConfigurations=yes
## Nuget packages
To create a Nuget package for the distribution use the following command:
MSbuild msbuild\ice.proj /t:NugetPack /p:BuildAllConfigurations=yes
This will create a ice.v120.nuckpkg or ice.v140.nuckpkg depending of the
compiler version you are using to build the package.
## 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 follows:
python allTests.py --mode=debug --x86
For C++11 mapping you need to use the `--c++11` argument:
$ python allTests.py --mode=debug --x86 --c++11
If everything worked out, you should see lots of `ok` messages. In case of a
failure, the tests abort with `failed`.
## Running the Universal Windows Platform Test Suite
In Visual Studio 2015, open the solution file:
cpp\msbuild\ice.testuwp.sln
Now select the configuration that matches the settings that you used to build
Ice for UWP.
To run the UWP Test suite application you can deploy the application using "Deploy
Solution" in the "Build" menu. Once deployed, you can start the application from
the Start Menu by clicking the "Ice Test Suite" icon.
In the test suite application, selecting "uwp" for the Server field allows you
to run tests with TCP and WS protocols supported by the UWP server side.
You can also use C++, C# or Java servers to run the tests, which allows you to
use additional SSL and WSS protocols.
To use servers from C++, C# or Java language mappings, you need to build the
tests for the desired language mapping.
The test controller server is implemented in Java. Refer to the build
instructions in java subdirectory for information on building the test
controller. Use the following command to start the test controller:
> python scripts/TestController.py
In the "Ice Test Suite" Windows Store application, select the Server language
mapping and Protocol you want to use.
[1]: https://zeroc.com/download.html
[2]: https://doc.zeroc.com/display/Ice37/Supported+Platforms+for+Ice+3.7.0
[3]: http://bzip.org
[4]: http://expat.sourceforge.net
[5]: http://symas.com/mdb/
[6]: https://github.com/zeroc-ice/mcpp
[7]: https://www.nuget.org
[8]: https://github.com/zeroc-ice/ice-builder-visualstudio
|
