.XML - Android (Strings)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Estensioni dei file	.xml
Estensione API	xml
Importa	Sì
Esporta	Sì
Supporto forme plurali	Sì
Supporto descrizione	Sì
Opzioni di formato Queste opzioni possono essere specificate quando un file viene caricato e/o Scarica. A seconda del metodo di caricare/Scarica (API, CLI, sincronizzazione Repo ecc.), possono essere specificate nei parametri di query `caricare`, `Scarica` o nel file di configurazione `phrase.yml`.	convert_placeholder escape_linebreaks unescape_linebreaks enclose_in_cdata indent_size indent_style unescape_tags include_tools_ignore include_tools_locale_definition escape_android_chars unescape_android_chars

Android XML è una variante XML specifica per Android che può essere usata per caricare contenuto tradotto nelle App Android. Il suo elemento radice è un <resources> con numerosi elementi <string> annidati al suo interno che memorizzano Strings in attesa di traduzione. È possibile usare Android Studio per generare questi file di risorse e usare Phrase per gestire la traduzione.

Android Studio usa la proprietà traducibile per indicare se il contenuto deve essere tradotto. In Phrase, questa proprietà viene ignorata. Non c'è bisogno di inviare queste Strings a Phrase. Se una stringa non deve essere tradotta, definirla in un file di risorse separato con tutte le Strings non traducibili (es. donottranslate.xml).

Opzioni di formato

Identificatore	convert_placeholder
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Il segnaposto verrà convertito per corrispondere ai requisiti specifici del formato. Esempio: `$s' => '$@`

Identificatore	escape_linebreaks
Tipo	Booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Tutte le interruzioni di riga verranno convertite in caratteri di escape come `\\n`

Identificatore	unescape_linebreaks
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Tutti i `\\n` verranno importati come vere nuove righe

Identificatore	enclose_in_cdata
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Racchiude le traduzioni contenenti tag HTML in CDATA

Identificatore	indent_size
Tipo	integer
Caricamento	No
Download	Sì
Predefinito	4
Descrizione	Specifica il numero di caratteri di rientro

Identificatore	indent_style
Tipo	stringa
Caricamento	No
Download	Sì
Predefinito	spazio
Descrizione	Specifica il carattere di rientro. I valori consentiti sono `spazio` e `scheda`.

Identificatore	unescape_tags
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Tutti i caratteri `<` verranno de-escapati in `<` e tutti i caratteri `>` verranno de-escapati in `>` per i tag.

Identificatore	include_tools_locale_definition
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Includi l'attributo `Strumenti:impostazioni locali` attributo nell'XML risultante.

Identificatore	include_tools_ignore
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Includi l'attributo `Strumenti:ignorare` attributo nell'XML risultante. Quando disabilitato (predefinito), l'attributo `Strumenti:ignorare` viene omesso dai file esportati. Questo aiuta a mantenere puliti i file delle risorse ed evita di includere attributi di soppressione lint specifici per lo sviluppo.

Identificatore	preserve_cdata
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Se il contenuto della traduzione contiene già un tag CDATA, questo interruttore impedisce che il contenuto venga ulteriormente sottoposto a escape.

Identificatore	escape_android_chars
Tipo	booleano
Caricamento	No
Download	Sì
Predefinito	false
Descrizione	Esegue l'escape di `@`, `?` e `scheda` caratteri speciali Android con un prefisso backslash.

Identificatore	unescape_android_chars
Tipo	booleano
Caricamento	Sì
Download	No
Predefinito	false
Descrizione	Rimuove l'escape di `\\@`, `\\?`, `\\t` e `\\uXXXX` (carattere Unicode con codice XXXX).

Campione di codice

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name=\"boolean_key\">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- Questa è la bellissima descrizione per questa chiave! -->
    <string name=\"key_with_description\">Check it out! Questa chiave ha una descrizione! (Almeno in alcuni formati)</string>
    <string name=\"key_with_line-break\">This translations contains
a line-break.</string>
    <string name=\"nested.deeply.key\">Ehi, questa chiave è annidata ancora più in profondità.</string>
    <string name="nested.chiave">Questa chiave è annidata all'interno di un namespace.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity="one">Trovata solo una forma plurale.</item>
        <item quantity="other">Ehi, hai %s pluralizzazioni!</item>        
    </plurals>
    <string-array name="sample_collection">
        <item>primo elemento</item>
        <item>secondo elemento</item>
        <item>terzo elemento</item>
    </string-array>
    <string name="simple_chiave">Solo una chiave con un messaggio.</string>
    <string name="unverified_chiave">Questa traduzione non è ancora verificata e attende di esserlo. (In alcuni formati esportiamo anche questo stato)</string>
</resources>

Plurali per file XML Android

Per i valori plurali assegnare un tag speciale <plurals> come questo:

<plurals name="messages">
        <item quantity="one">Un messaggio ricevuto.</item>
        <item quantity="other">%s messaggi ricevuti.</item>        
</plurals>