Las actualizaciones Over-the-Air (OTA) ofrecen una forma flexible de enviar actualizaciones de traducción a aplicaciones móviles y web sin requerir una nueva versión en la App Store, Google Play u otras plataformas de implementación. Este enfoque admite la localización continua y los flujos de trabajo de desarrollo ágil al reducir los retrasos y los procesos manuales.
La función OTA en Phrase Strings se integra con las plataformas iOS, Android, React Native, Flutter, i18next y Rails. Las actualizaciones de las etiquetas de texto se envían instantáneamente a las aplicaciones móviles.
Debes crear una nueva versión para que se apliquen los ajustes actualizados. Todo el contenido incluido en una versión debe estar disponible en Phrase Strings, que transmite las traducciones directamente a la aplicación. Si el contenido no está presente, no se entregarán las traducciones.
Para aplicaciones móviles, OTA requiere integrar el Kit de desarrollo de software (SDK) correspondiente en la aplicación para recuperar las traducciones de Phrase Strings durante la ejecución.
Consejo
Para obtener detalles sobre distribución, versiones y referencia de la API, consulte el Centro de desarrolladores.
Al iniciar por primera vez en un dispositivo una aplicación que implementa el SDK de iOS, Android, React Native o Flutter, se genera un identificador de dispositivo único y aleatorio. Este identificador rastrea a los usuarios activos durante un período de tiempo determinado. No se utiliza para realizar ningún otro tipo de seguimiento ni contiene información sobre el usuario o el dispositivo.
El número de solicitudes OTA y la cantidad de usuarios activos mensuales (MAU) están limitados, según el plan de precios seleccionado.
MAU es el número de dispositivos únicos desde los cuales se solicitan traducciones. A cada dispositivo se le asigna un ID aleatorio. MAU se calcula en función del número de IDs únicos asignados en los últimos 30 días. Cada interacción con los servidores de Phrase se considera una solicitud.
Datos enviados con solicitudes OTA
El SDK se comunica con el servicio OTA para buscar actualizaciones e incluye los siguientes detalles en cada solicitud:
-
Identificador del dispositivo (p. ej. "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". Único para esta aplicación y, por lo tanto, no permite rastrear un dispositivo específico.)
-
Versión de la aplicación (p. ej. 1.2.0,
-
Última actualización del archivo de traducción (p. ej. 1542187679,
-
Versión del SDK (p. ej. 1.0.0,
-
Configuración regional (p. ej. "de-DE")
-
Formato de archivo (p. ej. "strings")
-
Cliente (p. ej. "ios")
-
ID de Distribución (ID de la distribución)
-
Secreto de entorno (para distinguir entre desarrollo y producción)
Dominios utilizados por los SDK:
Centro de datos de la UE
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
Centro de datos de EE. UU.
-
ota.us.phrase.com
-
cdn.us.phrase.com
Los SDK de OTA de Phrase están diseñados para garantizar que las aplicaciones sigan funcionando incluso si la API de OTA no está disponible. En tales casos, el SDK recurre a las últimas traducciones obtenidas correctamente almacenadas en el dispositivo, o a las traducciones integradas incluidas en el paquete de la aplicación. Esto evita errores o cadenas faltantes para los usuarios finales. Para garantizar una alternativa fiable, las traducciones incluidas deben mantenerse actualizadas con cada lanzamiento de la aplicación.
Las distribuciones son una configuración definida que determina cómo y dónde se entregan las actualizaciones OTA para una plataforma o proyecto específico.
Las plataformas de destino se definen dentro de la distribución:
-
iOS
-
Android
-
Aleteo
-
i18next
-
Rails
Es posible realizar múltiples distribuciones, pero lo ideal es que haya una distribución por proyecto. Si se utiliza una distribución para iOS y Android, los marcadores de posición para los dos formatos se convierten automáticamente.
Permisos
La gestión de las distribuciones y versiones de OTA está limitada por la asignación de proyectos. Los usuarios solo las gestionan en los proyectos a los que están asignados.
Los roles de Propietario, Administrador, Gestor de proyectos, Desarrollador y Diseñador tienen acceso completo a las distribuciones y versiones de OTA de forma predeterminada. El rol de Traductor no tiene acceso.
Los propietarios y administradores tienen acceso a todos los proyectos.
Los usuarios necesitan permisos a nivel de cuenta para gestionar distribuciones antes de crear una. La nueva distribución solo se vincula a los proyectos a los que el usuario puede acceder.
Para un control más detallado, los clientes Enterprise pueden ponerse en contacto con el equipo de soporte para solicitar un rol personalizado.
Fallbacks
Si se establecen alternativas de idioma en la configuración de idioma del proyecto al que está conectada la distribución, se mostrarán las cadenas del idioma seleccionado si el idioma solicitado existe, pero la clave no está traducida.
Si se utiliza un idioma específico de un país (p. ej., en-GB), pero no forma parte de la versión, el sistema puede recurrir a una versión estándar (p. ej., en) de ese idioma si existe en el proyecto. Si el idioma solicitado no se encuentra en absoluto, se puede ofrecer la configuración regional predeterminada del proyecto.
Los fallbacks no funcionarán en claves vinculadas.
La configuración del proyecto se aplica cuando se genera el archivo de versión. No depende de la opción en la pestaña .
La opción en la distribución se resuelve cuando un dispositivo solicita una versión. Cubre solo las claves faltantes o no traducidas, no las traducciones no verificadas.
Crear una distribución
Para crear una distribución, sigue estos pasos:
-
Desde el cuadro en la página , haz clic en Configure o en el número de configuraciones si ya existen algunas.
La página se abre y muestra las configuraciones existentes.
-
Haz clic en New distribution. Se abre la ventana .
-
En la pestaña General, proporcione un , con qué está asociada la distribución, los requeridos y las requeridas.
-
Para distribuciones de Android, haz clic en la pestaña Android para seleccionar la opción de formato que encierra cualquier traducción, incluidas las etiquetas HTML, en CDATA, si es necesario.
-
Después de seleccionar el proyecto para asociarlo con la distribución, la pestaña Scheduling estará disponible. Si es necesario, utilice esta pestaña para configurar versiones programadas OTA en la distribución.
-
-
En la pestaña Fallback languages, seleccione la configuración de respaldo específica de la distribución según sea necesario. Las opciones de respaldo se priorizan tal como se muestran en la lista.
-
Opcionalmente, haga clic en la pestaña Translations para seleccionar la opción de utilizar la versión revisada más reciente de las traducciones. Habilite esta opción solo cuando trabaje con el flujo de trabajo de revisión avanzado.
-
Haz clic en Guardar.
Los detalles de la distribución se muestran con los ID requeridos por los SDK. Los detalles se pueden volver a mostrar haciendo clic en la distribución desde la página .
Para actualizar las traducciones, cree una nueva versión dentro de la distribución. El estado actual del proyecto se exporta y se pone a disposición de los clientes conectados.
Para crear una versión, siga estos pasos:
-
Desde la página Over the air, haz clic en Añadir versión junto a la distribución requerida.
Se abre la ventana .
-
Proporcione una , la requerida, la , las y las .
Las configuraciones regionales que aún no se han añadido a la lista de idiomas de la distribución aparecen sin seleccionar y no están disponibles para su selección. Añade los idiomas requeridos a la distribución para que puedas seleccionarlos en futuras versiones.
Si no seleccionas manualmente ningún locale al crear una versión, se incluirán por defecto todos los locales configurados en la distribución.
Si es necesario, introduce etiquetas para incluir solo las claves con etiquetas específicas en la versión. Añadir un filtro de etiquetas a una versión incluye solo las claves que contienen esa etiqueta. Las claves sin la etiqueta se excluyen por completo de la versión, y la aplicación conectada recurre a los archivos de traducción estáticos incluidos localmente en su código base para esas claves. El filtrado por etiquetas funciona independientemente de ramificación: si la ramificación está habilitada, selecciona la rama y la(s) etiqueta(s) relevantes; si la ramificación no está habilitada, selecciona solo la(s) etiqueta(s) relevantes.
-
Haz clic en Guardar.
La versión se añade a la lista en la parte inferior de la página de detalles de la distribución.
Para configurar programaciones recurrentes para publicar la distribución, sigue estos pasos:
-
Desde la página , haz clic en el icono de la rueda dentada
junto a la distribución requerida.
Se muestra la ventana .
-
Selecciona la pestaña Programar versión y haz clic en .
Se muestran las opciones de programación de versiones.
-
En el menú desplegable , elige la frecuencia de la versión seleccionando una de las opciones disponibles:
-
-
Selecciona los días de la semana deseados para las versiones programadas.
-
-
Proporciona una hora y una relevante.
-
Si es necesario, selecciona , y para las versiones programadas.
-
El campo solo se muestra si la ramificación está habilitada en el proyecto. Seleccionar una rama actualiza la lista de locales e idiomas.
-
-
Opcionalmente, especifica las versiones de la aplicación en los campos y .
Déjalo en blanco para aplicar el lanzamiento programado a todas las versiones de la aplicación.
-
Haz clic en Guardar.
La distribución se actualiza con la información de programación del lanzamiento.
Deshabilitar la programación detiene el lanzamiento automático de la distribución, pero se guardan los ajustes configurados.
Nota
No hay ninguna opción en la interfaz de usuario de Strings para pausar o deshabilitar temporalmente OTA. Para evitar que una aplicación obtenga traducciones, elimina el ID de distribución de la configuración OTA de la aplicación; restaura el ID para reanudar OTA. Como último recurso, elimina la distribución y crea una nueva.
Integrar el SDK móvil o la biblioteca web adecuados permite actualizar las traducciones con un solo clic, pero también proporciona métricas para medir el uso. Los informes del SDK móvil y la biblioteca web ofrecen información valiosa sobre los usuarios activos de la aplicación y sus idiomas. Este conjunto de informes está disponible para cada distribución y los datos se actualizan dos veces al día.
Se proporcionan informes sobre el número de usuarios activos, las solicitudes totales, las solicitudes por idioma, las solicitudes por plataforma y los idiomas de dispositivo no proporcionados.
Los informes de cada distribución se acceden a través del icono en la página .
El número de usuarios activos que se muestra en estos informes refleja una ventana móvil de 30 días basada en la fecha actual, no un período fijo de calendario o de ciclo de facturación.
La documentación técnica para integrar los SDK de OTA está disponible en el archivo README de cada repositorio de proyecto: