localize.dev

Documentación / Traducir / Android strings.xml

Traducir Android strings.xml

Traduce res/values/strings.xml en carpetas values-<lang>, con argumentos %1$s, <plurals>, <xliff:g> y escape de apóstrofes manejados, y cadenas translatable="false" omitidas.

Cómo funciona

localize-dev translate lee res/values/strings.xml, o composeResources/values/ de Compose Multiplatform, y escribe values-ru/strings.xml, values-pt-rBR/strings.xml y el resto. Las cadenas marcadas con translatable="false" se omiten, y el comentario XML encima de una cadena se envía al modelo como contexto.

El texto se desempaqueta antes de la traducción y se vuelve a empaquetar después, por lo que You\'ve sigue siendo válido y una comilla simple en una traducción francesa o italiana no rompe la compilación. CDATA sigue siendo CDATA.

Antes y después

Salida real de localize-dev translate --locales ru en el primer archivo. El ruso necesita few y many, el nombre de la aplicación no se traduce y el span <xliff:g> se mantiene como está escrito.

res/values/strings.xml
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="app_name" translatable="false">Trailmap</string>
    <!-- Shown on the home screen above the list of trails -->
    <string name="home_title">Trails near you</string>
    <string name="saved_trail">You\'ve saved %1$s to <xliff:g id="list">%2$s</xliff:g></string>
    <plurals name="trails_found">
        <item quantity="one">%d trail found</item>
        <item quantity="other">%d trails found</item>
    </plurals>
</resources>
res/values-ru/strings.xml · ruso
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="home_title">Трейлы рядом с вами</string>
    <string name="saved_trail">Вы сохранили %1$s в <xliff:g id="list">%2$s</xliff:g></string>
    <plurals name="trails_found">
        <item quantity="one">%d трейл найден</item>
        <item quantity="few">%d трейла найдено</item>
        <item quantity="many">%d трейлов найдено</item>
        <item quantity="other">%d трейлов найдено</item>
    </plurals>
</resources>

Lo que se mantiene intacto

  • %1$s, %d y otros argumentos de formato, verificados
  • <xliff:g> spans, conservados exactamente como están escritos
  • <plurals> con las cantidades que usa cada idioma
  • Marcas en línea como <b>, y CDATA donde la fuente lo tiene

Errores comunes y cómo se evitan

Apóstrofes sin escapar

“l’application” tiene que escribirse l\'application en strings.xml, o el compilador de recursos fallará la compilación. Cada traducción se escapa al entrar en el archivo.

Cantidades faltantes

El ruso, el polaco y el árabe usan few y many. Con solo one y other, getQuantityString recurre a other para recuentos como 3, y la gramática es incorrecta.

Traducir lo que debe permanecer

Los nombres de las aplicaciones y el contenido <xliff:g>, como el nombre de un producto o una variable, a menudo se traducen. Las cadenas translatable="false" se omiten y los spans <xliff:g> se enmascaran para que el modelo nunca los vea como texto.

Ejecutar

En la carpeta que contiene tus archivos de localización. Los idiomas que aún no tienen archivo obtienen uno. --dry-run muestra qué cambiaría primero.

npx localize-dev login

# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,de

Luego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:

npx localize-dev check --only translations

Gratis para 1000 cadenas al mes. Una cadena cuenta una vez sin importar en cuántos idiomas se incluya. Crea una cuenta gratuita

Guías para aplicaciones que usan este formato

Cuando el texto todavía está codificado en tu código, localize-dev run lo mueve a este formato primero.