{"id":7046,"date":"2011-06-13T12:03:22","date_gmt":"2011-06-13T10:03:22","guid":{"rendered":"http:\/\/www.devapp.it\/wordpress\/?p=7046"},"modified":"2011-06-13T12:03:22","modified_gmt":"2011-06-13T10:03:22","slug":"t095-creare-url-schemes-personalizzati-per-le-nostre-applicazioni-iphone-e-ipad","status":"publish","type":"post","link":"https:\/\/www.devapp.it\/wordpress\/t095-creare-url-schemes-personalizzati-per-le-nostre-applicazioni-iphone-e-ipad\/","title":{"rendered":"T#095 – Creare URL Schemes personalizzati per le nostre applicazioni iPhone e iPad"},"content":{"rendered":"

Ciao a tutti e benvenuti in questo nuovo appuntamento della nostra rubrica “Tutorial Pratici di programmazione iPhone e iPad”. Oggi voglio parlarvi di un argomento molto interessante e di cui si sente parlare davvero poco in giro: gli URL Schemes<\/strong>!<\/p>\n

Vi siete mai chiesti come fanno alcune applicazioni ad avere la funzione “Apri in Safari” usata ad esempio per aprire una pagina web nel browser nativo dei nostri iDevices o come fanno i link video ad aprire direttamente l’app YouTube o ancora come si fa a passare un indirizzo all’applicazione Mappe? In questo tutorial vedremo proprio com’\u00e8 possibile che tutto ci\u00f2 accada grazie agli URL Schemes, ma non solo: impareremo a creare il nostro URL Scheme personalizzato, che useremo per far aprire la nostra applicazione allo stesso modo degli esempi citati.<\/p>\n

Introduzione agli URL Schemes<\/h4>\n

Sveliamo il primo mistero: come si fa ad aprire Safari o un’altra applicazione sul nostro iPhone o iPad!
\nDalla nostra applicazione, come accennato, possiamo far in modo di aprire le applicazioni native Mail, Safari, Telefono, Messaggi e Mappe semplicemente inviando un’istruzione del tipo:<\/p>\n

\r\n[[UIApplication sharedApplication] openURL:url].\r\n<\/pre>\n
La variabile url<\/em> che ho usato nell’istruzione sopra non \u00e8 altro che uno schema per gli indirizzi URL. Questo funziona come un vero e proprio indirizzo web (mentre non lo \u00e8 di per se). Vediamo qualche esempio.<\/p>\n
Quando la nostra variabile sar\u00f2 del tipo:<\/p>\n
\r\n[NSURL urlWithString:@\"http:\/\/devapp.it\"]\r\n<\/pre>\n
Si aprir\u00e0 l’applicazione nativa Safari caricando la pagina del sito web cui la stringa che compone l’URL fa riferimento;<\/p>\n
Se invece il nostro URL \u00e8 del tipo:<\/p>\n
\r\n[NSURL urlWithString:@\"mailto:indirizzo@devapp.it\"]\r\n<\/pre>\n
si aprir\u00e0 l’app Mail e un nuovo messaggio verr\u00e0 creato inserendo indirizzo@devapp.it<\/em> tra i destinatari dell’e-mail. Quindi non solo apriamo un’applicazione nativa, ma passiamo ad essa alcuni parametri, senza i quali questa funzionalit\u00e0 perderebbe la sua “magia”. Allo stesso modo si comportano le altre applicazioni quando riconoscono un URL a loro noto.<\/p>\n
Ma come fanno a sapere che devono aprirsi e cosa devono presentare una volta aperte?<\/p>\n
Apple mette a disposizione degli sviluppatori molte APIs. Tra queste c’\u00e8 n’\u00e8 una in grado di riconoscere le richieste di apertura di indirizzi URL tramite il messaggio [[UIApplication sharedApplication] openURL:url]<\/strong> e, nel caso in cui l’indirizzo combaci con la serie di URL Schemes impostati in un’applicazione, apre quell’applicazione.<\/p>\n
La nostra app, poi, ricever\u00e0 la chiamata alla funzione booleana “handleOpenURL” che si occupa di gestire l’apertura dell’app. Cosa viene fatto durante l’apertura dell’app \u00e8 quindi gestito da questo metodo secondo il tipo di schema riconosciuto.<\/p>\n
Anche Safari, quando digitate un indirizzo, manda quel messaggio, infatti, se provate a scrivere nel campo “indirizzo” di Safari per iPhone “tel:1-408-555-5555<\/em>“, l’applicazione nativa Telefono si aprir\u00e0 con il numero inserito nell’indirizzo pre-impostato per voi. Stesso discorso vale per tutte le app e i loro indirizzi URL.<\/p>\n
Cosa sono allora questi schemi?<\/p>\n
In pratica si tratta di una sorta di modello per un URL, se avete notato, nella pratica, ogni indirizzo mostrato negli esempi sopra ha una sua struttura, questa \u00e8 rappresentata da uno schema specifico. Un indirizzo modello, quindi, sar\u00e0 del tipo:<\/p>\n
urlScheme:\/\/identifier?query#fragment<\/em><\/p>\n
dove i campi urlScheme<\/em> e identifier<\/em> sono indispensabili al funzionamento dell’indirizzo, mentre i campi query<\/em> (ricerca) e fragment<\/em> (meglio interpretato come “sezione”, secondo me) sono opzionali.<\/p>\n
Per maggiori informazioni sugli URL Schemes potete visitare questa pagina su Wikipedia<\/a> (purtroppo non \u00e8 disponibile in versione italiana).<\/p>\n
URL Scheme personalizzati<\/h4>\n
Ma veniamo alla parte pi\u00f9 bella! Apple permette a tutti gli sviluppatori di creare URL Scheme personalizzati per le proprie esigenze!<\/p>\n
Molte app, infatti, ne hanno uno. Se avete l’app ufficiale di Twitter per iOS installata sul vostro iPhone, iPod Touch o iPad, ad esempio, e provate a inserire in Safari l’indirizzo twitter:\/\/user?screen_name=gtranchedone<\/em>, si aprir\u00e0 la pagina del mio profilo Twitter direttamente nell’applicazione Twitter ufficiale.<\/p>\n
Ma quali sono i vantaggi derivanti dall’utilizzo degli URL Schemes?<\/p>\n
Innanzitutto avere la possibilit\u00e0 di aprire altre applicazioni dall’interno della nostra offre moltissime occasioni per integrare nuovi servizi da offrire ai nostri utenti. Ci\u00f2 non solo render\u00e0 la nostra app pi\u00f9 utile ma migliorer\u00e0 anche l’esperienza di chi la usa. Offrire questo tipo di integrazione \u00e8, secondo me, una delle possibilit\u00e0 meno sfruttate nello sviluppo di app per iOS. L’unica “controindicazione” che si riceve dall’aprire app di terze parti \u00e8 che l’utente \u00e8 costretto a uscire dalla vostra. A tal proposito occorre per\u00f2 fare alcune osservazioni:<\/p>\n
    \n
  1. non tutte le app sono pensate per essere usate per un lungo periodo di tempo continuato, specialmente in ambiente mobile (pensiamo a un’app per creare tasks come Things della Cutured Code o un’app che serva da dizionario bilingue);<\/li>\n
  2. dobbiamo integrare app che effettivamente possano essere utili ai nostri utenti e valutare se e quando sia opportuno permettere all’utente di aprire queste applicazioni;<\/li>\n
  3. se prendiamo ad esempio l’app ToDo di Appigo, che offre un’ottima API per l’integrazione con app di terze parti, questa \u00e8 costruita in modo tale da permettere di specificare lo URL Scheme della propria app quando le mandiamo una richiesta di apertura, permettendo all’utente di tornare alla nostra app una volta che ha finito di utilizzare ToDo. Perch\u00e9 non fare lo stesso con le nostre applicazioni? \ud83d\ude09<\/li>\n<\/ol>\n
    Pensate inoltre al vantaggio di avere la nostra applicazione pubblicizzata, ad esempio, all’interno di altre applicazioni che ne integrano i servizi! Per gli utenti sarebbe molto pi\u00f9 facile scoprire la nostra applicazione e\/o essere orientati ad acquistare la nostra app piuttosto che un’altra concorrente! E le possibilit\u00e0 di sponsorship “gratuite” a questo punto diventano moltissime!<\/p>\n
    Aggiungere un’ URL Scheme alla propria applicazione iOS<\/h4>\n
    Eccoci giunti al cuore di questo tutorial. Vedremo ora come aggiungere uno schema URL alla nostra applicazione iPhone o iPad! L’operazione \u00e8 molto semplice e richiede non pi\u00f9 di 5 minuti. Ecco i passi da seguire:<\/p>\n
      \n
    1. La prima cosa da fare \u00e8 aprire il progetto della nostra app (o crearne uno nuovo) e andare nel nostro info.plist. Qui, dovremo aggiungere una nuovo elemento alla lista, possiamo farlo semplicemente cliccando con il tasto secondario del mouse\/trackpad su una qualsiasi riga e cliccando su “Add Row”.<\/li>\n
    2. Selezioniamo quindi la riga appena creata e impostiamone la key a “URL types”.<\/li>\n
    3. Espandiamo la struttura che \u00e8 stata creata per noi fino a trovare la chiave “URL identifier” e impostiamone il valore alla stringa “path” (o una qualsiasi altra stringa a nostra scelta).<\/li>\n
    4. Selezioniamo la riga “URL identifier” e clicchiamo sul segno (+) per aggiungere un nuovo elemento al dizionario in cui questa \u00e8 contenuta. Impostiamo la key del nuovo elemento a “URL Schemes”.<\/li>\n
    5. Espandiamo la struttura che \u00e8 stata creata e impostiamo il valore dell’elemento 0 alla stringa “myapp” (o un’altra stringa sempre a nostra scelta).<\/li>\n<\/ol>\n
      Fatto, nient’altro! Abbiamo il nostro URL Scheme disponibile e pronto per essere utilizzato. Se avete seguito correttamente l’operazione dovreste avere come risultato qualcosa del genere:<\/p>\n

      \n      \"\"<\/a>
      \n<\/center><\/p>\n
      Costruiamo ora il nostro URL secondo lo schema [URL Scheme]:\/\/[URL identifier]. Se avete inserito le stringhe suggerite nel tutorial, il risultato ottenuto sar\u00e0 l’indirizzo myapp:\/\/path<\/em>. Facciamo una prova e vediamo se funziona.<\/p>\n
      Clicchiamo su “Build & Run” in XCode e, una volta che la nostra app si \u00e8 aperta, apriamo Safari nell’iPhone Simulator (o nel dispositivo) e proviamo a digitare l’indirizzo myapp:\/\/path<\/em>. Vedrete che si chiuder\u00e0 safari e dar\u00e0 spazio nuovamente alla nostra app che si aprir\u00e0 senza problemi.<\/p>\n
      Quanto mostrato fin’ora \u00e8 pi\u00f9 che sufficiente per far semplicemente aprire la nostra applicazione da un browser per iOS o, chiamando la funzione openURL<\/em>, da un’altra applicazione. Ma se volessimo aggiungere delle funzionalit\u00e0 alla nostra app quando questa viene aperta?<\/p>\n
      Come dicevamo all’inizio di questo articolo, Apple mette a disposizione degli sviluppatori un semplice metodo booleano che di default restituisce “NO” e non fa fare nulla di che alla nostra app, se non aprirsi semplicemente. Se volessimo farle fare qualcosa dovremmo, innanzitutto, restituire “YES” e inserire le istruzioni da eseguire prima della chiamata a “return”.
      \nDobbiamo dunque sovrascrivere la funzione “handleOpenURL”.<\/p>\n
      Andiamo nel delegato della nostra app e aggiungiamo questo metodo:<\/p>\n
      \r\n- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url\r\n{\r\n    \/\/ Inserisci qui le istruzioni da eseguire\r\n    return YES;\r\n}\r\n<\/pre>\n
      A questo punto non ci resta che indicare le istruzioni da eseguire quando l’app si aprir\u00e0. Un modo comune di fare ci\u00f2 \u00e8 sfruttare la parte query<\/em> dell’indirizzo. Questo \u00e8 di solito del tipo “query=something<\/em>” (ma pu\u00f2 essere anche semplicemente “query<\/em>“) e si scrive dopo l’URL identifier da cui \u00e8 diviso dal segno “?”.<\/p>\n
      Un esempio pratico potrebbe essere questo: <\/p>\n
      myapp:\/\/path?query=something<\/em> o ancora “myapp:\/\/path?query<\/em>“.<\/p>\n
      Cocoa ci permette di estrapolare semplicemente la parte query<\/em> dall’indirizzo tramite il metodo [url query]<\/strong>. Aggiungiamo, quindi, qualche semplice istruzione al nostro metodo handleOpenURL<\/em>:<\/p>\n
      \r\n- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url\r\n{\r\n    if ([url query] != nil) {\r\n        UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@\"[url query] \u00e8 diverso da nil\" message:nil delegate:self cancelButtonTitle:@\"Continua\" otherButtonTitles:nil];\r\n