{"id":9015,"date":"2012-06-11T16:39:02","date_gmt":"2012-06-11T14:39:02","guid":{"rendered":"http:\/\/www.devapp.it\/wordpress\/?p=9015"},"modified":"2012-09-10T11:58:51","modified_gmt":"2012-09-10T09:58:51","slug":"t110-come-implementare-le-push-notifications-con-easyapns","status":"publish","type":"post","link":"https:\/\/www.devapp.it\/wordpress\/t110-come-implementare-le-push-notifications-con-easyapns\/","title":{"rendered":"T#110 \u2013 Come implementare le Push Notifications con EasyAPNS"},"content":{"rendered":"

\"come-implementare-le-Push-Notifications-con-EasyAPNS-00\"<\/a> In questo nuovo tutorial faremo un re-make del #T016<\/a> dove avevamo gi\u00e0 trattato l’argomento di come implementare le Push Notification nelle nostre applicazioni iPhone e iPad<\/strong>. Questa nuova guida \u00e8 aggiornata su Xcode 4.3.2 e usa le librerie PHP EasyAPNS<\/strong>.<\/p>\n

Ringraziamo lo sviluppatore Gabriele Merlonghi<\/a>, creatore delle applicazioni, GPS Alarm Pro<\/a> e AskToMe!<\/a> (che potete trovare su App Store seguendo i link diretti) il quale ha scritto per noi questa utilissima guida.<\/p>\n

Come funzionano le notifiche push?<\/h4>\n

Ci sono 3 componenti essenziali su cui dovrete lavorare per far funzionare le notifiche push nella vostra applicazione iPhone:<\/p>\n

    \n
  1. I profili e certificati dell’applicazione, che hanno abilitata la funzione Push Notification<\/li>\n
  2. Un back-end su un vostro Web Server on line con PHP e MySQL<\/li>\n
  3. Alcuni metodi dedicati alle Push Notification all’interno dell’AppDelegate.m dell’applicazione<\/li>\n<\/ol>\n

    Il meccanismo delle notifiche push si basa sull’infrastruttura dell’Apple Push Notification Service<\/strong> che, nel corso del tutorial, chiameremo per comodit\u00e0 APNs<\/strong>. Esso consiste in un server di Apple denominato Push Notification Server (PNS) che fa da dispatcher di tutti i messaggi di notifica inviati a tutti i dispositivi iOS.
    \nL’APNs consente al dispositivo iOS dell’utente di restare continuamente connesso con il PNS utilizzando una connessione TCP\/IP.
    \nUna volta che il meccanismo \u00e8 funzionante, quando desideriamo inviare una notifica push alla nostra applicazione installata sul dispositivo dell’utente, dobbiamo contattare il servizio APNs di Apple affinch\u00e9 consegni il messaggio alla precisa applicazione installata sul dispositivo desiderato. <\/p>\n

    Per rendere funzionante il dialogo con l’Apple Push Notification service (APNs), il nostro compito \u00e8 di scrivere un’applicazione su un nostro server che faccia da provider delle notifiche push e che comunichi proprio con tale server Apple. La nostra applicazione provider invier\u00e0 il messaggio al server APNs, che a sua volta recapiter\u00e0 il messaggio, attraverso la connessione TCP\/IP, a tutti i dispositivi che hanno la nostra applicazione installata e che hanno dato il consenso alla ricezione delle notifiche.<\/p>\n


    \n    \"come-implementare-le-Push-Notifications-con-EasyAPNS-01\"<\/a>
    \n<\/center><\/p>\n

    Facendo riferimento alla figura sopra in modo molto sintetico i principali passaggi che dovranno verificarsi sono:<\/p>\n

      \n
    1. Sul terminale iOS dell’utente, quando verr\u00e0 lanciata l’app verr\u00e0 chiesto all’utente che questa intende inviargli delle notifiche. L’utente pu\u00f2 quindi accettare o rifiutare. Per andare avanti occorre ovviamente che accetti.<\/li>\n
    2. Dopo l’accettazione dell’utente di cui al punto 1, c’\u00e8 uno scambio di messaggi tra iOS e l’APNs, che decretano la creazione del token. Questo viene inviato (insieme ad altre info del device) al database gestito con EasyAPNs<\/strong> sul vostro server. In questo modo il dispositivo iOS viene censito dal vostro server.<\/li>\n
    3. Con le modalit\u00e0 e gli scopi che voi deciderete coerentemente con la vostra particolare App, il server si preoccuper\u00e0 di inviare al PNS una richiesta di messaggio di notifica verso uno o pi\u00f9 devices che sono censiti nel database di EasyAPNs.<\/li>\n
    4. Il PNS si preoccuper\u00e0 fisicamente di consegnare la notifica sul o sui terminali iOS di destinazione.<\/li>\n<\/ol>\n

      Step 1: Creazione dei Certificati e Profili<\/h4>\n

      Accedere all’iPhone Developer Program Portal ed andare nella sezione App IDs. Non \u00e8 possibile utilizzare un profilo con wild-card (ovvero con l’asterisco) per cui, se non avete gi\u00e0 un profilo senza wild-card, dovete crearne uno nuovo cliccando su “New App ID”. Il consiglio generale \u00e8 quello di usare un App ID distinto per ciascun’applicazione.<\/p>\n

      Dopo aver creato l’App ID, cliccate su Configure e create il certificato SSL seguendo la procedura guidata (molto semplice). Al termine del procedimento, scaricate il certificato appena creato (file con estensione .cer).<\/p>\n

      Ora dovete installare il certificato appena scaricato: doppio click su di esso e il certificato sar\u00e0 importato nel Portachiavi. Nel Portachiavi, andate nella categoria “I miei certificati” e noterete un certificato chiamato “Apple Development Push Services”. Cliccateci sopra col tasto destro del mouse e cliccate quindi su Esporta. Salvate il file con il nome apns-dev-cert.p12<\/strong>. Tornate al certificato “Apple Development Push Services” ed espandetelo cliccando sulla freccia grigia alla sua sinistra. Noterete una chiave, cliccateci sopra col tasto destro del mouse ed esportatela salvandola col nome apns-dev-key.p12<\/strong>.<\/p>\n

      Aprite il terminale e posizionatevi nella cartella dove avete esportato i file sopra citati. Date i seguenti comandi, uno dopo l’altro (inserendo la password e la passphrase dove richiesto):<\/p>\n

      \r\nopenssl pkcs12 -clcerts -nokeys -out apns-dev-cert.pem -in apns-dev-cert.p12\r\n \r\nopenssl pkcs12 -nocerts -out apns-dev-key.pem -in apns-dev-key.p12\r\n \r\nopenssl rsa -in apns-dev-key.pem -out apns-dev-key-noenc.pem\r\n \r\ncat apns-dev-cert.pem apns-dev-key-noenc.pem > apns-dev.pem\r\n<\/pre>\n
      Tra tutti i file generati, a voi interessa il file apns-dev.pem<\/strong>, che dovrete caricare sul vostro server APNs (non preoccupatevi, lo vedremo nello step successivo). L’installazione dei certificati \u00e8 terminata. <\/p>\n
      Ora dovete installare i profili. Tornate quindi nell’iPhone Developer Program Portal e andate nella sezione Provisioning. Create un nuovo profilo oppure (se esisteva gi\u00e0 prima) rigeneratelo per avere la funzione di Push Notification abilitata.<\/p>\n
      Per caricarlo su Xcode, con la versione 4.3.2, \u00e8 sufficiente andare nell’Organizer, poi sulla sezione Devices, quindi in Library -> Provisioning Profiles ed infine cliccare sull’icona sull’angolo in basso a destra di Refresh. Vi verranno chieste le credenziali di accesso dell’Apple ID di sviluppo che possedete ed automaticamente Xcode si sincronizzer\u00e0 con tutti profili definiti sul portale Apple.<\/p>\n
      Tutta questa procedura di creazione di certificati e profili va eseguita due volte: una per il development (per sviluppare e testate l’applicazione iOS) e l’altra per la distribution.<\/p>\n
      Step 2: Preparazione del Server con EasyAPNs<\/h4>\n
      Per utilizzare le Notifiche Push nella vostra applicazione, dovete disporre di un vostro server remoto sempre accessibile, nel quale memorizzare il token dei vari dispositivi degli utenti e che si preoccuper\u00e0 di comunicare con il PNS di Apple per inviare i messaggi che vorrete.<\/p>\n
      La scelta dell’Hosting<\/strong><\/p>\n
      Nelle mie prove ho utilizzato un Ubuntu Server domestico, ovviamente con Apache, PHP e MySQL installati, ma in produzione, ovviamente, occorre andare con un hosting apposito che dia delle garanzie di affidabilit\u00e0.<\/p>\n
      Ci sono tantissime soluzioni di hosting di tutti i tipi e per tutte le tasche, ma c’\u00e8 un requisito molto importante che occorre tenere in considerazione da subito nella scelta dell’hosting per un APNs, ovvero: che supporti SSL. Questa caratteristica \u00e8 richiesta dalla tipologia di connessione che occorre stabilire tra il server APNs e il PNS di Apple, che ovviamente \u00e8 imposta da Apple stessa per garantire ad utenti e sviluppatori il corretto grado di sicurezza per un servizio di questo genere.<\/p>\n
      Ho fatto un piccolo scouting di hosting gratuiti attraverso il motore di ricerca FreeHosting<\/a>, a questo link<\/a> trovate i risultati filtrati con il supporto a PHP, MySQL e SSL.<\/p>\n
      Fate molta attenzione a quest’aspetto, perch\u00e9 su moltissimi servizi di hosting anche commerciali il supporto SSL non \u00e8 affatto scontato, anzi in base alle mie ricerche \u00e8 una caratteristica rara.<\/p>\n
      Nel momento in cui questo tutorial \u00e8 stato scritto, sembrerebbe che FreeHostingNoAds<\/a> sia una possibile soluzione gratuita per ospitare un servizio APNs. Considerate che questa segnalazione non vuole avere uno scopo di soluzione assoluta, ciascun sviluppatore dovrebbe ricercare il corretto servizio di hosting in base alle proprie esigenze. Se possedete gi\u00e0 un dominio, prima di tutto fate una verifica se avete gi\u00e0 i requisiti necessari per APNs (che vi ricordo, sono il supporto a PHP, MySQL e SSL), in questo modo potrete utilizzare l’infrastruttura di hosting, che magari gi\u00e0 pagate senza dover fare nuove spese.<\/p>\n
      La scelta di EasyAPNs e la sua personalizzazione<\/strong><\/p>\n
      A differenza di altre soluzioni open source EasyAPNs risalta per due punti che ritengo importanti:<\/p>\n
        \n
      1. E’ ben documentata e quindi facilmente personalizzabile.<\/li>\n
      2. Integra gi\u00e0 una soluzione di database per i dispositivi che si registrano alle notifiche.<\/li>\n<\/ol>\n
        Una volta terminati gli steps previsti da questo tutorial, l’unica cosa che rimane a carico dello sviluppatore \u00e8 quella di preoccuparsi di come triggerare il messaggio di notifica e su quali dispositivi (se a tutti o su alcuni in particolare) che ovviamente dipende moltissimo dalla natura dell’applicazione iOS specifica.<\/p>\n
        EasyAPNs pu\u00f2 essere scaricato direttamente dal repository su GitHub<\/a>.<\/p>\n
        Nel momento in cui questo tutorial \u00e8 stato scritto, sono state trovate delle differenze tra i sorgenti online e la documentazione presente sul portale web http:\/\/www.easyapns.com<\/a> anche per questo motivo \u00e8 nato questo tutorial. Mi riferisco in particolare alla parte di codice Objective-C che vedremo sullo step successivo.<\/p>\n
        Ora concentriamoci sulla messa in opera del server ovvero sulla creazione del database de sulla parametrizzazione dei sorgenti in PHP.<\/p>\n
        Nelle sezioni seguenti, si d\u00e0 per scontato sul server siano operativi i seguenti servizi:<\/p>\n