Localice aplicaciones de Android con IA

Preparación de aplicaciones Android para la localización continua (con ejemplos de aplicaciones de demostración)

Ahora que ha visto cómo PTC automatiza el proceso de traducción, asegúrese de que su aplicación Android esté lista para ello.

Esta sección muestra cómo estructurar su proyecto para que PTC pueda detectar actualizaciones en su archivo strings.xml y mantener automáticamente sus traducciones actualizadas.

Comenzaremos con una aplicación sencilla de Jetpack Compose que utiliza texto codificado y la convertiremos en un proyecto localizable con recursos organizados correctamente.

Esto es lo que cubriremos:

• Mover texto de Kotlin a strings.xml
• Organizar los recursos localizados en res/values-{{lang}}
• Añadir marcadores de posición y plurales para gestionar texto y cantidades dinámicas
• Vea cómo PTC actualiza automáticamente las traducciones de cadenas nuevas o modificadas

1. Extraer cadenas codificadas en strings.xml

Comience por mover el texto orientado al usuario desde su código Jetpack Compose a un archivo de recursos de cadena. Esta es la base de la localización de Android y permite que PTC detecte el contenido traducible.

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
 Text(
 text = "Hello $name!", // Cadena codificada
 modifier = modifier
 )
}

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    Text(
        text = "Hello $name!", // Hardcoded string
        modifier = modifier
    )
}

<resources>
    <string name="hello_text">Hello %1$s!</string>
</resources>

<resources>
    <string name="hello_text">Hello %1$s!</string>
</resources>

import androidx.compose.ui.res.stringResource
import com.example.androidappdemo.R // ajústelo si su nombre de paquete es diferente

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
 val hello = stringResource(id = R.string.hello_text, name)
 Text(
 text = hello,
 modifier = modifier
 )
}

import androidx.compose.ui.res.stringResource
import com.example.androidappdemo.R   // adjust if your package name differs

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
    val hello = stringResource(id = R.string.hello_text, name)
    Text(
        text = hello,
        modifier = modifier
    )
}

2. Configurar la localización continua en PTC

Con su archivo strings.xml en su lugar, está listo para configurar PTC y crear traducciones.

1. Regístrese o inicie sesión en PTC.
2. Cree un nuevo proyecto. El asistente de configuración le guiará a través de la descripción de su proyecto para que PTC pueda generar traducciones con reconocimiento de contexto.
3. Elija cómo integrar PTC con su proyecto para la localización continua. Puede conectar su repositorio de GitHub, GitLab o Bitbucket, o utilice la API de PTC para integrar la localización en su canalización de CI/CD.
4. Configure los patrones de archivo:

• Archivo de origen: app/src/main/res/values/strings.xml
• Archivos de traducción: app/src/main/res/values-{{lang}}/strings.xml
• Tipo de archivo: Android XML

Después de completar la configuración, PTC genera automáticamente nuevas carpetas con archivos traducidos (por ejemplo, res/values-fr/strings.xml) y abre una solicitud de combinación en su repositorio.

3. Utilice marcadores de posición para contenido dinámico

Ahora que ha visto cómo PTC gestiona sus traducciones iniciales, hagamos que la aplicación sea más realista añadiendo cadenas dinámicas. Estas son cadenas que incluyen valores cambiantes, como el nombre de un usuario.

<resources>
    <string name="welcome_user">Welcome, %1$s!</string>
    <string name="points_summary">%1$s, you have %2$d points.</string>
</resources>

<resources>
    <string name="welcome_user">Welcome, %1$s!</string>
    <string name="points_summary">%1$s, you have %2$d points.</string>
</resources>

AndroidDemoTheme {
 Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
 Column(
 modifier = Modifier
 .padding(innerPadding)
 .padding(16.dp)
 ) {
 // mantener Greeting
 Greeting(name = "Android")

  Spacer(modifier = Modifier.height(16.dp))

  // demostración de marcadores de posición
 Header(name = "PTC", points = 42)

  Spacer(modifier = Modifier.height(16.dp))
 }


@Composable
fun Header(name: String, points: Int) {
 val welcome = stringResource(R.string.welcome_user, name)
 val summary = stringResource(R.string.points_summary, name, points)

  Column(modifier = Modifier.padding(16.dp)) {
 Text(welcome)
 Text(summary)
 }
}

AndroidDemoTheme {
         Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
                    Column(
                        modifier = Modifier
                            .padding(innerPadding)
                            .padding(16.dp)
                    ) {
                        // keep Greeting
                        Greeting(name = "Android")

                        Spacer(modifier = Modifier.height(16.dp))

                        // placeholders demo
                        Header(name = "PTC", points = 42)

                        Spacer(modifier = Modifier.height(16.dp))
                    }


@Composable
fun Header(name: String, points: Int) {
    val welcome = stringResource(R.string.welcome_user, name)
    val summary = stringResource(R.string.points_summary, name, points)

    Column(modifier = Modifier.padding(16.dp)) {
        Text(welcome)
        Text(summary)
    }
}

Debido a que su proyecto utiliza la localización continua, PTC detectará estas nuevas cadenas automáticamente cuando realice el commit.

4. Añadir plurales para cadenas basadas en la cantidad

A continuación, gestionemos las formas plurales, como “1 mensaje” frente a “5 mensajes”. Android es compatible con esto de forma nativa, y PTC traduce cada forma plural automáticamente.

<resources>
    <plurals name="inbox_count">
        <item quantity="one">%d mensaje nuevo</item>
        <item quantity="other">%d mensajes nuevos</item>
    </plurals>
</resources>

<resources>
    <plurals name="inbox_count">
        <item quantity="one">%d new message</item>
        <item quantity="other">%d new messages</item>
    </plurals>
</resources>

import androidx.compose.ui.res.pluralStringResource

AndroidDemoTheme {
 Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
 Column(
 modifier = Modifier
 .padding(innerPadding)
 .padding(16.dp)
 ) {
 // mantener Greeting
 Greeting(name = "Android")

  Spacer(modifier = Modifier.height(16.dp))

  // demostración de plurales
 InboxCount(count = 1)
 InboxCount(count = 5)
 }


@Composable
fun InboxCount(count: Int) {
 val text = pluralStringResource(R.plurals.inbox_count, count, count)
 Text(text)
}

import androidx.compose.ui.res.pluralStringResource

AndroidDemoTheme {
        Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
                    Column(
                        modifier = Modifier
                            .padding(innerPadding)
                            .padding(16.dp)
                    ) {
                        // keep Greeting
                        Greeting(name = "Android")

                        Spacer(modifier = Modifier.height(16.dp))

                        // plurals demo
                        InboxCount(count = 1)
                        InboxCount(count = 5)
                    }


@Composable
fun InboxCount(count: Int) {
    val text = pluralStringResource(R.plurals.inbox_count, count, count)
    Text(text)
}

Cuando envíe estos cambios, PTC detectará y traducirá automáticamente las nuevas cadenas plurales.