{"id":4039,"date":"2012-12-16T08:21:43","date_gmt":"2012-12-16T04:21:43","guid":{"rendered":"http:\/\/blog.denivip.ru\/?p=4039"},"modified":"2013-08-05T14:10:35","modified_gmt":"2013-08-05T10:10:35","slug":"how-to-use-google-cloud-messaging-in-adobe-air-applications","status":"publish","type":"post","link":"http:\/\/blog.denivip.ru\/index.php\/2012\/12\/how-to-use-google-cloud-messaging-in-adobe-air-applications\/?lang=en","title":{"rendered":"How to Use Google Cloud Messaging in Adobe AIR Applications"},"content":{"rendered":"

\"Using<\/center><\/p>\n

However nice the multi-platform nature of AIR is, still it is a double-edged sword. On the one hand, we can write a Flex or ActionScript application that would work correctly on all possible platforms supported by AIR. On the other hand, developers feel much restricted by that AIR sometimes fails to provide all tools to fully use the functionality unique to a particular platform or device. Fortunately, we can write native extensions for a particular platform to implement features specific to this environment only. Such extensions are called Native Extensions and are attached to the AIR project as external libraries. <\/p>\n

In our work, we often use such extensions. Here we are going to discuss the as3c2dm extension developed by Piotr Walczyszyn<\/a>. It allows you to receive push-messages and display them in the notification bar. In our work, we are actively using the extension. As we have detected a number of errors and inconveniences in it, we have tried to correct them. <\/p>\n

The main error that we have faced is invalid application icon in the system tray if the application was built using captive runtime package. We often build applications so as to be able to install and use them on devices that do not have Adobe AIR. We have corrected this error.<\/p>\n

With our update, the extension also allows you to split the logic of push-messages and their display in the notification bar. This way you can avoid displaying notifications each time a push-message arrives and do it later, whenever needed. Please feel free to use our update on github.<\/a><\/p>\n

Adding Extension to the Project<\/h3>\n

To use push-messages in the application project, connect c2dm.ane (Project Properties \u2192 Flex Build Path \u2192 «Native Extensions» tab \u2192 «Add ANE …» button).<\/p>\n

Next, in the XML file describing the application, among other things, specify:<\/p>\n

<!\u2014 TODO: \u0417\u0430\u043c\u0435\u043d\u0438\u0442\u044c \u0432\u0435\u0437\u0434\u0435 \u0433\u0434\u0435 \u0434\u0430\u043b\u0435\u0435 \u0432\u0441\u0442\u0440\u0435\u0447\u0430\u0435\u0442\u0441\u044f ru.myDomain.myAppName \u0438\u0434\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0442\u043e\u0440\u043e\u043c \u0412\u0430\u0448\u0435\u0433\u043e \u043f\u0440\u0438\u043b\u043e\u0436\u0435\u043d\u0438\u044f, \u043d\u0435 \u0437\u0430\u0431\u044b\u0432\u0430\u044f \u0434\u043e\u0431\u0430\u0432\u0438\u0442\u044c \u043f\u0440\u0435\u0444\u0438\u043a\u0441 \u201cair\u201d. --><\/span><\/span>
\n<id><\/span><\/span><\/span>ru.myDomain.myAppName<\/id><\/span><\/span><\/span>
\n<android><\/span><\/span><\/span>
\n    <manifestAdditions><\/span><\/span><\/span><![CDATA[<\/span>
\n        <manifest android:installLocation="auto"><\/span>
\n            <permission android:protectionLevel="signature" android:name="air. ru.myDomain.myAppName.permission.C2D_MESSAGE" \/><\/span>
\n            <uses-permission android:name="air.ru.myDomain.myAppName.permission.C2D_MESSAGE" \/><\/span>
\n            <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" \/><\/span>
\n
\n            <application android:hardwareAccelerated="true"><\/span>
\n                <receiver android:name="com.riaspace.c2dm.C2DMBroadcastReceiver" android:permission="com.google.android.c2dm.permission.SEND"><\/span>
\n                    <intent-filter><\/span>
\n                        <action android:name="com.google.android.c2dm.intent.RECEIVE" \/><\/span>
\n                        <category android:name="air.ru.myDomain.myAppName" \/><\/span>
\n                    <\/intent-filter><\/span>
\n                    <intent-filter><\/span>
\n                        <action android:name="com.google.android.c2dm.intent.REGISTRATION" \/><\/span>
\n                        <category android:name="air.ru.myDomain.myAppName" \/><\/span>
\n                    <\/intent-filter><\/span>
\n                <\/receiver><\/span>
\n            <\/application><\/span>
\n        <\/manifest> <\/span>
\n    ]]><\/span><\/manifestAdditions><\/span><\/span><\/span>
\n<\/android><\/span><\/span><\/span>
\n<extensions><\/span><\/span><\/span>
\n    <extensionID><\/span><\/span><\/span>com.riaspace.c2dm<\/extensionID><\/span><\/span><\/span>
\n<\/extensions><\/span><\/span><\/span><\/div><\/div>\n

And, naturally, you’ll need to add relevant code to the application. We are going to discuss this below.<\/p>\n

Automatic Notification Display<\/h3>\n

We have decided to also leave the old functionality that automatically displays a message in the notification bar. By default, this functionality is disabled. To enable it, call enableAutoNotify()<\/span><\/code> from the C2DM<\/span><\/code> class:<\/p>\n

1
2
<\/div><\/td>
var<\/span> c2dm:<\/span>C2DM = new<\/span>  C2DM(<\/span>)<\/span>;<\/span>
\nc2dm.<\/span>enableAutoNotify(<\/span>)<\/span>;<\/span><\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

To disable automatic notification display, the disableAutoNotify()<\/span><\/code> method is used:<\/p>\n

1
<\/div><\/td>
c2dm.<\/span>disableAutoNotify(<\/span>)<\/span>;<\/span><\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

When automatic notification display is disabled, the application should receive an event notifying it of a push-message received, and, by analyzing its parameters, be able to make a decision on what to do next: show a notification to the user, ignore it, show a popup, etc.<\/p>\n

Required Fields on Sending Push Messages<\/h3>\n

To run the extension properly, the data object shall be passed with valid property names.<\/p>\n

For automatic notifications, Piotr Walczyszyn has provided the following data fields:<\/p>\n