aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/android/test/interop/README.md
diff options
context:
space:
mode:
authorGravatar Eric Gribkoff <ericgribkoff@google.com>2018-04-03 16:21:37 -0700
committerGravatar Eric Gribkoff <ericgribkoff@google.com>2018-04-05 11:39:54 -0700
commitf9fb3ebf1f136490bf6bffcdfed1b71594a34950 (patch)
tree493b3d17c806146a09bd72c167515db1163e8b4b /src/android/test/interop/README.md
parent5a03bdb62209ac81e813b1b5ff5ff4aafbca42f4 (diff)
gRPC C++ Interop App
Diffstat (limited to 'src/android/test/interop/README.md')
-rw-r--r--src/android/test/interop/README.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/src/android/test/interop/README.md b/src/android/test/interop/README.md
new file mode 100644
index 0000000000..95262307eb
--- /dev/null
+++ b/src/android/test/interop/README.md
@@ -0,0 +1,37 @@
+gRPC on Android
+==============
+
+Note: Building the protobuf dependency for Android requires
+https://github.com/google/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
+```