doc/push.txt in rhoconnect-3.0.4 vs doc/push.txt in rhoconnect-3.0.5

- old
+ new

@@ -42,12 +42,20 @@ :::yaml :development: :redis: localhost:6379 :syncserver: http://localhost:9292/application/ :licensefile: settings/license.key + :c2dm_username: username + :c2dm_passwd: passwd :authtoken: authtoken -Replace `:authtoken:` value with actual authentication token. This token MUST be related to the role-based google account registered for your application. See [the rhodes push instructions](/rhodes/device-caps#push-notifications) for more details. To retrieve this token, use sample script [c2dm.rb](http://github.com/rhomobile/rhodes/blob/master/bin/c2dm.rb). Uncomment last two lines and put your google account specific data, then run it. It will print token to stdout. +In order to push messages to the Android device, your server needs to obtain Google's C2DM authentication token associated with the trusted google account. +For this purpose, you can specify C2DM Google account's username/password combo via the `:c2dm_username` and `:c2dm_passwd` settings. +At run-time, the system will use these credentials to obtain the C2DM token and store it in the Redis for the future use. +Once the token is expired, the system will automatically connect to the Google C2DM service to renew the token. + +Alternatively, you can use `:authtoken` setting to specify the pre-defined authentication token. This token MUST be related to the role-based google account registered for your application. See [the rhodes push instructions](/rhodes/device-caps#push-notifications) for more details. To retrieve this token, use sample script [c2dm.rb](http://github.com/rhomobile/rhodes/blob/master/bin/c2dm.rb). Uncomment last two lines and put your google account specific data, then run it. It will print token to stdout. +However, this approach will not allow the server to connect to the C2DM service and renew the token once it is expired. For those who interested in what this token means, the description is [here](http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html). Now start up your RhoConnect application and setup [push notifications](/rhodes/device-caps#push-notifications) in your Rhodes application. \ No newline at end of file