mirror of https://github.com/grpc/grpc.git
The C based gRPC (C++, Python, Ruby, Objective-C, PHP, C#)
https://grpc.io/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
58 lines
1.9 KiB
58 lines
1.9 KiB
# gRPC in 3 minutes (Objective-C) |
|
|
|
## Installation |
|
|
|
To run this example you should have [Cocoapods](https://cocoapods.org/#install) installed, as well |
|
as the relevant tools to generate the client library code (and a server in another language, for |
|
testing). You can obtain the latter by following [these setup instructions](https://github.com/grpc/homebrew-grpc). |
|
|
|
## Hello Objective-C gRPC! |
|
|
|
Here's how to build and run the Objective-C implementation of the [Hello World](../../protos/helloworld.proto) |
|
example used in [Getting started](https://github.com/grpc/grpc/tree/master/examples). |
|
|
|
The example code for this and our other examples lives in the `examples` directory. Clone |
|
this repository to your local machine by running the following commands: |
|
|
|
|
|
```sh |
|
$ git clone -b $(curl -L http://grpc.io/release) https://github.com/grpc/grpc |
|
$ cd grpc |
|
$ git submodule update --init |
|
``` |
|
|
|
Change your current directory to `examples/objective-c/helloworld` |
|
|
|
```sh |
|
$ cd examples/objective-c/helloworld |
|
``` |
|
|
|
### Try it! |
|
To try the sample app, we need a gRPC server running locally. Let's compile and run, for example, |
|
the C++ server in this repository: |
|
|
|
```shell |
|
$ pushd ../../cpp/helloworld |
|
$ make |
|
$ ./greeter_server & |
|
$ popd |
|
``` |
|
|
|
Now have Cocoapods generate and install the client library for our .proto files: |
|
|
|
```shell |
|
$ pod install |
|
``` |
|
|
|
(This might have to compile OpenSSL, which takes around 15 minutes if Cocoapods doesn't have it yet |
|
on your computer's cache.) |
|
|
|
Finally, open the XCode workspace created by Cocoapods, and run the app. You can check the calling |
|
code in `main.m` and see the results in XCode's log console. |
|
|
|
The code sends a `HLWHelloRequest` containing the string "Objective-C" to a local server. The server |
|
responds with a `HLWHelloResponse`, which contains a string that is then output to the log. |
|
|
|
## Tutorial |
|
|
|
You can find a more detailed tutorial in [gRPC Basics: Objective-C](http://www.grpc.io/docs/tutorials/basic/objective-c.html).
|
|
|