Skip to content

Commit

Permalink
Update Readme to recommend using Xcode package support (#59)
Browse files Browse the repository at this point in the history
* Include updated wording about including NIO Transport Services in a project

* Add clause about usage in Xcode 10

* Update README.md

Commit suggestion

Co-Authored-By: Cory Benfield <lukasa@apple.com>
  • Loading branch information
tkrajacic and Lukasa committed Oct 11, 2019
1 parent 98663f6 commit 4add2df
Showing 1 changed file with 16 additions and 5 deletions.
21 changes: 16 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,22 +16,33 @@ Network.framework is Apple's reference implementation of the [proposed post-sock

## How to Use?

Today, the easiest way to use SwiftNIO Transport Services in an iOS project is through CocoaPods:
NIO Transport Services primarily uses SwiftPM as its build tool, so we recommend using that as well. If you want to depend on NIO Transport Services in your own project, it's as simple as adding a dependencies clause to your Package.swift:

```
dependencies: [
.package(url: "https://github.com/apple/swift-nio-transport-services.git", from: "1.1.1")
]
```

and then adding the NIOTransportServices module to your target dependencies.

If your project is set up as an Xcode project and you're using Xcode 11+, you can add NIO Transport Services as a dependency to your Xcode project by clicking File -> Swift Packages -> Add Package Dependency. In the upcoming dialog, please enter `https://github.com/apple/swift-nio-transport-services.git` and click Next twice. Finally, make sure `NIOTransportServices` is selected and click finish. Now will be able to `import NIOTransportServices` in your project.

You can also use SwiftNIO Transport Services in an iOS project through CocoaPods:

pod 'SwiftNIO', '~> 2.0.0'
pod 'SwiftNIOTransportServices', '~> 1.0.0'

You can also use the Swift Package Manager:
If you want to develop SwiftNIO with Xcode 10, you have to generate an Xcode project:

```
swift build
swift package generate-xcodeproj
```

and add the project as a sub-project by dragging it into your iOS project and adding the frameworks (such as `NIO.framework`) in 'Build Phases' -> 'Link Binary Libraries'.
and add the project as a sub-project by dragging it into your iOS project and adding the framework (`NIOTransportServices.framework`) in 'Build Phases' -> 'Link Binary Libraries'.

Do note however that Network.framework requires macOS 10.14+, iOS 12+, or tvOS 12+.


## Versioning

Just like the rest of the SwiftNIO family, `swift-nio-transport-services` follows [SemVer 2.0.0](https://semver.org/#semantic-versioning-200) with a separate document
Expand Down

0 comments on commit 4add2df

Please sign in to comment.