Skip to content

7. Internationalisierung

7.1. Beispiel 21: Eine zweisprachige Anwendung

[Flutter] verwendet ARB-Dateien oder die JSON-Datei aus dem Paket [easy_localization]. [Android] hat eine eigene, im System integrierte Methode: Die Texte der Anwendung sind RESSOURCEN. Die Datei [res/values/strings.xml] enthält die Texte der Standardsprache, hier Englisch; jede Übersetzung ist eine gleichnamige Datei in einem Ordner, dessen Suffix der Sprachcode ist. Die französische Übersetzung, [res/values-fr/strings.xml]:

<?xml version="1.0" encoding="utf-8"?>
<!-- =====================================================================
     res/values-fr/strings.xml - die Texte der Anwendung auf FRANZÖSISCH
     (die Übersetzung). Die Standardsprache, Englisch, steht in
     res/values/strings.xml: Android wählt die Datei anhand der
     Sprache der Anwendung aus (vgl. Beispiel 21).
     ===================================================================== -->
<resources>
    <string name="app_name">Exemples Kotlin</string>

    <!-- Beispiel 21 -->
    <string name="ex21_title">Exemple 21 - deux langues</string>
    <!-- %1$s: der erste Parameter, ein String -->
    <string name="ex21_hello">Bonjour %1$s !</string>
    <string name="ex21_today">Nous sommes le %1$s.</string>
    <string name="ex21_price">Une consultation coûte %1$s.</string>
    <string name="ex21_no_appointment">aucun rendez-vous</string>
    <!-- ein Pluraltext: eine Form pro „Kategorie“ der Sprache;
         %1$d: der erste Parameter, eine Ganzzahl -->
    <plurals name="ex21_appointments">
        <item quantity="one">un rendez-vous</item>
        <item quantity="many">%1$d rendez-vous</item>
        <item quantity="other">%1$d rendez-vous</item>
    </plurals>
    <string name="ex21_add">Ajouter un rendez-vous</string>
    <string name="ex21_remove">En retirer un</string>
    <string name="ex21_calendar">Ouvrir le calendrier</string>
    <string name="ex21_server_title">Traduire une réponse du serveur</string>
    <string name="ex21_server_explanation">Le serveur RdvMedecins ne renvoie que des clés. C\'est le client qui les traduit :</string>
    <string name="errors_login_taken">Ce login est déjà utilisé par un autre compte.</string>
    <string name="errors_too_many_attempts">Trop de tentatives infructueuses. Réessayez dans %1$s minute(s).</string>
