Las actualizaciones por el aire (OTA) ofrecen una forma flexible de entregar 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 despliegue. 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 plataformas iOS, Android, React Native, Flutter, i18next y Rails. Las actualizaciones para 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 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, las traducciones no se entregarán.
Para aplicaciones móvil, OTA requiere integrar el Software Development Kit (SDK) relevante en la aplicación para recuperar traducciones de Phrase Strings en tiempo de ejecución.
Consejo
Para obtener detalles sobre distribución, lanzamiento y referencia de API, consulte el Developer Hub.
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 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, 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 buscar actualizaciones e incluye los siguientes detalles en cada solicitud:
-
Identificador de dispositivo (p. ej. "F3AFCB10-80A2-84CB-94C0-27F5EF58876D". Único para esta aplicación y, por lo tanto, no permite el seguimiento de 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")
-
ID de distribución (ID de la distribución)
-
Secreto del entorno (para distinguir el desarrollo de la 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 traducciones obtenidas correctamente y almacenadas en el dispositivo, o a las traducciones incluidas en el paquete de la aplicación. Esto evita errores o la falta de Strings 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 meta se definen dentro de la distribución:
-
iOS
-
Android
-
Aleteo
-
i18next
-
Rails
Es posible tener múltiples distribuciones, pero lo ideal es que haya 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.
Alternativas
Si se establecen alternativas de idioma en la configuración de idioma del proyecto al que está conectada la distribución, se mostrarán los Strings del idioma seleccionado si el idioma solicitado existe, 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<3>) 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.
Las alternativas no funcionarán en claves vinculadas.
Crear una distribución
Para crear una distribución, siga estos pasos:
-
Desde el cuadro en la página , haga clic en Configurar o en el número de configuraciones si ya existen algunas.
Se abre la página y muestra las configuraciones existentes.
-
Haga clic en Nueva distribución. 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 Programación estará disponible. Si es necesario, use esta pestaña para configuración de lanzamientos programados OTA en la distribución.
-
-
En la pestaña Idiomas de reserva, Seleccionar la configuración de reserva específica de la distribución según sea necesario. Las opciones de reserva 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 revisada 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 la distribución se muestran con los ID requeridos por los SDK. Los detalles se pueden mostrar de nuevo haciendo clic en la distribución desde la página .
Para actualizar las traducciones, Crear 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 por el aire, haga clic en Agregar versión junto a la distribución requerida.
Se abre la ventana .
-
Proporcione una , la requerida, la , los y las .
Los idiomas que aún no se han agregado a la lista de idiomas de la distribución aparecen sin seleccionar y no están disponibles para Seleccionar. Agregar los idiomas requeridos a la distribución para que se puedan Seleccionar en futuras versiones.
Si no se seleccionan idiomas manualmente al Crear una versión, todos los idiomas configurados en la distribución se incluyen en la versión de forma predeterminada.
Si es necesario, ingrese etiquetas para incluir solo las claves con etiquetas específicas en la versión. Agregar un filtro de etiqueta a una versión incluye solo las claves que llevan 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 base de código para esas claves. El filtrar por etiqueta funciona independientemente de la ramificación: si la ramificación está habilitada, Seleccionar la rama y la(s) etiqueta(s) relevante(s); si la ramificación no está habilitada, Seleccionar solo la(s) etiqueta(s) relevante(s).
-
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 realizar la configuración de programaciones recurrentes para publicar la distribución, seguir estos pasos:
-
Desde la página , hacer clic en el icono de rueda dentada
junto a la distribución requerida.
Se muestra la ventana .
-
Seleccionar la pestaña de programación de versiones y hacer clic en .
Se muestran las opciones de programación de versiones.
Nota
Las opciones de programación también están disponibles al crear una nueva distribución.
-
Desde el menú desplegable , elegir la frecuencia de versión seleccionando una de las opciones disponibles:
-
-
Seleccionar los días de la semana deseados para las versiones programadas.
-
-
Proporcionar una hora y la correspondiente.
-
Si es necesario, seleccionar , y para las versiones programadas.
-
El campo se muestra solo si la ramificación está habilitada en el proyecto. Seleccionar una rama actualiza la lista de configuraciones regionales e idiomas.
-
-
Opcionalmente, especificar 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 versiones.
Deshabilitar la programación detiene la versión automática de la distribución, pero la configuración establecida se guarda.
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, eliminar el ID de distribución de la configuración OTA de la aplicación; restaurar el ID para reanudar OTA. Como último recurso, eliminar la distribución y crear una nueva.
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 la biblioteca web ofrecen información valiosa sobre los usuarios activos de la aplicación y sus idiomas de aplicación. 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 la integración de los SDK OTA está disponible en el archivo README de cada repositorio de proyecto: