Apple Push Notification Service Tutorial

Apple Push Notification Service (APNS) an service user by apple to
notify application. The notification can be of various Text Alert with
or without sound, Baggage number update on icon etc.

Below are the steps to construct an simple application that receives
notification form APNS.

The steps are for development testing on sandbox APNS service from
Apple

Getting Ready with
Certificate and key.

Generate a certificate signing request from your Mac’s keychain and
save to disk.(Steps same as creating certificate for development but
don’t submit not).


Pleas store this certificate in a safe location
as it might be re-required to invoke APNS.

Login into your development account and visit iPhone Developer
Program Portal.

Click App IDs on left. Create an new id without wild charter
(com.mydomain.applicationName). This name will be used while setting up
your application to be signed with development certificate. If you use
wild character like ‘*’ the iPhone Developer Program Portal will not
allow the App ID to be used for notification.

After submitting the new App ID you will be guided to the list page.
Click configure to edit setting. Check ‘Enable for Apple Push
Notification service’ to enable APNS , and click Configure next to
‘Development Push SSL Certificate’.

Upload your request certificate generated in step 1 and download the
certificate (aps_developer_identity.cer) from the Program Portal


. Double click on this certificate to save it
your key chain. Export this key by clicking on this newly installed
certificate. The exported key is saved as Certificate.p12 file on your
system. Please store it other files uploaded or downloaded from portal
program. This .p12 file is used in later steps for signing your Provider
server.

Click on Provisioning in left bar and create a new provisioning
profile. Use the new created App Id and select the device you want to
use for development. Download the new provisioning profile save with
other files. Close XCode if open and drag drop new provisioning profile
on your XCode in your Doc bar.Your ready with certificate and key.

Getting ready with
the application

Create an simple view based application.

Paste these line of code in your application.

- (void)applicationDidFinishLaunching:(UIApplication *)app {

// other setup tasks here….

[window
addSubview:viewController.view];

[self alertNotice:@""
withMSG:@"Initiating Remote Noticationss Are Active"
cancleButtonTitle:@"Ok" otherButtonTitle:@""];

[[UIApplication
sharedApplication]
registerForRemoteNotificationTypes:(UIRemoteNotificationTypeAlert |
UIRemoteNotificationTypeBadge |UIRemoteNotificationTypeSound)];

}

-
(void)application:(UIApplication *)app
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {

//NSLog(@”devToken=%@”,deviceToken);

[self alertNotice:@""
withMSG:[NSString stringWithFormat:@"devToken=%@",deviceToken]
cancleButtonTitle:@”Ok” otherButtonTitle:@”"];

}

-
(void)application:(UIApplication *)app
didFailToRegisterForRemoteNotificationsWithError:(NSError *)err {

NSLog(@”Error in registration.
Error: %@”, err);

[self alertNotice:@""
withMSG:[NSString stringWithFormat:@"Error in registration. Error: %@",
err] cancleButtonTitle:@”Ok” otherButtonTitle:@”"];

}

-(void)alertNotice:(NSString
*)title withMSG:(NSString *)msg cancleButtonTitle:(NSString
*)cancleTitle otherButtonTitle:(NSString *)otherTitle{

UIAlertView *alert;

if([otherTitle
isEqualToString:@""])

alert = [[UIAlertView
alloc] initWithTitle:title message:msg delegate:self
cancelButtonTitle:cancleTitle otherButtonTitles:nil,nil];

else

alert = [[UIAlertView alloc]
initWithTitle:title message:msg delegate:self
cancelButtonTitle:cancleTitle otherButtonTitles:otherTitle,nil];

[alert show];

[alert release];

}

Please be careful with the error reporting part in the code as error
tell a lot about the development state.

Right click on the application in target in the left and click Get
Info to configure the application. Click on property tab and paste your
App ID in the identifier text-field.

Click build tab, select debug and select your new provisioning
profile.

Click Device 3.0 and Build Go to distribute binary to your connected
device.

Starting the application it should first alert and message that it
registering for notification. Followed by and alert the application is
registering for notification allow or deny. Followed by an alert that
displays the device token ID. Note this token as this will be used by
your server code to communicate with your device. If the second message
is error then either something has gone wrong with the certificate and
your application cannot register your certificate start over again.

Getting ready with
Notification service provider.

Download an stand alone MAC application (PushMeBaby
http://stefan.hafeneger.name/download/PushMeBabySource.zip
)
to test. There are two modification in the application to get started.

Place an copy of the aps_developer_identity.p12 file in the application
folder. Import the file in the application by right clicking and Add
> Existing File.

Set the following in the application’s delegate file as shown below

self.deviceToken = @”XXXXX XXXXX XXXXX XXXXXX XXXXXX”;

//First your device id token.

self.payload = @”{/”aps/” : {
/”alert/” : /”You got your emails./”,/”badge/” : 9,/”sound/” :
/”bingbong.aiff/”},/”acme1/” : /”bar/”,/”acme2/” : 42}”;

//The pay load

self.certificate = [[NSBundle
mainBundle] pathForResource:@”aps_developer_identity” ofType:@”cer”];
//The certificate file.

Don’t depend on the application’s text-field as it doesn’t work.

Start the application and you will get a message the application is
trying to access your key , click ‘Allow’. Click Push in the application
window. Wait for a 20 seconds and you should immediately get an
notification on your iPhone / iTouch.

Getting
ready with test code for actual provider sever (PHP).

For server on linux environment you will require different kind of
certificate. Following are the steps to create it. Use MAC console to
fire the following commands.

openssl pkcs12 -clcerts -nokeys -out cert.pem -in
Certificate.p12

provide new password if asked.

openssl pkcs12 -nocerts -out key.pem -in Certificate.p12

provide new password if asked.

cat cert.pem key.unencrypted.pem > ck.pem

Create an PHP file provide.php

$message);

if ($badge)

$body['aps']['badge'] = $badge;

if ($sound)

$body['aps']['sound'] = $sound;

/* End of Configurable Items */

$ctx = stream_context_create();

stream_context_set_option($ctx,
‘ssl’, ‘local_cert’, ‘ck.pem’);

// assume the private key
passphase was removed.

//
stream_context_set_option($ctx, ‘ssl’, ‘passphrase’, $pass);

$fp =
stream_socket_client(‘ssl://gateway.sandbox.push.apple.com:2195′, $err,
$errstr, 60, STREAM_CLIENT_CONNECT, $ctx);

if (!$fp) {

print “Failed to connect $err
$errstrn”;

return;

}

else {

print “Connection OKn”;

}

$payload = json_encode($body);

$msg = chr(0) . pack(“n”,32) .
pack(‘H*’, str_replace(‘ ‘, ”, $deviceToken)) .
pack(“n”,strlen($payload)) . $payload;

print “sending message :” .
$payload . “n”;

fwrite($fp, $msg);

fclose($fp);

?>

Note :
Your PHP server must
have json_encode support.

Run your file on linux console as ‘php provide.php’

For more information refer http://www.macoscoders.com/2009/05/17/iphone-apple-push-notification-service-apns/

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

http://ameyashetti.wordpress.com/2009/07/31/apple-push-notification-service-tutorial/