Skip to content

7. Internacionalización

7.1. Ejemplo 21: una aplicación bilingüe

[Flutter] utiliza archivos ARB, o el archivo JSON del paquete [easy_localization]. [Android] tiene su propio método, integrado en el sistema: los textos de la aplicación son RECURSOS. El archivo [res/values/strings.xml] contiene los textos del idioma predeterminado, en este caso inglés; cada traducción es un archivo con el mismo nombre, en una carpeta cuyo sufijo es el código del idioma. La traducción al francés, [res/values-fr/strings.xml]:

<?xml version="1.0" encoding="utf-8"?>
<!-- =====================================================================
     res/values-fr/strings.xml - los textos de la aplicación, en FRANCÉS
     (la traducción). El idioma predeterminado, el inglés, está en
     res/values/strings.xml: Android elige el archivo según el
     idioma de la aplicación (cf. ejemplo 21).
     ===================================================================== -->
<resources>
    <string name="app_name">Exemples Kotlin</string>

    <!-- ejemplo 21 -->
    <string name="ex21_title">Exemple 21 - deux langues</string>
    <!-- %1$s: el primer parámetro, una cadena -->
    <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>
    <!-- un texto plural: una forma por "categoría" del idioma;
         %1$d: el primer parámetro, un entero -->
    <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>
  • Cada texto tiene un NOMBRE; el código solo reconoce este nombre: [R.string.ex21_hello];
  • [%1$s]: el primer parámetro, una cadena; [%1$d]: un entero;
  • [<plurals>]: un texto plural, con una forma por “categoría” de cada idioma ([one], [many], [other]...) : [Android] conoce las reglas de cada idioma;
  • [C\'est]: el apóstrofo debe ir precedido de una barra invertida.

El archivo predeterminado, [res/values/strings.xml] (inglés): los mismos nombres, en la carpeta sin sufijo. [Android] selecciona el archivo según el idioma de la aplicación:

<?xml version="1.0" encoding="utf-8"?>
<!-- =====================================================================
     res/values/strings.xml - los textos de la aplicación, en INGLÉS
     (el idioma predeterminado). Mismos nombres que en res/values-fr/strings.xml;
     un texto que falte aquí faltaría en todos los idiomas.
     ===================================================================== -->
<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>

Los idiomas de la aplicación se declaran en [res/xml/locales_config.xml], al que hace referencia el manifiesto ([android:localeConfig]):

<?xml version="1.0" encoding="utf-8"?>
<!-- =====================================================================
     res/xml/locales_config.xml - los idiomas de la aplicación (ejemplo 21)
     ............................................................................
     Declarado en AndroidManifest.xml (android:localeConfig). Desde
     Android 13, el usuario también puede elegir el idioma de CADA
     aplicación en los ajustes del teléfono: Ajustes > Sistema >
     Idiomas > Idiomas de las apps.
     ===================================================================== -->
<locale-config xmlns:android="http://schemas.android.com/apk/res/android">
    <locale android:name="fr" />
    <locale android:name="en" />
</locale-config>

A partir de [Android] 13, el usuario puede entonces seleccionar el idioma de la aplicación en los ajustes del teléfono. El código del ejemplo:

// =========================================================================
// ex21/Ex21Activity.kt - una aplicación en dos idiomas
// -------------------------------------------------------------------------
// La forma de Android:
//   - los TEXTOS de la aplicación son RECURSOS: un archivo
//     res/values/strings.xml (el idioma predeterminado, aquí inglés) y un
//     archivo por traducción (res/values-fr/strings.xml). Cada texto tiene un
//     nombre; el código solo conoce este nombre (R.string.ex21_hello), y
//     Android elige el archivo según el idioma de la aplicación;
//   - stringResource(R.string.ex21_hello, "Marie"): el texto, cuyos
//     parámetros (%1$s) se reemplazan; pluralStringResource: un texto
//     en plural, cuya forma sigue las reglas del idioma;
//   - el idioma de la aplicación: el del teléfono... o el que la
//     aplicación elige por sí misma, AppCompatDelegate.setApplicationLocales.
//     Android entonces RECREA la actividad, en el nuevo idioma: los textos,
//     las fechas, los montos y los textos del propio Android (el
//     calendario, sus botones).
// El servidor de RdvMedecins, por su parte, solo devuelve CLAVES ("ERRORS.LOGIN_TAKEN"):
// se asocian con los recursos mediante una tabla (serverKeys).
// La actividad es una AppCompatActivity: la clase de actividad que puede
// aplicar el idioma elegido, incluso en las versiones de Android anteriores
// a la 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")

// lo que devolvería el servidor de RdvMedecins (cf. capítulo sobre la caja negra)
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")),
)

// la clave del servidor -> el recurso que la traduce
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() } }
    }
}

// elegir el idioma de la aplicación: Android lo guarda y recrea la actividad
fun changeLanguage(language: String) {
    AppCompatDelegate.setApplicationLocales(LocaleListCompat.forLanguageTags(language))
}

@Composable
fun TranslatedPage() {
    // rememberSaveable: el conteo sobrevive a la recreación de la actividad
    var count by rememberSaveable { mutableIntStateOf(2) }
    var calendarOpen by rememberSaveable { mutableStateOf(false) }
    // el idioma ACTUAL: el de la configuración de la actividad
    val locale = LocalConfiguration.current.locales[0]
    // formateadores en el idioma actual
    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),
        // los idiomas: botones "segmentados", en la barra superior
        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))
                // el plural: la categoría "zero" no existe ni en francés ni en
                // inglés (0 es "one" en francés, "other" en inglés): 0 se
                // trata por separado
                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)) }
                }
                // el calendario Material: sus textos siguen el idioma de la aplicación
                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)
                    // el recurso de la clave; sus parámetros, en orden (*: "esparce" el arreglo)
                    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 },
            // los textos OK / Cancel del propio Android, en el idioma de la aplicación
            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)
        }
    }
}
  • Líneas 92–94: el servidor RdvMedecins devuelve únicamente CLAVES (["ERRORS.LOGIN_TAKEN"]); estas se asocian a recursos mediante una tabla;
  • línea 97: una [AppCompatActivity]: la clase de actividad que sabe aplicar el idioma seleccionado, incluso antes de [Android] 13;
  • líneas 106–107: seleccionan el idioma de la APLICACIÓN (no el del teléfono): [Android] lo almacena y RECREA la actividad en el nuevo idioma. Antes de [Android] 13, la [AppCompat] biblioteca lo almacena (el servicio [AppLocalesMetadataHolderService] en el manifiesto, [autoStoreLocales]);
  • líneas 116–119: el idioma actual, que es el idioma especificado en la configuración de la actividad, y los formateadores de fecha y de importe para ese idioma;
  • línea 122: [stringResource(R.string.ex21_title)]: el texto en el idioma actual;
  • líneas 10–11: parámetros y una forma plural ([pluralStringResource]): como la categoría [zero] no existe ni en francés ni en inglés, el 0 se trata por separado;
  • líneas 170–171: la traducción de una clave del servidor, junto con sus parámetros ([*] “aplana” un arreglo en una lista de parámetros);
  • líneas 180–184: el texto del propio [Android] ([android.R.string.ok]) y el del calendario también siguen el idioma de la aplicación.

Image

Image

Image

El número de citas persiste a través de los cambios de idioma gracias a [rememberSaveable]: sin embargo, la actividad fue destruida y recreada.