Compatibility documentation

[hypesystem]

We are getting a lot of questions, recently, that boil down to compatiblitiy: which client library is used, which things work with that library, etc.

We should consider writing something about compatibility, at least a section saying which client-sides we can verify as working.

[eladnava]

@hypesystem GCM client libraries? E.g. iOS/Android/Cordova/PhoneGap?

[hypesystem]

Exactly. Especially Cordova and PhoneGap seem problematic.

[eladnava]

@hypesystem Here's what I've gathered so far about compatibility issues as of 11/12/2015:

Phonegap / Cordova (phonegap-push-plugin)

• No support for subscribing to topics (GCM PubSub)
• Must supply data object if sending a notification
• Requirement for all 3 notification fields to be sent
• Requires the title to be inside the notification object and the message to be set in the data object (Fixed in 1.2.1)

Couldn't find any issues for Ionic, though. I searched through all the issues and this is all that I found. Anything else you know about that I missed?

[hypesystem]

I think that pretty much covers it. I don't remember seeing any specific issues with Ionic.

I don't honestly know what the best way to document these things would be --- no matter what we would risk getting out of date very quickly, if we write something like "phonegap-push does not currently support topic subscription or using the notification field".

[eladnava]

@hypesystem Absolutely no problem there, we can just write it this way:

As of the 1st of January, 2016, {fill-in-issue-here-with-hyperlink}

I'm thinking about adding it to the README.md, below Custom GCM request options.

[hypesystem]

Sure! Sounds good :smile:

[eladnava]

@hypesystem Submitted PR =)