.XML - Android-Zeichenfolgen

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Dateierweiterungen	.xml
API-Erweiterung	xml
Importieren	Ja
Exportieren	Ja
Unterstützung für Pluralformen	Ja
Unterstützung für Beschreibungen	Ja
Format-Optionen Diese Optionen können beim hochladen und/oder Herunterladen einer Datei angegeben werden. Je nach hochladen/Herunterladen-Methode (API, CLI, Repo-Sync usw.) können sie in Query-Parametern `hochladen`, `Herunterladen` oder in der Konfigurationsdatei `phrase.yml` angegeben werden.	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 ist eine Android-spezifische XML-Variante, die verwendet werden kann, um übersetzten Content in Android-Apps zu laden. Das Stammelement ist ein <resources> mit zahlreichen darunter verschachtelten <string>-Elementen, die Strings speichern, die auf eine Übersetzung warten. Sie können Android Studio verwenden, um diese Ressourcendateien zu generieren, und Phrase verwenden, um die Übersetzung zu verwalten.

Android Studio verwendet die Eigenschaft übersetzbar, um anzugeben, ob der Content übersetzt werden muss. In Phrase wird diese Eigenschaft ignoriert. Es ist nicht erforderlich, diese Strings an Phrase zu übertragen. Wenn eine Zeichenfolge nicht übersetzt werden soll, definieren Sie sie in einer separaten Ressourcendatei mit allen nicht übersetzbaren Elementen (z. B. donottranslate.xml).

Format-Optionen

Identifikator	convert_placeholder
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Platzhalter werden konvertiert, um den Format-spezifischen Anforderungen zu entsprechen. Beispiel: `$s' => '$@`

Identifikator	escape_linebreaks
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Alle Zeilenumbrüche werden als `\\n` maskiert

Identifikator	unescape_linebreaks
Typ	Boolean
Hochladen	Ja
Herunterladen	Nein
Standard	false
Beschreibung	Alle `\\n` werden als echte Zeilenumbrüche importiert

Identifikator	enclose_in_cdata
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Schließt Übersetzungen, die HTML-Tags enthalten, in CDATA ein

Identifikator	indent_size
Typ	integer
Upload	Nein
Download	Ja
Standard	4
Beschreibung	Gibt die Anzahl der Einrückungszeichen an

Identifikator	indent_style
Typ	Zeichenfolge
Upload	Nein
Download	Ja
Standard	Leerzeichen
Beschreibung	Gibt das Einrückungszeichen an. Zulässige Werte sind `Leerzeichen` und `Tab`.

Identifikator	unescape_tags
Typ	Boolean
Hochladen	Ja
Herunterladen	Nein
Standard	false
Beschreibung	Alle `<`-Zeichen werden für Tags zu `<` und alle `>`-Zeichen zu `>` entmaskiert.

Identifikator	include_tools_locale_definition
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	`tools:Sprache` Attribut in resultierendes XML einfügen.

Identifikator	include_tools_ignore
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Das `tools:ignorieren` Attribut in das resultierende XML einfügen. Wenn deaktiviert (Standard), wird das `tools:ignorieren`-Attribut aus exportierten Dateien weggelassen. Dies hilft, Ressourcen-Dateien sauber zu halten und vermeidet das Einfügen von entwicklerspezifischen Lint-Unterdrückungsattributen.

Identifikator	preserve_cdata
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Wenn der Content der Übersetzung bereits ein CDATA-Tag enthält, verhindert dieser Schalter, dass der Content zusätzlich maskiert wird.

Identifikator	escape_android_chars
Typ	Boolean
Upload	Nein
Download	Ja
Standard	false
Beschreibung	Maskiert `@`, `?` und `Tab` Android-Sonderzeichen mit einem Backslash-Präfix.

Identifikator	unescape_android_chars
Typ	Boolean
Hochladen	Ja
Herunterladen	Nein
Standard	false
Beschreibung	Entmaskiert `\\@`, `\\?`, `\\t` und `\\uXXXX` (Unicode-Zeichen mit Code XXXX).

Codebeispiel

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- Dies ist die schöne Beschreibung für diesen Key! -->
    <string name=\"key_with_description\">Check it out! This key has a description! (At least in some formats)</string>
    <string name=\"key_with_line-break\">This translations contains
a line-break.</string>
    <string name=\"nested.deeply.key\">Hey, this key is nested even deeper.</string>
    <string name=\"nested.key\">This key is nested inside a namespace.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity="one">Nur eine Pluralform gefunden.</item>
        <item quantity="other">Hey, Sie haben %s Pluralisierungen!</item>        
    </plurals>
    <string-array name="sample_collection">
        <item>erstes Element</item>
        <item>zweites Element</item>
        <item>drittes Element</item>
    </string-array>
    <string name="simple_key">Nur ein Key mit einer Nachricht.</string>
    <string name="unverified_key">Diese Übersetzung ist noch nicht überprüft und wartet darauf. (In einigen Formaten exportieren wir diesen Status auch)</string>
</resources>

Plurale für Android-XML-Dateien

Weisen Sie für Pluralwerte ein spezielles <plurals>-Tag wie folgt zu:

<plurals name="messages">
        <item quantity="one">One message received.</item>
        <item quantity="other">%s messages received.</item>        
</plurals>