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.
Se debe 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 ID ú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")
-
Distribution ID (ID de la distribución)
-
Secreto del entorno (para distinguir el desarrollo de la producción)
Dominios usados por los SDKs:
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 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 tener varias distribuciones, pero lo ideal es una distribución por proyecto. Si se utiliza una distribución para iOS y Android, los marcadores de posición para ambos 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 se adjunta solo 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.
Alternativas (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 respaldos no funcionarán en claves vinculadas.
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, proporciona un , el al que se asocia la distribución, y los y las requeridas.
-
Para las 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 que se asociará con la distribución, la pestaña Scheduling queda disponible. Si es necesario, usa esta pestaña para programar lanzamientos 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 última versión revisada de las traducciones. Activa esta opción solo cuando trabajes 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 SDKs. Los detalles se pueden mostrar nuevamente 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 Add release junto a la distribución requerida.
Se abre la ventana .
-
Proporciona una , la , , y las requeridas.
Los locales 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ñada los idiomas requeridos a la distribución para que puedan seleccionarse en futuras versiones.
Si no se selecciona manualmente ningún locale al crear una versión, todos los locales configurados en la distribución se incluyen en la versión de forma predeterminada.
Si es necesario, introduzca 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 publicació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, seleccione la rama y la(s) etiqueta(s) relevante(s); si la ramificación no está habilitada, seleccione solo la(s) etiqueta(s) relevante(s).
-
Haz clic en Guardar.
La publicació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 la publicación de la distribución, siga 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 publicación y haz clic en .
Se muestran las opciones de programación de publicaciones.
-
Desde el menú desplegable , elige la frecuencia de publicación seleccionando una de las opciones disponibles:
-
-
Selecciona los días de la semana deseados para las publicaciones programadas.
-
-
Proporciona una hora y la correspondiente.
-
Si es necesario, selecciona , y para las publicaciones programadas.
-
El campo solo se muestra si la ramificación está habilitada en el proyecto. Al seleccionar una rama se actualiza la lista de localizaciones e idiomas.
-
-
Opcionalmente, especifica las versiones de la aplicación en los campos y .
Déjalo en blanco para aplicar la publicación programada a todas las versiones de la aplicación.
-
Haz clic en Guardar.
La distribución se actualiza con la información de programación de publicaciones.
Desactivar la programación detiene la publicación automática de la distribución, pero se guardan los ajustes configurados.
Nota
No existe ninguna opción en la interfaz de usuario de Strings para pausar o desactivar 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.
La integración del SDK móvil o de la biblioteca web adecuada 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 generales, las solicitudes por idioma, las solicitudes por plataforma y sobre los idiomas de los dispositivos que no están disponibles.
Se accede a los informes de cada distribución 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 calendario fijo ni un período 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 del proyecto: