doc/settings.txt in rhoconnect-3.0.4 vs doc/settings.txt in rhoconnect-3.0.5
- old
+ new
@@ -21,9 +21,30 @@
This setting is used as a default if source doesn't specify
its own value. Also, it is applied to dynamic adapters
as a default sync poll interval.
:bulk_data_poll_interval: <secs> - poll interval setting for bulk data sync
+ :c2dm_username: <google's email>
+ :c2dm_passwd: <passwd>
+ :authtoken: <authtoken> - these settings are used specifically for Android push notifications.
+ 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.
+ This approach, however, will not allow the server to connect
+ to the C2DM service and renew the token once it is expired.
+
## Source settings
All source-specific settings are specified under the corresponding source name entry in the `:sources` category.
Typical source settings include:
\ No newline at end of file