Localizza app Android con l’AI

Preparare app Android per la localizzazione continua (con esempi di app demo)

Ora che hai visto come PTC automatizza il processo di traduzione, assicuriamoci che la tua app Android sia pronta per questo.

Questa sezione mostra come strutturare il tuo progetto in modo che PTC possa rilevare gli aggiornamenti al tuo file strings.xml e mantenere automaticamente aggiornate le tue traduzioni.

Inizieremo con una semplice app Jetpack Compose che utilizza testo hardcoded e la trasformeremo in un progetto localizzabile con risorse opportunamente organizzate.

Ecco cosa tratteremo:

• Spostare il testo da Kotlin in strings.xml
• Organizzare le risorse localizzate sotto res/values-{{lang}}
• Aggiungere placeholder e plurali per gestire testo dinamico e quantità
• Vedere come PTC aggiorna automaticamente le traduzioni per stringhe nuove o modificate

1. Estrarre stringhe hardcoded in strings.xml

Inizia spostando il testo rivolto all’utente dal tuo codice Jetpack Compose in un file di risorse stringa. Questa è la base della localizzazione Android e permette a PTC di rilevare il contenuto traducibile.

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

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

<resources>
    <string name="hello_text">Ciao %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 // modifica se il nome del tuo pacchetto è diverso

@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. Configurare la localizzazione continua in PTC

Con il tuo file strings.xml a posto, sei pronto per configurare PTC e creare traduzioni.

1. Registrati o accedi a PTC.
2. Crea un nuovo progetto. Il wizard di configurazione ti guiderà nella descrizione del tuo progetto in modo che PTC possa generare traduzioni sensibili al contesto.
3. Scegli come integrare PTC con il tuo progetto per la localizzazione continua. Puoi connettere il tuo repository GitHub, GitLab o Bitbucket, o usare l’API di PTC per integrare la localizzazione nella tua pipeline CI/CD.
4. Configura i pattern dei file:

• File sorgente: app/src/main/res/values/strings.xml
• File di traduzione: app/src/main/res/values-{{lang}}/strings.xml
• Tipo di file: Android XML

Dopo aver completato la configurazione, PTC genera automaticamente nuove cartelle con file tradotti (ad esempio, res/values-fr/strings.xml) e apre una richiesta di merge nel tuo repository.

3. Usare i placeholder per contenuti dinamici

Ora che hai visto come PTC gestisce le tue traduzioni iniziali, rendiamo l’app più realistica aggiungendo stringhe dinamiche. Si tratta di stringhe che includono valori variabili, come il nome di un utente.

<resources>
    <string name="welcome_user">Benvenuto, %1$s!</string>
    <string name="points_summary">%1$s, hai %2$d punti.</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)
 ) {
 // mantieni Greeting
 Greeting(name = "Android")

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

  // demo dei placeholder
 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)
    }
}

Poiché il tuo progetto usa la localizzazione continua, PTC rileverà automaticamente queste nuove stringhe quando effettui il commit.

4. Aggiungere plurali per stringhe basate sulla quantità

Successivamente, gestiamo le forme plurali — come “1 messaggio” vs. “5 messaggi”. Android lo supporta nativamente e PTC traduce automaticamente ogni forma plurale.

<resources>
    <plurals name="inbox_count">
        <item quantity="one">%d nuovo messaggio</item>
        <item quantity="other">%d nuovi messaggi</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)
 ) {
 // mantieni Greeting
 Greeting(name = "Android")

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

  // demo dei plurali
 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)
}

Quando invii queste modifiche, PTC rileva e traduce automaticamente le nuove stringhe plurali.