Creazione di risorse di localizzazione

Le risorse di localizzazione per le applicazioni sono contenute nei bundle di risorse di localizzazione, che sono un insieme di file che definiscono coppie chiave-valore per tutte le stringhe che vengono visualizzate nell'applicazione ai fini della traduzione. Per ogni lingua supportata, un file contiene valori tradotti per tutte le chiavi.

Informazioni su questa attività

Suggerimento: un bundle di risorse di localizzazione definito e utilizzato in un'applicazione può "nascondere" altri bundle di risorse definiti e utilizzati in toolkit dipendenti se i bundle di risorse utilizzano lo stesso nome. Per evitare incongruenze di comportamento, utilizzare nomi bundle di risorse di localizzazione univoci tra i toolkit dipendenti e i toolkit dipendenti nidificati. Quando i bundle di risorse hanno lo stesso nome, non può essere determinato quale bundle di risorse viene utilizzato dall'applicazione al runtime.

Procedura

Aprire l'applicazione nel designer di basso codice.
Nella libreria, fare clic sul segno più accanto a Interfaccia utente e selezionare Risorsa di localizzazione
Fornire un nome per il nuovo bundle di risorse e fare clic su Fine.
Per ogni stringa traducibile nella propria applicazione, immettere una chiave di traduzione e un valore predefinito per tale chiave. Il valore predefinito è il valore visualizzato se non è disponibile alcuna conversione.
Dopo aver definito tutte le chiavi di traduzione, è possibile esportare il pacchetto di risorse per la traduzione. Fare clic su Esporta per esportare la serie di chiavi esistenti in un file .zip a cui aggiungere i file delle proprietà tradotti corrispondenti.
Creare manualmente un nuovo file delle proprietà per ciascuna locale della lingua in cui verrà convertita l'interfaccia utente. Per ogni lingua che si desidera venga supportata dall'applicazione, creare una copia del file delle proprietà esportato, rinominandolo in base alla lingua che verrà supportata. Ad esempio, se il file delle proprietà predefinito è my_application.properties e si desidera che l'applicazione supporti il giapponese, creare una copia del file denominato my_application_ja.properties.
Fare in modo che ciascuno dei file sia tradotto nelle lingue corrispondenti.
Nota: i file devono soddisfare i seguenti requisiti:
- Le coppie chiave-valore devono essere conformi al formato richiesto dalla specifica Java™. Per ulteriori informazioni, vedere https://docs.oracle.com/javase/7/docs/api/java/util/Properties.html#load(java.io.InputStream ) .
- I caratteri che non possono essere rappresentati direttamente in questa codifica devono essere preceduti da un carattere escape Unicode come definito nella specifica Java. Ad esempio, per il carattere tedesco Umlaut, utilizzare la sequenza di escape unicode \u00dc come valore nella coppia chiave - valore. Esistono strumenti che è possibile utilizzare per automatizzare la conversione dei caratteri. Ad esempio, native2ascii - Convertitore da nativo ad ASCII .
Comprimere i file delle proprietà in un singolo file .zip.
Per importare il bundle di risorse nell'applicazione, aprire il file di risorsa di localizzazione nel designer e fare clic su Importa.
Individuare il file .zip aggiornato per selezionarlo e fare clic su Fine.
Se si sceglie di sovrascrivere i valori per tutte le chiavi esistenti, per qualsiasi lingua fornita, i valori chiave nei file importati che non corrispondono ai valori chiave esistenti sostituiranno i valori esistenti. Le nuove chiavi vengono aggiunte alla serie di chiavi esistente nella risorsa di localizzazione esistente.

Se mancano delle chiavi in uno dei file tradotti, vengono visualizzate delle avvertenze. Fare clic su ciascuna delle lingue contrassegnate con un avviso per visualizzare le traduzioni chiave mancanti. Se non si forniscono traduzioni per queste chiavi, il valore predefinito viene visualizzato in tutte le interfacce che fanno riferimento a questa chiave.

Cosa fare successivamente

Una volta create le risorse di localizzazione, è possibile associarle alle viste o alle app andando alla scheda Variabili .