Skip to content

Latest commit

 

History

History

swift

README.md

Swift Demos

Overview

This directory contains Swift sample programs for various Ice components. These examples are provided to get you started on using a particular Ice feature or coding technique.

Most of the subdirectories here correspond directly to Ice components, such as Glacier2, IceStorm, and so on. We've also included the following additional sub-directories:

Refer to the C++11 demos for more examples that use the Ice services (Glacier2, IceGrid, IceStorm).

Building and running the demos with Xcode and Carthage

Build Requirements

In order to build these Ice for Swift sample programs, you need:

  • Xcode
  • Slice to Swift and Slice to C++ compilers
  • Carthage

Install required dependencies using Carthage

carthage bootstrap --cache-builds --use-xcframeworks

This command will build the Ice and PromiseKit frameworks required by the sample programs and install them in the Carthage/Build/ directory.

Note: building Ice macOS and Ice iOS from source during carthage bootstrap takes some time, please be patient.

If you want to use the slice2swift and slice2cpp compilers from a source distribution, set the ICE_HOME environment variable before running carthage bootstrap.

Building the demos

Open the project file demos.xcodeproj to build the sample programs.

The demos are configured to use the Ice and PromiseKit frameworks from the Carthage builds and the slice2swift compiler from the binary distribution.

If you want to build the sample programs using slice2swift compiler from a source distribution, set the ICE_HOME environment variable before starting Xcode.

Building the demo applications to deploy to an iOS device requires signing the applications with a developer certificate. You need to update the Xcode projects to use your Apple development certificates by setting DEVELOPMENT_TEAM environment variable to the Id of your development team and regenerate the projects with rake.

export DEVELOPMENT_TEAM=U4TBVKNQ7F
rake

Running the Demos

For most demos, you can simply run ./Build/server and ./Build/client in separate terminals. Refer to the README.md file in each demo directory for the exact usage instructions.

Some demos require Ice services such as IceGrid and IceStorm that are not included in the Ice for Swift distribution. To run these demos, the simplest is to first install the Ice Homebrew packages. Please refer to Using the macOS Binary Distributions for additional information.

Building and running the demos with Swift Package Manager (SPM)

There is currently a single demo with SPM support, printer.

Building the demos

Run swift build from the demo directory.

cd Manual/spm/printer
swift build

Running the demos

Swift Package Manager puts the executables in the build output directory. Refer to the printer's README.md for more information.