History

Eric Anderson c38611a230 Bump protobuf to 3.1.0 Also removed warnings about protoc version matching runtime, since this is no longer supposed to be a problem (starting with 3.0.0-beta-4) and all our tests ran fine when using protoc 3.0.2 with protobuf runtime 3.1.0. Fixes #2316		2016-11-01 14:52:56 -07:00
..
app	Bump protobuf to 3.1.0	2016-11-01 14:52:56 -07:00
README.md	Updates the README.md to add instructions to start test server.	2015-12-28 17:10:43 -08:00
build.gradle	build: upgrade to protobuf-gradle-plugin 0.8.0	2016-08-18 13:06:18 -07:00
settings.gradle	Add the Android interop test App.	2015-06-26 15:31:14 -07:00
start-emulator.sh	Add the Android interop test App.	2015-06-26 15:31:14 -07:00
wait-for-emulator.sh	Add the Android interop test App.	2015-06-26 15:31:14 -07:00

README.md

gRPC Android test App

Implements gRPC integration tests in an Android App.

TODO(madongfly) integrate this App into the gRPC-Java build system.

In order to build this app, you need a local.properties file under this directory which specifies the location of your android sdk:

sdk.dir=/somepath/somepath/sdk

Connect your Android device or start the emulator:

$ ./start-emulator.sh <AVD name> & ./wait-for-emulator.sh

Start test server

Start the test server by:

$ ../run-test-server.sh

Manually test

Install the App by:

$ ../gradlew installDebug

Then manually test it with the UI.

Commandline test

Run the test with arguments:

$ adb shell am instrument -w -e server_host <hostname or ip address> -e server_port <port> -e server_host_override foo.test.google.fr -e use_tls true -e use_test_ca true -e test_case all io.grpc.android.integrationtest/.TesterInstrumentation

If the test passed successfully, it will output:

INSTRUMENTATION_RESULT: grpc test result=Succeed!!!
INSTRUMENTATION_CODE: 0

otherwise, output something like:

INSTRUMENTATION_RESULT: grpc test result=Failed... : <exception stacktrace if applicable>
INSTRUMENTATION_CODE: 1