| gRPC on Android |
| ============== |
| |
| Note: Building the protobuf dependency for Android requires |
| https://github.com/protocolbuffers/protobuf/pull/3878. This fix will be in the next |
| protobuf release, but until then must be manually patched in to |
| `third_party/protobuf` to build gRPC for Android. |
| |
| PREREQUISITES |
| ------------- |
| |
| - Android SDK |
| - Android NDK |
| - `protoc` and `grpc_cpp_plugin` binaries on the host system |
| |
| INSTALL |
| ------- |
| |
| The example application can be built via Android Studio or on the command line |
| using `gradle`: |
| |
| ```sh |
| $ ./gradlew installDebug |
| ``` |
| |
| INSTRUMENTATION TESTS |
| --------------------- |
| |
| The instrumentation tests can be run via the following `gradle` command. This |
| requires an emulator already running on your computer. |
| |
| ``` |
| $ ./gradlew connectedAndroidTest \ |
| -Pandroid.testInstrumentationRunnerArguments.server_host=grpc-test.sandbox.googleapis.com \ |
| -Pandroid.testInstrumentationRunnerArguments.server_port=443 \ |
| -Pandroid.testInstrumentationRunnerArguments.use_tls=true |
| ``` |
