forked from zeroc-ice/ice
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathINSTALL.WINRT
159 lines (104 loc) · 4.87 KB
/
INSTALL.WINRT
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
159
======================================================================
Introduction
======================================================================
This file describes the Ice source distribution, including information
about compiler requirements and instructions for building and testing
the distribution.
For information about Ice for Windows see INSTALL.WINDOWS in this
directory.
If you prefer, you can download a Windows installer that contains
pre-compiled debug and release libraries, executables, and everything
else necessary to build Ice applications on Windows at the link below:
http://www.zeroc.com/download.html
======================================================================
Requirements
======================================================================
Windows version
---------------
Ice for WinRT has been extensively tested on:
- Windows 8 (x86 & x64)
- Windows RT (ARM)
C++ compiler
------------
The following C++ compilers are supported:
- Microsoft Visual C++ 2012 (Professional and Express editions)
======================================================================
Compilation and Testing
======================================================================
Building Ice for WinRT
----------------------
Using your favorite Zip tool, unzip the Ice source archive anywhere
you like.
To build Ice for WinRT you first need to build Ice for Windows. Refer
to INSTALL.WINDOWS for instructions on how to build Ice for
Windows. The build of Ice for Windows is necessary to create the Slice
translators that we need to build Ice for WinRT.
Open a command prompt that is configured for your target architecture.
For example, Visual Studio 2012 gives you several alternatives:
- Visual Studio Command Prompt
- Visual Studio x64 Win64 Command Prompt
- Visual Studio x64 Cross Tools Command Prompt
- Visual Studio ARM Cross Tools Command Prompt
Using the first configuration produces 32-bit binaries, while the
second and third produce 64-bit binaries and the fourth produces ARM
binaries.
Change the working directory to Ice-@ver@. For example:
> cd C:\Ice-@ver@\cpp
Edit config\Make.rules.mak to establish your build configuration. The
comments in the file provide more information. You must in particular
set WINRT to yes in Make.rules.mak or in your environment:
> set WINRT=yes
Now you're ready to build Ice for WinRT:
> nmake /f Makefile.mak
After the build has completed, you must register the Ice SDK in the
Windows registry:
> nmake /f Makefile.mak register-sdk
Note that this command must be executed in a command prompt that has
administrative privileges because it requires write access to the
registry.
Running the Test Suite
----------------------
The WinRT test suite is composed of a set of dynamic libraries (one
for each client/server test) and a GUI application that loads and runs
the tests in the dynamic libraries.
You need to build the dynamic libraries first. Change the working
directory to Ice-@ver@:
> cd C:\Ice-@ver@\cpp\test
Run nmake to build the test libraries:
> nmake /f Makefile.mak
In Visual Studio 2012, open this project file:
cpp/test/WinRT/TestSuite.sln
You must select the configuration that matches your settings in
config\Make.rules.mak.cs used to build the dynamic libraries. For
example, if you built the test libraries for x86 and debug, you must
select Win32 Debug.
After selecting the appropriate configuration, build the solution
by choosing "Build Solution" in the "Build" menu.
After the build completes, you can deploy the application using
"Deploy Solution" in the "Build" menu. Once deployed, you can start
the application from the WinRT Desktop by clicking the "Ice Test
Suite" icon.
If you want to run the tests with SSL enabled, you must use servers
from another language mapping as WinRT does not support server-side
SSL.
To run a test with SSL, open a command window and change to the test
directory. At the command prompt, execute:
> python run.py --winrt --protocol=ssl
Then open the "Ice Test Suite" Windows Store application, check "Enable
SSL", and click the "Run" button.
To run the tests on a remote device such as the Surface, you will need
to install the Remote Debugger Tools. Instructions on the Remote
Debugger Tools are available at this link:
http://msdn.microsoft.com/en-us/library/vstudio/bt727f1t.aspx
Note: some tests might fail if you run the tests with the debugger
attached. You should choose "Start without Debugging" from the Debug
menu to run the tests.
======================================================================
Installation
======================================================================
Simply run "nmake /f Makefile.mak install". This will install the Ice
SDK in the directory specified by the "prefix" variable in
config\Make.rules.mak.
Note that this command must be executed in a command prompt that has
administrative privileges because it requires write access to the
registry.