diff options
Diffstat (limited to 'cpp/BuildInstructionsWinRT.md')
| -rw-r--r-- | cpp/BuildInstructionsWinRT.md | 76 |
1 files changed, 55 insertions, 21 deletions
diff --git a/cpp/BuildInstructionsWinRT.md b/cpp/BuildInstructionsWinRT.md index f847594e715..3ff56795024 100644 --- a/cpp/BuildInstructionsWinRT.md +++ b/cpp/BuildInstructionsWinRT.md @@ -1,31 +1,42 @@ # Building Ice for C++ for WinRT Applications -This page 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 download a [Windows installer](https://doc.zeroc.com/display/Ice36/Using+the+Windows+Binary+Distribution) that contains pre-compiled debug and release libraries, executables, and everything else necessary to build Ice applications on Windows. +This page 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 download a [Windows installer][1] +that contains pre-compiled debug and release libraries, executables, and everything +else necessary to build Ice applications for WinRT. ## Build Requirements for WinRT -Ice was extensively tested using the operating systems and compiler versions listed for our [supported platforms](https://zeroc.com/platforms_3_6_0.html). +Ice was extensively tested using the operating systems and compiler versions listed +for our [supported platforms][2]. -## Compiling and Testing Ice for WinRT +## Compiling and Testing Ice ### Building Ice -> *To build Ice for WinRT you first need 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.* +> *To build Ice for WinRT you first need 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 gives you several alternatives: +Open a command prompt that is configured for your target architecture. For example, +Visual Studio 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. +Using the first configuration produces 32-bit binaries, while the second and third +produce 64-bit binaries and the fourth produces ARM binaries. -In the command window, change to the ```cpp``` subdirectory: +In the command window, change to the `cpp` subdirectory: $ cd cpp -Edit ```config\Make.rules.mak``` to establish your build configuration. The comments in the file provide more information. In particular, you must set ```WINRT``` to yes in ```Make.rules.mak``` or in your environment: +Edit `config\Make.rules.mak` to establish your build configuration. The comments +in the file provide more information. In particular, you must set `WINRT` to yes +in `Make.rules.mak` or in your environment: > set WINRT=yes @@ -37,11 +48,14 @@ After the build has completed, you must register the Ice SDK in the Windows regi > nmake /f Makefile.mak register-sdk -> *This command must be executed in a command prompt that has administrative privileges because it requires write access to the registry.* +> *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. +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: @@ -55,26 +69,46 @@ In Visual Studio, open this solution file: cpp/test/WinRT/TestSuite.sln -Now select the configuration that matches the settings in ```config\Make.rules.mak``` that you used to build the dynamic libraries. For example, if you built the test libraries for x86 and debug, you must select Win32 Debug. +Now select the configuration that matches the settings in `config\Make.rules.mak` +that you 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 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. +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. +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: +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. +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. +To run the tests on a remote device such as the Surface, you will need to install +the Remote Debugger Tools. -> *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.* +> *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.* -## Installing a C++ Source Build for WinRT +## Installing a C++ Source Build -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```. +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`. -> *This command must be executed in a command prompt that has administrative privileges because it requires write access to the registry.* +> *This command must be executed in a command prompt that has administrative +privileges because it requires write access to the registry.* + +[1]: https://doc.zeroc.com/display/Ice36/Using+the+Windows+Binary+Distribution +[2]: https://zeroc.com/platforms_3_6_0.html +[3]: http://expat.sourceforge.net +[4]: http://bzip.org +[5]: http://www.oracle.com/us/products/database/berkeley-db/overview/index.htm +[6]: https://github.com/zeroc-ice/mcpp +[7]: https://zeroc.com/download.html |