aboutsummaryrefslogtreecommitdiffhomepage
path: root/src
diff options
context:
space:
mode:
authorGravatar Jorge Canizales <jcanizales@google.com>2016-06-29 17:09:11 -0700
committerGravatar Jorge Canizales <jcanizales@google.com>2016-06-29 17:09:11 -0700
commit28820575ff722d3332cebcae11d2b77d5be67316 (patch)
tree7f3d2f5abb9fd648eb94ff1c3fc67f40c308eaa0 /src
parent10cc76cbe7f4a717e5da800837ee9d69144684f1 (diff)
Add README.md explaining use of the app
Diffstat (limited to 'src')
-rw-r--r--src/objective-c/tests/Connectivity/README.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/src/objective-c/tests/Connectivity/README.md b/src/objective-c/tests/Connectivity/README.md
new file mode 100644
index 0000000000..851cb9d1da
--- /dev/null
+++ b/src/objective-c/tests/Connectivity/README.md
@@ -0,0 +1,16 @@
+This app can be used to manually test gRPC under changing network conditions.
+
+It makes RPCs in a loop, logging when the request is sent and the response is received.
+
+To test on the simulator, run `pod install`, open the workspace created by Cocoapods, and run the app.
+Once running, disable WiFi (or ethernet) _in your computer_, then enable it again after a while. Don't
+bother with the simulator's WiFi or cell settings, as they have no effect: Simulator apps are just Mac
+apps running within the simulator UI.
+
+The expected result is to never see a "hanged" RPC: success or failure should happen almost immediately
+after sending the request. Symptom of a hanged RPC is a log like the following being the last in your
+console:
+
+```
+2016-06-29 16:51:29.443 ConnectivityTestingApp[73129:3567949] Sending request.
+```