</resources>
  • Jeder Text hat einen NAMEN; der Code kennt nur diesen Namen: [R.string.ex21_hello];
  • [%1$s]: der erste Parameter, eine Zeichenkette; [%1$d]: eine ganze Zahl;
  • [<plurals>]: ein Pluraltext mit einer Form pro Sprach-„Kategorie“ ([one], [many], [other] ...): [Android] kennt die Regeln jeder Sprache;
  • [C\'est]: Dem Apostroph muss ein Backslash vorangestellt werden.

Die Standarddatei [res/values/strings.xml] (Englisch): dieselben Namen, im Ordner ohne Suffix. [Android] wählt die Datei anhand der Sprache der Anwendung aus:

<?xml version="1.0" encoding="utf-8"?>
<!-- =====================================================================
     res/values/strings.xml - die Texte der Anwendung auf ENGLISCH
     (die Standardsprache). Dieselben Namen wie in res/values-fr/strings.xml;
     ein hier fehlender Text würde in jeder Sprache fehlen.
     ===================================================================== -->
<resources>
    <string name="app_name">Kotlin examples</string>

    <string name="ex21_title">Example 21 - two languages</string>
    <string name="ex21_hello">Hello %1$s!</string>
    <string name="ex21_today">Today is %1$s.</string>
    <string name="ex21_price">A consultation costs %1$s.</string>
    <string name="ex21_no_appointment">no appointment</string>
    <plurals name="ex21_appointments">
        <item quantity="one">one appointment</item>
        <item quantity="other">%1$d appointments</item>
    </plurals>
    <string name="ex21_add">Add an appointment</string>
    <string name="ex21_remove">Remove one</string>
    <string name="ex21_calendar">Open the calendar</string>
    <string name="ex21_server_title">Translating a server response</string>
    <string name="ex21_server_explanation">The RdvMedecins server only sends keys. The client translates them:</string>
    <string name="errors_login_taken">This login is already used by another account.</string>
    <string name="errors_too_many_attempts">Too many failed attempts. Try again in %1$s minute(s).</string>
</resources>

Die Sprachen der Anwendung werden in [res/xml/locales_config.xml] deklariert, auf die das Manifest verweist ([android:localeConfig]):

<?xml version="1.0" encoding="utf-8"?>
<!-- =====================================================================
     res/xml/locales_config.xml - die Sprachen der Anwendung (Beispiel 21)
     ............................................................................
     Deklariert in AndroidManifest.xml (android:localeConfig). Seit
     Android 13 kann der Benutzer die Sprache JEDER
     Anwendung auch in den Telefoneinstellungen wählen: Einstellungen > System >
     Sprachen > App-Sprachen.
     ===================================================================== -->
<locale-config xmlns:android="http://schemas.android.com/apk/res/android">
    <locale android:name="fr" />
    <locale android:name="en" />
</locale-config>

Ab [Android] 13 kann der Benutzer dann die Sprache der Anwendung in den Telefoneinstellungen auswählen. Der Code des Beispiels:

// =========================================================================
// ex21/Ex21Activity.kt - eine Anwendung in zwei Sprachen
// -------------------------------------------------------------------------
// Der Android-Weg:
//   - die TEXTE der Anwendung sind RESSOURCEN: eine Datei
//     res/values/strings.xml (die Standardsprache, hier Englisch) und eine
//     Datei pro Übersetzung (res/values-fr/strings.xml). Jeder Text hat einen
//     Namen; der Code kennt nur diesen Namen (R.string.ex21_hello), und
//     Android wählt die Datei entsprechend der Sprache der Anwendung;
//   - stringResource(R.string.ex21_hello, "Marie"): der Text, dessen
//     Parameter (%1$s) ersetzt werden; pluralStringResource: ein Plural-
//     text, dessen Form den Regeln der Sprache folgt;
//   - die Sprache der Anwendung: die des Smartphones ... oder die, die die
//     Anwendung selbst wählt, AppCompatDelegate.setApplicationLocales.
//     Android ERZEUGT die Activity dann NEU, in der neuen Sprache: die Texte,
//     die Datumsangaben, die Beträge und die Texte von Android selbst (der
//     Kalender, seine Schaltflächen).
// Der RdvMedecins-Server liefert seinerseits nur SCHLÜSSEL ("ERRORS.LOGIN_TAKEN"):
// Sie werden über eine Tabelle (serverKeys) den Ressourcen zugeordnet.
// Die Activity ist eine AppCompatActivity: die Activity-Klasse, die die gewählte Sprache
// anwenden kann, sogar auf Android-Versionen vor
// 13.
// =========================================================================
@file:OptIn(ExperimentalMaterial3Api::class, ExperimentalLayoutApi::class)

package fr.stahe.examples.ex21

import android.os.Bundle
import androidx.activity.compose.setContent
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.appcompat.app.AppCompatDelegate
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.ExperimentalLayoutApi
import androidx.compose.foundation.layout.FlowRow
import androidx.compose.foundation.layout.Spacer
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.height
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.layout.width
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.DateRange
import androidx.compose.material3.Card
import androidx.compose.material3.DatePicker
import androidx.compose.material3.DatePickerDialog
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.Icon
import androidx.compose.material3.MaterialTheme
import androidx.compose.material3.OutlinedButton
import androidx.compose.material3.SegmentedButton
import androidx.compose.material3.SegmentedButtonDefaults
import androidx.compose.material3.SingleChoiceSegmentedButtonRow
import androidx.compose.material3.Text
import androidx.compose.material3.TextButton
import androidx.compose.material3.rememberDatePickerState
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.platform.LocalConfiguration
import androidx.compose.ui.res.pluralStringResource
import androidx.compose.ui.res.stringResource
import androidx.compose.ui.text.font.FontFamily
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import androidx.core.os.LocaleListCompat
import fr.stahe.examples.R
import fr.stahe.examples.common.ExamplePage
import fr.stahe.examples.common.ExamplesTheme
import java.text.NumberFormat
import java.time.LocalDate
import java.time.format.DateTimeFormatter
import java.time.format.FormatStyle
import java.util.Currency

val languages = listOf("fr", "en")

// was der RdvMedecins-Server zurückgeben würde (vgl. Kapitel über die Blackbox)
data class ServerResponse(val statusCode: Int, val key: String, val params: Map<String, String>)

val serverResponses = listOf(
    ServerResponse(409, "ERRORS.LOGIN_TAKEN", emptyMap()),
    ServerResponse(429, "ERRORS.TOO_MANY_ATTEMPTS", mapOf("minutes" to "15")),
)

// der Schlüssel des Servers -> die Ressource, die ihn übersetzt
val serverKeys = mapOf(
    "ERRORS.LOGIN_TAKEN" to R.string.errors_login_taken,
    "ERRORS.TOO_MANY_ATTEMPTS" to R.string.errors_too_many_attempts,
)

class Ex21Activity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        enableEdgeToEdge()
        setContent { ExamplesTheme { TranslatedPage() } }
    }
}

