Нема описа

Tim Burks df35d8087a Minor README update. пре 9 година
Examples 375e4ade71 Update for swift-protobuf 0.9.24, clarify dependency versions in README. пре 9 година
Plugin 7db97e09ba Basic scaffolding for a code generation plugin. пре 9 година
QuickProto 0ad10d298b Update file paths in quickproto project пре 9 година
Samples 31ef5cbf29 Update Samples to point to main (grpc-hosted) repository. пре 9 година
Sources 63c6acfa40 Move CgRPC, gRPC, and QuickProto to "Sources" directory and add new top-level Package.swift. пре 9 година
gRPC cc616f53e0 first working TLS client calls пре 9 година
gRPC.xcodeproj ce22fc609c Update file paths in gRPC.xcodeproj пре 9 година
third_party 63c6acfa40 Move CgRPC, gRPC, and QuickProto to "Sources" directory and add new top-level Package.swift. пре 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 година
CONTRIBUTING.md 98a8b64da5 Update README and CONTRIBUTING. пре 9 година
LICENSE d983798ec5 Fix license date (thomasvl@) пре 9 година
OVERVIEW.md 9267094097 Add initial API overview document. пре 9 година
PATENTS 36f2bde28e Add PATENTS declaration пре 9 година
Package.swift 63c6acfa40 Move CgRPC, gRPC, and QuickProto to "Sources" directory and add new top-level Package.swift. пре 9 година
README.md df35d8087a Minor README update. пре 9 година

README.md

Swift gRPC API

This repository contains an experimental Swift gRPC API.

Not yet intended for production use, it provides low-level Swift wrappers for the C gRPC API that can be used to build higher-level structures supporting streaming and nonstreaming gRPC APIs.

Temporary protocol buffer support is provided in the QuickProto library. This simple Swift library provides an API for building and parsing protocol buffers with no generated code. Conversion to Apple's swift-protobuf library is in progress.

Code is provided for both gRPC clients and servers, and it can be built either with Xcode or the Swift Package Manager. The Xcode build is demonstrated with Echo, a sample Mac app that can be used to run echo clients and servers with streaming and nonstreaming interfaces over secure (TLS) and insecure channels.

Other examples include Sessions, StickyNotes, and Speech.

Swift Package Manager builds are demonstrated on Linux using the instructions in the Packages directory.

Getting started

After cloning this repository, cd third_party; RUNME.sh to download its dependencies (we don't use git submodules to keep this repository lean for imports with the Swift Package Manager).

Building grpc

Swift gRPC currently requires a separate build of the grpc core library. To do this, enter the grpc directory and run git submodule update --init and then make install. If you get build errors, edit the Makefile and remove "-Werror" from the line that begins with "CPPFLAGS +=".

Can't find something?

To make it easier for the Swift Package manager to find, the code for gRPC, CgRPC, and QuickProto is in the [Sources] directory.

Having build problems?

grpc-swift depends on Swift, Xcode, and swift-proto, all of which are in flux and potential sources of breaking changes. 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.