Muxi Yan 56d09be51d Update CFStream doc 7 年 前
..
GRPCClient 71727d1efb Merge remote-tracking branch 'upstream/master' into default-cfstream-2 7 年 前
ProtoRPC f7ca97a6fe clang-format 7 年 前
RxLibrary 121e04bc1e address comments 2 7 年 前
examples 76f1ec16e1 sensible nullability annotation for old API 7 年 前
manual_tests 8b10d5faa7 Fix GrpcIosTestUITests flake and add some more testcases. 7 年 前
tests 71727d1efb Merge remote-tracking branch 'upstream/master' into default-cfstream-2 7 年 前
!ProtoCompiler-gRPCPlugin.podspec 0231bf3b01 Regenerate projects 7 年 前
!ProtoCompiler.podspec 44a646bc39 more commits for v1.19.0 7 年 前
BoringSSL-GRPC.podspec 44a646bc39 more commits for v1.19.0 7 年 前
CronetFramework.podspec 123d0dbd61 bug fix 9 年 前
NetworkTransitionBehavior.md 5d4bb063e1 Fix grammar 7 年 前
README-CFSTREAM.md 56d09be51d Update CFStream doc 7 年 前
README.md e8d6d47854 Update README for #16821 7 年 前
change-comments.py 7897ae9308 auto-fix most of licenses 9 年 前
format-all-comments.sh 7897ae9308 auto-fix most of licenses 9 年 前
grpc_shadow_boringssl_symbol_list b24b212ee5 Make symbols of BoringSSL private to gRPC 7 年 前

README-CFSTREAM.md

Cocoapods

gRPC Objective-C with CFStream

gRPC Objective-C library now provides the option to use Apple's CFStream API (rather than TCP sockets) for networking. Using CFStream resolves a bunch of network connectivity transition issues (see the doc for more information).

CFStream integration is now in experimental state. You will need explicit opt-in to use it to get the benefits of resolving the issues above. We expect to make CFStream the default networking interface that gRPC uses when it is ready for production.

As of v1.21.0, CFStream integration is now the default networking stack being used by gRPC Objective-C on iOS layer. You get to use it automatically without special configuration needed. See below on how to disable CFStream in case of problem.

Usage

If you use gRPC Objective-C library on iOS, CFStream is on automatically. If you use it on other platforms, you can turn it on with macro GRPC_CFSTREAM=1 for the pod 'gRPC-Core' and 'gRPC'. In case of problem and you want to disable CFStream on iOS, you can set environment variable "grpc_cfstream=0".

Notes

  • Currently we do not support platforms other than iOS, although it is likely that this integration can run on MacOS targets with Apple's compiler.
  • Let us know if you meet any issue by filing issue and ping @muxi.