• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1gRPC on Android
2==============
3
4Note: Building the protobuf dependency for Android requires
5https://github.com/google/protobuf/pull/3878. This fix will be in the next
6protobuf release, but until then must be manually patched in to
7`third_party/protobuf` to build gRPC for Android.
8
9PREREQUISITES
10-------------
11
12- Android SDK
13- Android NDK
14- `protoc` and `grpc_cpp_plugin` binaries on the host system
15
16INSTALL
17-------
18
19The example application can be built via Android Studio or on the command line
20using `gradle`:
21
22  ```sh
23  $ ./gradlew installDebug
24  ```
25
26INSTRUMENTATION TESTS
27---------------------
28
29The instrumentation tests can be run via the following `gradle` command. This
30requires an emulator already running on your computer.
31
32```
33$ ./gradlew connectedAndroidTest \
34  -Pandroid.testInstrumentationRunnerArguments.server_host=grpc-test.sandbox.googleapis.com \
35  -Pandroid.testInstrumentationRunnerArguments.server_port=443 \
36  -Pandroid.testInstrumentationRunnerArguments.use_tls=true
37```
38