Android Training/Supporting Different Languages/de: Unterschied zwischen den Versionen

Aus Android Wiki
(Übernehme Bearbeitung einer neuen Version der Quellseite)
(Die Seite wurde neu angelegt: „Beispielsweise:“)
 
(13 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 4: Zeile 4:
Wenn du ein Projekt mit den Android SDK Tools erstellt hast (lese [[Special:MyLanguage/Android_Training/Creating_an_Android_Project|Erstellen eines Android Projektes]]), haben die Tools ein <code>res/</code> Ordner im Stammverzeichnis des Projektes erstellt. Innerhalb dieses <code>res/</code> Ordner gibt es verschiedene Unterordner für die verschiedenen Ressourcen-Typen. Außerdem liegen dort einige Standard-Dateien, wie zum Beispiel <code>res/values/strings.xml</code>, welche deine Zeichenketten beinhalten.
Wenn du ein Projekt mit den Android SDK Tools erstellt hast (lese [[Special:MyLanguage/Android_Training/Creating_an_Android_Project|Erstellen eines Android Projektes]]), haben die Tools ein <code>res/</code> Ordner im Stammverzeichnis des Projektes erstellt. Innerhalb dieses <code>res/</code> Ordner gibt es verschiedene Unterordner für die verschiedenen Ressourcen-Typen. Außerdem liegen dort einige Standard-Dateien, wie zum Beispiel <code>res/values/strings.xml</code>, welche deine Zeichenketten beinhalten.


== Create Locale Directories and String Files ==
== Locale-Verzeichnis und Zeichenketten-Dateien erstellen ==
To add support for more languages, create additional <code>values</code> directories inside <code>res/</code> that include a hyphen and the ISO language code at the end of the directory name. For example, <code>values-es/</code> is the directory containing simple resourcess for the Locales with the language code "es". Android loads the appropriate resources according to the locale settings of the device at run time. For more information, see [http://developer.android.com/guide/topics/resources/providing-resources.html#AlternativeResources Providing Alternative Resources].
Um mehr Sprachen zu unterstützen, musst du zusätzliche <code>values</code> Ordner unter <code>res/</code> erstellen, welche einen Bindestrich gefolgt vom ISO Sprach-Code am Ende des Ordner-Namens haben. Als Beispiel: <code>values-es/</code> ist der Ordner, welcher einfache Ressourcen für die Lokalisierung für den Sprachcode "es" beinhaltet. Android lädt die korrekten Ressourcen während der Laufzeit entsprechend der Sprach-Einstellungen des Gerätes. Für mehr Informationen, siehe [http://developer.android.com/guide/topics/resources/providing-resources.html#AlternativeResources Providing Alternative Resources].


Once you’ve decided on the languages you will support, create the resource subdirectories and string resource files. For example:
Sobald du entschieden hast, welche Sprachen du unterstützen möchtest, kannst du die Ressourcen-Unterordner und die Zeichenketten-Ressourcen-Dateien erstellen. Als Beispiel:
<syntaxhighlight lang="text">
<syntaxhighlight lang="text">
MyProject/
MyProject/
Zeile 19: Zeile 19:
</syntaxhighlight>
</syntaxhighlight>


Add the string values for each locale into the appropriate file.
Füge die Zeichenketten-Werte für jede Sprach-Version in die entsprechende Datei ein.


At runtime, the Android system uses the appropriate set of string resources based on the locale currently set for the user's device.
Während der Laufzeit nutzt Android die entsprechenden Zeichenketten-Ressourcen, basierend auf der Spracheinstellung des vom Nutzer verwendeten Gerätes.


For example, the following are some different string resource files for different languages.
Folgend sind beispielsweise verschiedene Zeichenketten-Ressourcen-Dateien für verschiedene Sprachen.


English (default locale), <code>/values/strings.xml</code>:<syntaxhighlight lang="xml">
Englisch (Standard-Sprache), <code>/values/strings.xml</code>:<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<?xml version="1.0" encoding="utf-8"?>
<resources>
<resources>
Zeile 33: Zeile 33:
</syntaxhighlight>
</syntaxhighlight>


Spanish, <code>/values-es/strings.xml</code>:<syntaxhighlight lang="xml">
Spanisch, <code>/values-es/strings.xml</code>:<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<?xml version="1.0" encoding="utf-8"?>
<resources>
<resources>
Zeile 41: Zeile 41:
</syntaxhighlight>
</syntaxhighlight>


French, <code>/values-fr/strings.xml</code>:<syntaxhighlight lang="xml">
Französisch, <code>/values-fr/strings.xml</code>:<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<?xml version="1.0" encoding="utf-8"?>
<resources>
<resources>
Zeile 49: Zeile 49:
</syntaxhighlight>
</syntaxhighlight>


'''Note:''' You can use the locale qualifier (or any configuration qualifer) on any resource type, such as if you want to provide localized versions of your bitmap drawable. For more information, see [http://developer.android.com/guide/topics/resources/localization.html Localization].
'''Note:''' Du kannst den Sprach-Qualifier (oder jeden anderen Konfigurations-Qualifier) für jeden Ressourcen-Typ verwenden, so als wenn du verschiedene, lokalisierte Versionen eines Bitmap-Drawable bereitstellen möchtest. Für mehr Informationen, siehe [http://developer.android.com/guide/topics/resources/localization.html Lokalisierung].


== Use the String Resources ==
== Zeichenketten-Ressourcen verwenden ==
You can reference your string resources in your source code and other XML files using the resource name defined by the <code><string></code> element's <code>name</code> attribute.
Du kannst Zeichenketten-Ressourcen in deinem Code oder anderen XML-Dateien anhand des Ressourcen-Namens, definiert mit dem <code>name</code> Attribut im <code><string></code> Element, referenzieren.


In your source code, you can refer to a string resource with the syntax <code>R.string.<string_name></code>. There are a variety of methods that accept a string resource this way.
In deinem Quellcode kannst du eine Zeichenketten-Ressource mit der Syntax <code>R.string.<string_name></code> referenzieren. Es gibt eine Vielzahl an Methoden, die eine Zeichenketten-Ressource auf diesen Weg akzeptieren.


For example:
Beispielsweise:
<syntaxhighlight lang="java">
<syntaxhighlight lang="java">
// Get a string resource from your app's Resources
// Get a string resource from your app's Resources
Zeile 66: Zeile 66:
</syntaxhighlight>
</syntaxhighlight>


In other XML files, you can refer to a string resource with the syntax <code>@string/<string_name></code> whenever the XML attribute accepts a string value.
In anderen XML-Dateien kannst du eine Zeichenketten-Ressource immer dann mit dieser Syntax <code>@string/<string_name></code> referenzieren, wenn das XML-Attribut eine Zeichenkette akzeptiert.


For example:
Beispielsweise:
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<TextView
<TextView

Aktuelle Version vom 24. Dezember 2015, 19:32 Uhr

Sprachen:

Es ist immer eine gute Praxis, Zeichenketten der Benutzeroberfläche vom eigentlichen App-Code zu trennen und in einer externen Datei zu belassen. Android macht die Umsetzung einfach, durch ein ressources-Ordner in jedem Android Projekt.

Wenn du ein Projekt mit den Android SDK Tools erstellt hast (lese Erstellen eines Android Projektes), haben die Tools ein res/ Ordner im Stammverzeichnis des Projektes erstellt. Innerhalb dieses res/ Ordner gibt es verschiedene Unterordner für die verschiedenen Ressourcen-Typen. Außerdem liegen dort einige Standard-Dateien, wie zum Beispiel res/values/strings.xml, welche deine Zeichenketten beinhalten.

Locale-Verzeichnis und Zeichenketten-Dateien erstellen

Um mehr Sprachen zu unterstützen, musst du zusätzliche values Ordner unter res/ erstellen, welche einen Bindestrich gefolgt vom ISO Sprach-Code am Ende des Ordner-Namens haben. Als Beispiel: values-es/ ist der Ordner, welcher einfache Ressourcen für die Lokalisierung für den Sprachcode "es" beinhaltet. Android lädt die korrekten Ressourcen während der Laufzeit entsprechend der Sprach-Einstellungen des Gerätes. Für mehr Informationen, siehe Providing Alternative Resources.

Sobald du entschieden hast, welche Sprachen du unterstützen möchtest, kannst du die Ressourcen-Unterordner und die Zeichenketten-Ressourcen-Dateien erstellen. Als Beispiel:

MyProject/
    res/
        values/
            strings.xml
        values-es/
            strings.xml
        values-fr/
            strings.xml

Füge die Zeichenketten-Werte für jede Sprach-Version in die entsprechende Datei ein.

Während der Laufzeit nutzt Android die entsprechenden Zeichenketten-Ressourcen, basierend auf der Spracheinstellung des vom Nutzer verwendeten Gerätes.

Folgend sind beispielsweise verschiedene Zeichenketten-Ressourcen-Dateien für verschiedene Sprachen.

Englisch (Standard-Sprache), /values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="title">My Application</string>
    <string name="hello_world">Hello World!</string>
</resources>

Spanisch, /values-es/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="title">Mi Aplicación</string>
    <string name="hello_world">Hola Mundo!</string>
</resources>

Französisch, /values-fr/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="title">Mon Application</string>
    <string name="hello_world">Bonjour le monde !</string>
</resources>

Note: Du kannst den Sprach-Qualifier (oder jeden anderen Konfigurations-Qualifier) für jeden Ressourcen-Typ verwenden, so als wenn du verschiedene, lokalisierte Versionen eines Bitmap-Drawable bereitstellen möchtest. Für mehr Informationen, siehe Lokalisierung.

Zeichenketten-Ressourcen verwenden

Du kannst Zeichenketten-Ressourcen in deinem Code oder anderen XML-Dateien anhand des Ressourcen-Namens, definiert mit dem name Attribut im <string> Element, referenzieren.

In deinem Quellcode kannst du eine Zeichenketten-Ressource mit der Syntax R.string.<string_name> referenzieren. Es gibt eine Vielzahl an Methoden, die eine Zeichenketten-Ressource auf diesen Weg akzeptieren.

Beispielsweise:

// Get a string resource from your app's Resources
String hello = getResources().getString(R.string.hello_world);

// Or supply a string resource to a method that requires a string
TextView textView = new TextView(this);
textView.setText(R.string.hello_world);

In anderen XML-Dateien kannst du eine Zeichenketten-Ressource immer dann mit dieser Syntax @string/<string_name> referenzieren, wenn das XML-Attribut eine Zeichenkette akzeptiert.

Beispielsweise:

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:text="@string/hello_world" />