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
|
# Ice for Swift Build Instructions
This file describes how to build Ice for Swift from source and how to test the
resulting build.
- [Swift Build Requirements](#swift-build-requirements)
- [Operating Systems](#operating-systems)
- [Slice to Swift Compiler](#slice-to-swift-compiler)
- [Swift Version](#swift-version)
- [Carthage](#carthage)
- [Building Ice for Swift](#building-ice-for-swift)
- [Running the Swift Test Suite](#running-the-swift-test-suite)
- [macOS](#macos)
- [iOS](#ios)
## Swift Build Requirements
### Operating Systems
Ice for Swift builds and runs on macOS and is supported on the platforms listed
on the [supported platforms] page.
### Slice to Swift Compiler
You need the Slice to Swift compiler to build Ice for Swift and also to use Ice
for Swift. The Slice to Swift compiler (`slice2swift`) is a command-line tool
written in C++. You can build the Slice to Swift compiler from source, or
alternatively you can install an Ice [binary distribution] that includes this
compiler.
### Swift Version
Ice for Swift requires Swift 5 or later.
### Carthage
Carthage must be installed to build Ice for Swift. You can install Carthage
using Homebrew:
```shell
brew install carthage
```
## Building Ice for Swift
First download and build the PromiseKit framework by running:
```shell
carthage bootstrap --use-xcframeworks
```
from the root directory of your ice repository.
Then open `ice.xcodeproj` with Xcode and build the `Ice macOS` or `Ice iOS`
targets.
The test programs for macOS and iOS can be built using `TestDriver macOS` and
`TestDriver iOS` respectively.
Building the `TestDriver iOS` application to deploy to an iOS device requires
signing the application 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`.
```shell
export DEVELOPMENT_TEAM=U4TBVKNQ7F
rake
```
## Running the Swift Test Suite
Python is required to run the test suite.
### macOS
After a successful build, you can run the tests as follows:
```shell
python3 allTests.py --config Debug
```
If everything worked out, you should see lots of `ok` messages. In case of a
failure, the tests abort with `failed`.
### iOS
Start the `TestDriver iOS` application on your iOS device or simulator, from
Xcode.
Then on your mac, run:
```shell
python3 allTests.py --config Debug --platform iphoneos
```
or
```shell
python3 allTests.py --config Debug --platform iphonesimulator
```
depending on your target.
[binary distribution]: https://zeroc.com/downloads/ice
[supported platforms]: https://doc.zeroc.com/ice/3.7/release-notes/supported-platforms-for-ice-3-7-10
|
