Android-Apps mit KI lokalisieren

Android-Apps für kontinuierliche Lokalisierung vorbereiten (mit Demo-App-Beispielen)

Nachdem Sie nun gesehen haben, wie PTC den Übersetzungsprozess automatisiert, stellen wir sicher, dass Ihre Android-App dafür bereit ist.

Dieser Abschnitt zeigt, wie Sie Ihr Projekt strukturieren, damit PTC Aktualisierungen Ihrer strings.xml Datei erkennen und Ihre Übersetzungen automatisch auf dem neuesten Stand halten kann.

Wir beginnen mit einer einfachen Jetpack Compose App, die fest codierten Text verwendet, und wandeln sie in ein lokalisierbares Projekt mit ordnungsgemäß organisierten Ressourcen um.

Das werden wir behandeln:

• Text von Kotlin nach verschieben strings.xml
• Lokalisierte Ressourcen unter organisieren res/values-{{lang}}
• Fügen Sie Placeholders und Plurale hinzu, um dynamischen Text und Mengen zu verarbeiten
• Sehen Sie, wie PTC Übersetzungen für neue oder geänderte Zeichenketten automatisch aktualisiert

1. Fest codierte Zeichenketten in strings.xml extrahieren

Beginnen Sie, indem Sie benutzerorientierten Text aus Ihrem Jetpack Compose-Code in eine String-Ressourcendatei verschieben. Dies ist die Grundlage der Android-Lokalisierung und ermöglicht es PTC, übersetzbare Inhalte zu erkennen.

@Composable
fun Greeting(name: String, modifier: Modifier = Modifier) {
 Text(
 text = "Hello $name!", // Hardcoded string
 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 // 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
 )
}

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. Kontinuierliche Lokalisierung in PTC einrichten

Nachdem Ihre strings.xml-Datei vorhanden ist, können Sie PTC einrichten und Übersetzungen erstellen.

1. Registrieren Sie sich oder melden Sie sich bei PTC an.
2. Erstellen Sie ein neues Projekt. Der Setup-Assistent führt Sie durch die Beschreibung Ihres Projekts, damit PTC kontextbezogene Übersetzungen generieren kann.
3. Wählen Sie aus, wie Sie PTC für die kontinuierliche Lokalisierung in Ihr Projekt integrieren möchten. Sie können Ihr GitHub-, GitLab– oder Bitbucket-Repository verbinden, oder verwenden Sie die PTC-API, um die Lokalisierung in Ihre CI/CD-Pipeline zu integrieren.
4. Konfigurieren Sie die Dateimuster:

• Quelldatei: app/src/main/res/values/strings.xml
• Übersetzungsdateien: app/src/main/res/values-{{lang}}/strings.xml
• Dateityp: Android-XML

Nachdem Sie die Einrichtung abgeschlossen haben, generiert PTC automatisch neue Ordner mit übersetzten Dateien (z. B. res/values-fr/strings.xml) und öffnet eine Zusammenführungsanfrage in Ihrem Repository.

3. Verwenden Sie Placeholders für dynamische Inhalte

Nachdem Sie nun gesehen haben, wie PTC Ihre ersten Übersetzungen verarbeitet, machen wir die App realistischer, indem wir dynamische Zeichenketten hinzufügen. Dies sind Zeichenketten, die sich ändernde Werte enthalten – wie z. B. den Namen eines Benutzers.

<resources>
    <string name="welcome_user">Willkommen, %1$s!</string>
    <string name="points_summary">%1$s, Sie haben %2$d Punkte.</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)
 ) {
 // 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)
 }
}

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)
    }
}

Da Ihr Projekt kontinuierliche Lokalisierung verwendet, erkennt PTC diese neuen Zeichenketten automatisch, wenn Sie einen Commit durchführen.

4. Fügen Sie Plurale für mengenbasierte Zeichenketten hinzu

Als Nächstes behandeln wir Pluralformen – wie „1 Nachricht“ vs. „5 Nachrichten“. Android unterstützt dies nativ, und PTC übersetzt jede Pluralform automatisch.

<resources>
    <plurals name="inbox_count">
        <item quantity="one">%d neue Nachricht</item>
        <item quantity="other">%d neue Nachrichten</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)
 ) {
 // 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)
}

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)
}

Wenn Sie diese Änderungen pushen, erkennt und übersetzt PTC automatisch die neuen Pluralzeichenketten.