暂无描述

Tim Burks b5aa1d9a20 Update comments in client templates.		8 年之前
Assets	8013cc8423 Remove unused gRPC.xcodeproj (replaced by the generated SwiftGRPC.xcodeproj)	9 年之前
Docker	f317d11f7b Add Dockerfile for a customized Swift gRPC image.	9 年之前
Examples	b5aa1d9a20 Update comments in client templates.	8 年之前
Plugin	b5aa1d9a20 Update comments in client templates.	8 年之前
Sources	258478fa3a Use optional binding when initializing a Channel with certificates.	8 年之前
Tests	44903ec7e3 Convert examples to use CountDownLatch, update version to 0.1.6	9 年之前
third_party	ddd1ddb430 Reorganize examples, make dependency on swift-proto 0.9.24 explicit in third_party/RUNME.sh	9 年之前
.gitignore	6a1e661e29 Swift Echo sample	9 年之前
.gitmodules	63c6acfa40 Move CgRPC, gRPC, and QuickProto to "Sources" directory and add new top-level Package.swift.	9 年之前
.swift-version	b7dcb9e04c Add Travis build and test configuration.	9 年之前
.travis-install.sh	a7927827eb Add missing dependencies to travis configuration.	9 年之前
.travis.yml	a7927827eb Add missing dependencies to travis configuration.	9 年之前
CONTRIBUTING.md	98a8b64da5 Update README and CONTRIBUTING.	9 年之前
DOCKER.md	7a8dbb0371 Update Docker instructions to download a pre-built protoc.	9 年之前
LICENSE	d983798ec5 Fix license date (thomasvl@)	9 年之前
LINUX.md	cd67135c18 Fixed plugin for use on Linux.	9 年之前
Makefile	7ac0661724 Generate SwiftGRPC.xcodeproj in the top-level Makefile.	8 年之前
OVERVIEW.md	b0edcaedfa Add details to OVERVIEW document.	9 年之前
PATENTS	36f2bde28e Add PATENTS declaration	9 年之前
Package.swift	20e0cf1bb2 Reorganize vendored gRPC core code, moving it into CgRPC.	9 年之前
README.md	7ac0661724 Generate SwiftGRPC.xcodeproj in the top-level Makefile.	8 年之前
SwiftGRPC-incomplete.podspec	82b3a928d5 Rename podspec to clarify its status.	9 年之前
vendor-boringssl.sh	220cc3fe29 Update vendoring scripts and build configuration for examples for new vendored gRPC Core.	9 年之前
vendor-grpc.sh	220cc3fe29 Update vendoring scripts and build configuration for examples for new vendored gRPC Core.	9 年之前

Swift gRPC

This repository contains an experimental Swift gRPC API and code generator.

It is intended for use with Apple's swift-protobuf support for Protocol Buffers. Both projects contain code generation plugins for protoc, Google's Protocol Buffer compiler, and both contain libraries of supporting code that is needed to build and run the generated code.

APIs and generated code is provided for both gRPC clients and servers, and can be built either with Xcode or the Swift Package Manager. Support is provided for all four gRPC API styles (Unary, Server Streaming, Client Streaming, and Bidirectional Streaming) and connections can be made either over secure (TLS) or insecure channels.

The Echo example provides a comprehensive demonstration of currently-supported features.

Swift Package Manager builds may also be made on Linux systems. Please see DOCKER.md and LINUX.md for details.

gRPC dependencies are vendored

Swift gRPC now 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.

Building with Xcode

The top-level Makefile uses the Swift Package Manager to generate an Xcode project for the SwiftGRPC package. Due to present limitations in Package Manager configuration, the libz dependency is not included in the generated Xcode project. If you get build errors about missing symbols such as _deflate, _deflateEnd, etc., you can fix them by adding libz.tbd to the Link Binary With Libraries build step of the CgRPC target.

Having build problems?

grpc-swift depends on Swift, Xcode, and swift-proto. We are currently testing with the following versions:

Xcode 8.2
Swift 3.0.2
swift-proto 0.9.24

License

grpc-swift is released under the same license as gRPC, repeated in LICENSE.

Contributing

Please get involved! See our guidelines for contributing.

README.md