blob: ba56d94cd0c8a32508ba753285606261661908f4 (
plain)
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
|
# Building Ice for Swift
This file describes how to build Ice for Swift from source and how to test the
resulting build.
* [Build Requirements](#build-requirements)
* [Operating Systems](#operating-systems)
* [Slice to Swift Compiler](#slice-to-swift-compiler)
* [Swift Version](#swift-version)
* [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][2] 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][1] 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:
```
brew install carthage
```
## Building Ice for Swift
First download and build the PromiseKit framework by running:
```
carthage update
```
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.
## 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:
```
python 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:
```
python allTests.py --config Debug --platform iphoneos
```
or
```
python allTests.py --config Debug --platform iphonesimulator
```
depending on your target.
[1]: https://zeroc.com/downloads/ice
[2]: https://doc.zeroc.com/ice/3.7/release-notes/supported-platforms-for-ice-3-8-0
|
