Yannic Bonenberger 06ecc87290 [bazel] Add fixes for --incompatible_load_proto_rules_from_bzl 5 vuotta sitten
..
GRPCClient 32ab87f23b Release autoreleasepool in completion queue loop 5 vuotta sitten
ProtoRPC 9ec763a800 Add doc to notice that users should not reuse GRPCUnaryResponseHandler 6 vuotta sitten
RxLibrary ccc5481ff0 fix typo in document 6 vuotta sitten
examples c34bef4ca4 Format all Bazel files with buildifier 6 vuotta sitten
manual_tests 732f55ac22 iOS UI test: fix path to generated code 6 vuotta sitten
tests f61a85eefa Add timestamp to basic tests 5 vuotta sitten
!ProtoCompiler-gRPCCppPlugin.podspec b67a7ef020 update ObjC podspecs to 3.11.2 5 vuotta sitten
!ProtoCompiler-gRPCPlugin.podspec b67a7ef020 update ObjC podspecs to 3.11.2 5 vuotta sitten
!ProtoCompiler.podspec b67a7ef020 update ObjC podspecs to 3.11.2 5 vuotta sitten
BUILD c34bef4ca4 Format all Bazel files with buildifier 6 vuotta sitten
BoringSSL-GRPC.podspec 9ad0a632b5 regenerate projects 5 vuotta sitten
CronetFramework.podspec 807eaa465a iOS performance test enhancements 6 vuotta sitten
NetworkTransitionBehavior.md 5d4bb063e1 Fix grammar 7 vuotta sitten
README-CFSTREAM.md 56d09be51d Update CFStream doc 6 vuotta sitten
README.md e8d6d47854 Update README for #16821 6 vuotta sitten
change-comments.py e52081f903 More pythons to be formatted 5 vuotta sitten
format-all-comments.sh 7897ae9308 auto-fix most of licenses 8 vuotta sitten
grpc_objc_internal_library.bzl 06ecc87290 [bazel] Add fixes for --incompatible_load_proto_rules_from_bzl 5 vuotta sitten
grpc_shadow_boringssl_symbol_list f098606c4a Revert "Revert "Reintroduce #21527 (boringssl submodule unification)"" 5 vuotta sitten

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.