blob: 3531fa192867693455ef0caa92cfdc898ae80bb2 [file] [log] [blame]
glaznev@webrtc.orge8152902015-03-23 22:35:14 +00001This directory contains an example Android client for https://apprtc.appspot.com
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002
3Prerequisites:
glaznev@webrtc.orge8152902015-03-23 22:35:14 +00004- "Getting the code" on http://www.webrtc.org/native-code/android
henrike@webrtc.org28e20752013-07-10 00:45:36 +00005- Set up webrtc-related GYP variables:
glaznev@webrtc.orge8152902015-03-23 22:35:14 +00006 export GYP_DEFINES="build_with_libjingle=1 build_with_chromium=0 libjingle_java=1
7 OS=android $GYP_DEFINES"
henrike@webrtc.org28e20752013-07-10 00:45:36 +00008 To cause WEBRTC_LOGGING to emit to Android's logcat, add enable_tracing=1 to
9 the $GYP_DEFINES above.
10- When targeting both desktop & android, make sure to use a different output_dir
glaznev@webrtc.orge8152902015-03-23 22:35:14 +000011 value in $GYP_GENERATOR_FLAGS - for example
12 export GYP_GENERATOR_FLAGS="$GYP_GENERATOR_FLAGS output_dir=out_android"
13 or you'll likely end up with mismatched ARM & x86 output artifacts.
14 If you use an output_dir other than out/ make sure to modify the command-lines
15 below appropriately.
henrike@webrtc.org28e20752013-07-10 00:45:36 +000016- Finally, run "gclient runhooks" to generate Android-targeting .ninja files.
17
18Example of building & using the app:
19
glaznev@webrtc.org8390c272015-01-02 19:51:12 +000020cd <path/to/webrtc>/src
henrike@webrtc.org28e20752013-07-10 00:45:36 +000021ninja -C out/Debug AppRTCDemo
glaznev@webrtc.orge8152902015-03-23 22:35:14 +000022adb install -r out/Debug/apks/AppRTCDemo.apk
henrike@webrtc.org28e20752013-07-10 00:45:36 +000023
jiayl@webrtc.org16a05dd2014-12-18 20:12:03 +000024In desktop chrome, navigate to https://apprtc.appspot.com and note the r=<NNN> room
25this redirects to or navigate directly to https://apprtc.appspot.com/r/<NNN> with
glaznev@webrtc.org4b407aa2014-12-04 22:42:59 +000026your own room number. Launch AppRTC on the device and add same <NNN> into the room name list.
henrike@webrtc.org28e20752013-07-10 00:45:36 +000027
glaznev@webrtc.org4b407aa2014-12-04 22:42:59 +000028You can also run application from a command line to connect to the first room in a list:
29adb shell am start -n org.appspot.apprtc/.ConnectActivity -a android.intent.action.VIEW
30This should result in the app launching on Android and connecting to the 3-dot-apprtc
henrike@webrtc.org28e20752013-07-10 00:45:36 +000031page displayed in the desktop browser.
glaznev@webrtc.org4b407aa2014-12-04 22:42:59 +000032To run loopback test execute following command:
33adb shell am start -n org.appspot.apprtc/.ConnectActivity -a android.intent.action.VIEW --ez "org.appspot.apprtc.LOOPBACK" true
henrike@webrtc.org28e20752013-07-10 00:45:36 +000034