
This method returns a promise object that is used to retrieve the registration
token. On iOS it is a hex string, while on Android it is raw string
value retrieved from GCM servers.
If the user denies showing notifications for the app, a NotificationPermissionError error
is returned.