Versions Compared

Old Version 17

changes.mady.by.user Mark Spruiell

Saved on

compared with

New Version Current

changes.mady.by.user Mark Spruiell

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Ice Touch depends on mcpp 2.7.2 (with patches). Binary and source distributions of mcpp are available on our download page.

Xcode Plug-in

Our Xcode Plug-in is required for building the Cocoa and iPhone sample projects included in this distribution. We strongly recommended that you develop Ice for C++ and Ice Touch applications with Xcode, as it greatly simplifies the build process.

Ztop

Compiling and Testing Ice Touch

Unpack the Ice Touch source archive. The source files are contained in the IceTouch-1.3.23 subdirectory.

Building the Slice Compilers

...

Change the working directory to IceTouch-1.3.23/cpp:

$ cd IceTouch-1.3.23/cpp

Set MCPP_HOME to point to the installation directory of your MCPP binaries, for example:

$ export MCPP_HOME=$HOME/IceTouch-1.3.23-ThirdParty

Set OPTIMIZE_SPEED to yes to create an optimized build:

...

You can build a C++ SDK for each of three different targets: Cocoa, iPhone, and iPhone Simulator. Change to the IceTouch-1.3.23/cpp directory and run one of the following commands to build an SDK:

$ cd IceTouch-1.3.23/cpp
$ make COMPILE_FOR_COCOA=yes
or
$ make COMPILE_FOR_IPHONE=yes
or
$ make COMPILE_FOR_IPHONE_SIMULATOR=yes 

...

Info

OS X and iOS provide two C++ run time libraries, the older libstd++ and newer libc++. By default, Xcode 5 6 links with libc++ when targeting OS X 10.9 or iOS >= 7, and with libstd++ when targeting earlier versions.

The Ice Touch build system targets iOS 5.1.1 and OS X 10.7, and as a result creates libraries linked with libstd++. If you want to create libraries linked with libc++, set CPP11 to yes, for example:

 $ make COMPILE_FOR_IPHONE=yes CXXARCHFLAGS="-arch arm64" CPP11=yes

The resulting libraries will carry a -libc++ suffix, such as libIceCpp-libc++.a or libIceGridCpp-libc++.a

These -libc++ libraries can be used by C++ applications that use C++11 features (--std=c++11), and also by C++ applications that do not (no --std=c++11).

If you built for iPhone or the iPhone simulator, you should now should now use Xcode to build the demos and test suite GUI located in the following the following subdirectories:

  • demo/iPhone/hello
  • test/iPhone/container

After a successful build, you can run the test suite. For  For a Cocoa build, run:

$ python allTests.py

If everything works, you should see lots of "ok" messages. In case of a failure, the tests abort with "failed".

...

Info

The container project has two targets:

  • container, for default builds linked with libstdc++
  • container c++11, for CPP11=yes builds linked with libc++

The architecture used to build the "Test Suite" application or the hello demo is specified with the "Architectures" build setting in the Xcode project. It must match the architecture used to build Ice Touch.

To build for a different target, you first need to clean the current build using the clean command. For example, if you built for Cocoa, run

...

You can build an Objective-C SDK for each of four different targets: OS X (command line), Cocoa, iPhone, and iPhone Simulator. Change to the IceTouch-1.3.23/objc directory and run one of the following commands to build an SDK:

$ cd IceTouch-1.3.23/objc
$ make
or
$ make COMPILE_FOR_COCOA=yes
or
$ make COMPILE_FOR_IPHONE=yes
or
$ make COMPILE_FOR_IPHONE_SIMULATOR=yes 

The first make command (without any arguments) builds the OS X SDK with dynamic libraries, the test suite, and the demos. The remaining make commands generate static libraries and build the test suite. The build configuration options can be found in config/Make.rules.

Tip

When building for iPhone in debug mode, make will by default build only for armv7. You can specify different architecture(s) with ARCHFLAGSCXXARCHFLAGS, for example:

$ make COMPILE_FOR_IPHONE=yes ARCHFLAGSCXXARCHFLAGS="-arch arm64" 

Ice Touch supports armv7, armv7s and arm64.

Info

The Ice Touch Objective-C SDK relies on C++ code. OS X and iOS provide two C++ run time libraries, the older libstd++ and newer libc++. By default, Xcode 5 6 links with libc++ when targeting OS X 10.9 or iOS >= 7, and with libstd++ when targeting earlier versions.

The Ice Touch build system targets iOS 5.1.1 and OS X 10.7, and as a result creates libraries linked with libstd++. If you want to create libraries linked with libc++, set CPP11 to yes, for example:

$ make COMPILE_FOR_IPHONE=yes ARCHFLAGSCXXARCHFLAGS="-arch arm64" CPP11=yes

The resulting libraries will carry a -libc++ suffix, such as libIceObjC-libc++.a or libIceGridObjC-libc++.a

If you built for Cocoa, you should now use Xcode to build the demos located in the following subdirectories:

  • demo/Cocoa/chat
  • demo/Cocoa/library

If you are building for iPhone or the iPhone simulator, you should now use Xcode to build the demos and test suite GUI located in the following subdirectories:

  • demo/iPhone/chat
  • demo/iPhone/library
  • demo/iPhone/hello
  • demo/iPhone/router
  • demo/iPhone/voip
  • test/iPhone/container

To compile the demos, you can also open the Xcode workspace IceTouch-1.3.23/demos.xcworkspace. The workspace includes the Cocoa and iPhone demo projects.

...

After a successful build, you can run the test suite. For  For an OS X or Cocoa build, run:

$ python allTests.py

If everything works, you should see lots of "ok" messages. In case of a failure, the tests abort with "failed".

...