// die Sprache der Anwendung wählen: Android speichert sie und erzeugt die Activity neu
fun changeLanguage(language: String) {
    AppCompatDelegate.setApplicationLocales(LocaleListCompat.forLanguageTags(language))
}

@Composable
fun TranslatedPage() {
    // rememberSaveable: Der Zähler übersteht die Neuerzeugung der Activity
    var count by rememberSaveable { mutableIntStateOf(2) }
    var calendarOpen by rememberSaveable { mutableStateOf(false) }
    // die AKTUELLE Sprache: die der Konfiguration der Activity
    val locale = LocalConfiguration.current.locales[0]
    // Formatierer in der aktuellen Sprache
    val date = LocalDate.now().format(DateTimeFormatter.ofLocalizedDate(FormatStyle.FULL).withLocale(locale))
    val price = NumberFormat.getCurrencyInstance(locale).apply { currency = Currency.getInstance("EUR") }.format(1234.5)

    ExamplePage(
        title = stringResource(R.string.ex21_title),
        // die Sprachen: "segmentierte" Schaltflächen in der Top-Bar
        actions = {
            SingleChoiceSegmentedButtonRow(Modifier.padding(end = 8.dp).width(120.dp)) {
                languages.forEachIndexed { i, l ->
                    SegmentedButton(
                        selected = locale.language == l,
                        onClick = { changeLanguage(l) },
                        shape = SegmentedButtonDefaults.itemShape(i, languages.size),
                        icon = {},
                    ) { Text(l.uppercase()) }
                }
            }
        },
    ) {
        Card(Modifier.fillMaxWidth()) {
            Column(Modifier.padding(12.dp)) {
                Text(stringResource(R.string.ex21_hello, "Marie"))
                Text(stringResource(R.string.ex21_today, date))
                Text(stringResource(R.string.ex21_price, price))
                Spacer(Modifier.height(8.dp))
                // der Plural: Die Kategorie "zero" existiert weder im Französischen noch im
                // Englischen (0 ist im Französischen "one", im Englischen "other"): 0 wird
                // separat behandelt
                Text(
                    if (count == 0) stringResource(R.string.ex21_no_appointment) else pluralStringResource(R.plurals.ex21_appointments, count, count),
                    fontWeight = FontWeight.Bold,
                )
                FlowRow(horizontalArrangement = Arrangement.spacedBy(8.dp)) {
                    TextButton(onClick = { count++ }) { Text(stringResource(R.string.ex21_add)) }
                    TextButton(onClick = { count-- }, enabled = count > 0) { Text(stringResource(R.string.ex21_remove)) }
                }
                // der Material-Kalender: Seine Texte folgen der Sprache der Anwendung
                OutlinedButton(onClick = { calendarOpen = true }) {
                    Icon(Icons.Default.DateRange, contentDescription = null)
                    Spacer(Modifier.width(8.dp))
                    Text(stringResource(R.string.ex21_calendar))
                }
            }
        }
        Card(Modifier.fillMaxWidth()) {
            Column(Modifier.padding(12.dp)) {
                Text(stringResource(R.string.ex21_server_title), style = MaterialTheme.typography.titleSmall)
                Text(stringResource(R.string.ex21_server_explanation))
                Spacer(Modifier.height(8.dp))
                for (r in serverResponses) {
                    Text("${r.statusCode} ${r.key}", fontFamily = FontFamily.Monospace, fontSize = 12.sp)
                    // die Ressource des Schlüssels; ihre Parameter in der Reihenfolge (*: "spreizt" das Array)
                    val id = serverKeys[r.key]
                    Text("→ " + if (id == null) r.key else stringResource(id, *r.params.values.toTypedArray()))
                    Spacer(Modifier.height(6.dp))
                }
            }
        }
    }

    if (calendarOpen) {
        val state = rememberDatePickerState()
        DatePickerDialog(
            onDismissRequest = { calendarOpen = false },
            // die Texte OK / Abbrechen von Android selbst, in der Sprache der Anwendung
            confirmButton = { TextButton(onClick = { calendarOpen = false }) { Text(stringResource(android.R.string.ok)) } },
            dismissButton = { TextButton(onClick = { calendarOpen = false }) { Text(stringResource(android.R.string.cancel)) } },
        ) {
            DatePicker(state = state)
        }
    }
}
  • Zeilen 92–94: Der RdvMedecins-Server liefert nur SCHLÜSSEL (["ERRORS.LOGIN_TAKEN"]); diese werden über eine Tabelle auf Ressourcen abgebildet;
  • Zeile 97: eine [AppCompatActivity]: die Activity-Klasse, die die gewählte Sprache anwenden kann, auch vor [Android] 13;
  • Zeilen 106–107: Auswahl der Sprache für die ANWENDUNG (nicht die Sprache des Telefons): [Android] speichert sie und erstellt die Activity in der neuen Sprache NEU. Vor [Android] 13 speichert die Bibliothek [AppCompat] sie (der Service [AppLocalesMetadataHolderService] im Manifest, [autoStoreLocales]);
  • Zeilen 116–119: die aktuelle Sprache, also die in der Konfiguration der Activity angegebene Sprache, sowie die Formatierer für Datum und Betrag in dieser Sprache;
  • Zeile 122: [stringResource(R.string.ex21_title)]: der Text in der aktuellen Sprache;
  • Zeilen 10–11: Parameter und eine Pluralform ([pluralStringResource]): Da die Kategorie [zero] weder im Französischen noch im Englischen existiert, wird 0 gesondert behandelt;
  • Zeilen 170–171: die Übersetzung eines Server-Schlüssels samt seinen Parametern ([*] „entpackt“ ein Array in eine Parameterliste);
  • Zeilen 180–184: Der Text für [Android] selbst ([android.R.string.ok]) und der des Kalenders folgen ebenfalls der Sprache der Anwendung.

Image

Image

Image

Die Anzahl der Termine bleibt dank [rememberSaveable] über Sprachwechsel hinweg erhalten: Die Activity wurde jedoch zerstört und neu erstellt.