Las actualizaciones por el aire (OTA) ofrecen una forma flexible de Entregar actualizaciones de traducción a aplicaciones móvil 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 las demoras 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 para las etiquetas de texto se envían instantáneamente a las aplicaciones móvil.
Se debe crear una nueva versión para que se aplique la configuración actualizada. Todo 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, las traducciones no se Entregarán.
Para aplicaciones móvil, OTA requiere integrar el Kit de Desarrollo de Software (SDK)<1> relevante en la aplicación para recuperar traducciones de Phrase Strings en tiempo de ejecución.
Al iniciar una aplicación que implementa el SDK de iOS, Android, React Native o Flutter por primera vez en un dispositivo, se genera un identificador de dispositivo único y aleatorio. Este identificador rastrea a los usuarios activo 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 activo Mensuales (MAU) están limitados, dependiendo del 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 verificar actualizaciones e incluye los siguientes detalles con cada solicitud:
-
Identificador de 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 actualizar del archivo de traducción (p. ej. "1542187679")
-
Versión del SDK (p. ej. "1.0.0")
-
Localización (p. ej. "de-DE")
-
Formato de archivo (p. ej. "Strings")
-
Cliente (p. ej. "ios")
-
Distribución ID (ID de la distribución)
-
Secreto del 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 Phrase OTA 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 Strings obtenidas correctamente y almacenadas en el dispositivo, o a las Strings incluidas en el paquete de la aplicación. Esto evita errores o Strings faltantes para los usuarios finales. Para garantizar una alternativa fiable, las Strings incluidas deben mantenerse actualizadas con cada lanzamiento de la aplicación.
Las distribuciones son una configuración que define cómo y dónde se entregan las actualizaciones OTA para una plataforma o proyecto específico.
Las plataformas meta se definen dentro de la distribución:
-
iOS
-
Android
-
Aleteo
-
i18next
-
Rails
Son posibles múltiples distribuciones, pero idealmente hay una distribución por proyecto. Si usa una distribución para iOS y Android, los marcadores de posición para los dos formatos se convierten automáticamente.
Fallbacks
Si los idiomas de respaldo están configurados en la configuración de idioma del proyecto al que está conectada la distribución, se mostrarán los Strings del idioma seleccionado si existe el idioma solicitado, pero la clave no está traducida.
Si se usa un idioma específico de un país (p. ej., en-GB), pero no es 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 servir la localización predeterminada del proyecto en su lugar.
Los fallbacks no funcionarán en linked keys.
Crear una distribución
Para crear una distribución, siga estos pasos:
-
Desde el cuadro en la página , haga clic en Configure o en el número de configuraciones si ya existen algunas.
La página se abre y muestra las configuraciones existentes.
-
Haga 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, haga clic en la pestaña Android para Seleccionar la opción de formato que encierra cualquier traducción que incluya etiquetas HTML en CDATA, si es necesario.
-
Después de Seleccionar el proyecto para asociar con la distribución, la pestaña Scheduling estará disponible. Si es necesario, use esta pestaña para configuración de lanzamientos programados por el aire en la distribución.
-
-
En la pestaña Fallback languages, Seleccionar la configuración de idioma 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 Traducciones para Seleccionar la opción de usar la última versión revisado de las traducciones. Habilitar esta opción solo cuando trabaje con el flujo de trabajo de revisión avanzado.
-
Haz clic en Guardar.
Los detalles de distribución se muestran con los ID requeridos por los SDK. Los detalles se pueden mostrar nuevamente haciendo clic en la distribución desde la página .
Para actualizar las traducciones, Crear un nuevo lanzamiento dentro de la distribución. El estado actual del proyecto se exporta y se pone a disposición de los clientes conectados.
Para Crear un lanzamiento, siga estos pasos:
-
Desde la página por el aire, haga clic en Agregar lanzamiento junto a la distribución requerida.
Se abre la ventana .
-
Proporcione una , la requerida, la , los y las .
Si es necesario, ingrese etiquetas para incluir solo las claves con etiquetas específicas en el lanzamiento.
-
Haz clic en Guardar.
El lanzamiento se agrega a la lista en la parte inferior de la página de detalles de la distribución.
Para realizar la configuración de programas recurrentes para lanzar la distribución, siga estos pasos:
-
Desde la página por el aire, haga clic en el icono de rueda dentada
junto a la distribución requerida.
Se muestra la ventana .
-
Seleccionar la pestaña Programar lanzamiento y haga clic en .
Se muestran las opciones de programación de lanzamientos.
Nota
Las opciones de programación también están disponibles tras la creación de una nueva distribución.
-
En el menú desplegable , elija la frecuencia de la versión seleccionando una de las opciones disponibles:
-
-
Seleccionar los días de la semana deseados para las versiones programadas.
-
-
Proporcione una hora y la correspondiente.
-
Si es necesario, seleccionar , e para las versiones programadas.
-
El campo solo se muestra si la ramificación está activada en el proyecto. Seleccionar una rama actualiza la lista de configuraciones regionales e idiomas.
-
-
Opcionalmente, especifique las versiones de la aplicación en los campos y .
Dejar en blanco para aplicar la versió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 la versión.
Desactivar la programación detiene la versión automática de la distribución, pero la configuración establecida se guarda.
La integración del 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 de 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 los idiomas de dispositivo no proporcionados.
Se accede a los informes de cada distribución a través del icono en la página .
La documentación técnica para integrar los SDK OTA está disponible en el archivo README de cada repositorio de proyecto: