Pagine

Visualizzazione post con etichetta localizzazione. Mostra tutti i post
Visualizzazione post con etichetta localizzazione. Mostra tutti i post

2013-08-15

Il 'locale' personalizzato

Mac OS X (e ovviamente iOS) ha un'ottima gestione della internazionalizzazione delle applicazioni: basta usare le cartelle magiche per ogni lingua che vogliamo supportare, un paio di macro di compilazione e siamo a posto. Il risultato è un'applicazione che si presenta differente a seconda della lingua scelta nel sistema dall'utente; la documentazione Apple al proposito è sufficientemente chiara: per l'interfaccia usiamo degli xib differenti (ciascuno nella propria cartella della lingua) e per le stringhe nel codice usiamo sempre la macro NSLocalizedString, che andrà a pescare dal file localizableString della lingua giusta.

C'è però una cosa più sottile ed è rappresentata da tutte le varie convenzioni tipiche di ogni lingua; ciò che fa si che la data 5/4/2013 significhi '5 aprile 2013' in Italia, mentre negli Stati Uniti stia per '4 maggio 2013'. Oppure che il le cifre 1,234 indichino un numero appena più grande di 1 in Francia, ma per gli inglesi superi il migliaio.
Per vederle tutte basta aprire Preferenze di Sistema e cliccare su Lingua e Testo e poi scegliere il tab Regione.
Quindi l'utente è abituato (p.es. in Italia) a leggere e scrivere numeri con la virgola per indicare i decimali e così via; quindi la nostra app deve metterlo a suo agio, altrimenti dopo pochi minuti finirà nel cestino, seguita da alcune maledizioni al nostro riguardo...

Per fortuna è molto semplice tenerne conto: di solito è sufficiente impostare nello xib un formatter legato al campo che riceverà il numero e impostare il formatter come ci interessa: in automatico le impostazioni saranno quelle usate nel sistema.

Ci sono però dei momenti in cui è utile conoscere da codice p.es. cosa viene usato come separatore decimale in una certa lingua: nulla di più facile! Per questa operazione ci viene in aiuto l'oggetto NSLocale: basta prima ottenere la lingua impostata sul computer dell'utente usando currentLocale e poi utilizzare l'oggetto così ottenuto per ricavare il carattere usato e molte altre cose. Detto in 'codicese':
NSLocale *myPresentLocale = [NSLocale currentLocale];
//ricaviamo il separatore decimale della lingua dell'utente
NSString *punto = [myPresentLocale objectForKey:NSLocaleDecimalSeparator];
//oppure otteniamo il simbolo di valuta in uso
NSString *valuta = [myPresentLocale objectForKey:NSLocaleCurrencySymbol];
//o per esempio il nome della lingua dell'utente
NSString *lingua = [myPresentLocale objectForKey:NSLocaleIdentifier];
//se vogliamo strafare, questo è il codice della lingua
NSString *codice = [myPresentLocale objectForKey:NSLocaleLanguageCode];
//questa invece è il nome di una lingua... nella lingua dell'utente!
NSString *nome = [myPresentLocale displayNameForKey:NSLocaleIdentifier value:@"fr_FR"];
//se siamo in italiano, il risultato sarà 'Francese'
In questo modo possiamo ottenere tutte le informazioni che ci servono ed utilizzarle per mettere l'utente a proprio agio.
Tuttavia, il nostro caro utente ha molta più libertà che la sola scelta della lingua: p.es. qualcuno potrebbe preferire l'utilizzo del punto decimale al posto della virgola, ma continuare a tenersi il sistema in italiano per avere le date nel formato corretto. Se guardiamo quanto disponibile nelle Preferenze di Sistema, vediamo che l'utente può personalizzare tutto (e non chiediamoci perché dovrebbe farlo: dato che può, qualcuno lo farà certamente!) e questo sarebbe un bel guaio per il povero programmatore. Però... ci viene in aiuto di nuovo il NSLocale: possiamo infatti ottenere un oggetto NSLocale che contiene tutti i valori del locale attuale ma corretti con le eventuali personalizzazioni che il nostro caro utente ha ritenuto opportuno inserire:
NSLocale *actualLocale = [NSLocale autoupdatingCurrentLocale];
NSString *punto = [actualLocale objectForKey:NSLocaleDecimalSeparator];
//se l'utente è un italiano che usa il punto al posto della virgola, otterremo '.'
Da notare che la stessa funzione esiste anche nella Foundation (se dovessimo per qualche motivo lavorare in quel modo); il codice diventerebbe:
CFLocaleRef userLocale = CFLocaleCopyCurrent();
CFTypeRef decimalPoint = CFLocaleGetValue(userLocale, kCFLocaleDecimalSeparator);
//più difficile da leggere, ma con lo stesso risultato!
Quindi, da oggi i nostri utenti saranno felici e contenti di poter usare le loro impostazioni anche nelle nostre app!

2013-04-24

Core Data Localization Dictionary

Core Data su Mac è indubbiamente per lo sviluppatore quando si tratta di gestire quantità di dati. Non starò qui a descrivere le possibilità di Core Data: esistono molte fonti in rete, a cui si aggiunge la documentazione di Apple, da cui è conveniente partire (meglio ricordare che Core Data, a dispetto della semplicità d'uso, è una delle tecnologie più profonde che abbia a disposizione uno sviluppatore).

Inoltre, Apple ha fornito tecniche interessanti da utilizzare.
Una di queste è la possibilità di localizzare (cioè presentare nella lingua dell'utente) persino le proprietà di Core Data (o, più correttamente, le proprietà delle Entity). In questo modo, è possibile far riferimento a tali proprietà nell'interfaccia visibile all'utente, per esempio durante l'emissione di un messaggio di errore. È infatti certamente più user friendly un messaggio che dice "il valore di 'Indirizzo' non è corretto" piuttosto che "il valore di 'Address' non è corretto"; infatti non ci dobbiamo attendere che tutti i nostri utenti conoscano l'inglese.

La documentazione ci dice che basta costruire un Localization Dictionary. Cioè?
In pratica è un altro file di tipo .strings, dove andremo ad inserire il nome dell'Entity e delle sue proprietà, indicandone la traduzione. Per esempio, nel caso di una Entity 'Home', il file potrebbe essere così costruito:
"Entity/Home" = "Casa";
"Property/address" = "Indirizzo";
"Property/Number" = "Numero";
dove vediamo che la chiave è composta da "Entity" o "Property"seguita da "/" e dal nome della proprietà come definita nel modello (dataModel). Se due Entity differenti avessero una proprietà con lo stesso nome, dovremmo costruire la chiave indicando anche l' Entity .

Per renderci le cose meno semplici, la documentazione ci dice che il nome di questo file .stringsdeve essere quello del nostro DataModel a cui si aggiunge la parole Model . Quindi, se il nostro data model di Core Data è stato da noi chiamato p.es. dataModel, il file che riporta le traduzioni si dovrà chiamare dataModelModel.strings. Questo, per quanto strano (in effetti Xcode genera un nuovo progetto usando proprio questo nome...) è spiegato esplicitamente e in effetti funziona.

Una volta che abbiamo costruito il file, possiamo richiamarlo dal codice semplicemente definendo il dizionario (che sarà riconosciuto dal codice) e prendendo la proprietà che ci serve:
NSDictionary *localDict = [self.managedObjectModel localizationDictionary];
NSString *localProperty = [localDict valueForKey:@"Property/Address"];
per cui dovremmo essere a posto.... Non è vero! Infatti la documentazione ci dice che, almeno fino al 10.6 Snow Leopard, il dizionario viene caricato lazily, cioè se proprio ce n'è bisogno. E se non ci son stati errori da presentare, il bisogno non c'è stato! Quindi sul 10.6 la stringa localPropertydell'esempio precedente è nulla!
Ma la soluzione è molto semplice: le stringhe da caricare sono dentro il file .strings, per cui carichiamole come se fossero proprio quello:
NSString *localProperty = NSLocalizedStringFromTable(@"Property/Address", @"dataModelModel", @"proprietà Indirizzo");
e possiamo proseguire felici e contenti!

Da notare che dal 10.7 in poi il problema del caricamento non c'è più, ma per il momento meglio usare la macro NSLocalizedStringFromTable, soprattutto se prevediamo di supportare il 10.6!