Browse Source

Add CocoaPods info to README

Michael Rebello 7 years ago
parent
commit
acd33acfbb
1 changed files with 29 additions and 15 deletions
  1. 29 15
      README.md

+ 29 - 15
README.md

@@ -27,13 +27,35 @@ Swift Package Manager builds may also be made on Linux
 systems. Please see [DOCKER.md](DOCKER.md) and 
 [LINUX.md](LINUX.md) for details.
 
-## gRPC dependencies are vendored
+## CocoaPods integration
 
-Swift gRPC includes vendored copies of the gRPC core
-library and **BoringSSL**, an OpenSSL fork that is used by
-the gRPC Core. These are built automatically in Swift Package
+Swift gRPC is currently available [from CocoaPods](https://cocoapods.org/pods/SwiftGRPC).
+To integrate, add the following line to your `Podfile`:
+
+    pod 'SwiftGRPC'
+
+Then, run `pod install` from command line and use your project's generated
+`.xcworkspace` file.
+
+## Manual integration
+
+When not using CocoaPods, Swift gRPC includes **vendored copies** of the
+gRPC Core library and BoringSSL (an OpenSSL fork that is used by
+the gRPC Core). These are built automatically in Swift Package
 Manager builds.
 
+After [building your project](#building-your-project), add the generated
+`SwiftGRPC.xcodeproj` to your project, and add build dependencies
+on **BoringSSL**, **CgRPC**, **gRPC**, and **CzLib**.
+
+Please also note that your project will need to include the
+`SwiftProtobuf.xcodeproj` from
+[Swift Protobuf](https://github.com/apple/swift-protobuf) and
+the source files that you generate with `protoc`/[plugins](#getting-the-plugins).
+
+See [Echo](Examples/Echo) for a working Xcode-based
+example, and don't hesitate to file issues if you find any problems.
+
 ## Usage
 
 The recommended way to use Swift gRPC is to first define an API using the
@@ -44,7 +66,7 @@ and the [Swift Protobuf](https://github.com/apple/swift-protobuf)
 and [Swift gRPC](https://github.com/grpc/grpc-swift) plugins to
 generate the necessary support code.
 
-### Getting the dependencies
+### Getting the plugins
 
 Binary releases of `protoc`, the Protocol Buffer Compiler, are
 available on [GitHub](https://github.com/google/protobuf/releases).
@@ -78,16 +100,8 @@ generate an Xcode project for the SwiftGRPC package:
     $ make
 
 This will create `SwiftGRPC.xcodeproj`, which you should
-add to your project, along with setting build dependencies
-on **BoringSSL**, **CgRPC**, **gRPC**, and **CzLib**.
-
-Please also note that your project will need to include the
-**SwiftProtobuf.xcodeproj** from
-[Swift Protobuf](https://github.com/apple/swift-protobuf) and
-the source files that you generated with `protoc` and the plugins.
-
-Please see [Echo](Examples/Echo) for a working Xcode-based
-example and file issues if you find any problems.
+add to your project, along with setting the necessary build dependencies
+mentioned [above](#manual-integration).
 
 ### Low-level gRPC