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 entre desarrollo y producción)
Dominios utilizados por los SDK:
datacenter: 'eu',
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
datacenter: "us",
-
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 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 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 distribuciones y versiones OTA está limitada por la asignación del proyecto. Los usuarios solo las gestionan en los proyectos a los que están asignados.
Los roles de propietario, administrador, project manager, desarrollador y diseñador tienen acceso completo a las distribuciones y versiones OTA de forma predeterminada. El rol de traductor no tiene acceso.
Los propietarios y administradores tienen acceso a todos los proyectos.
Los usuarios necesitan permiso a nivel de cuenta para gestionar distribuciones antes de crear una. La nueva distribución se vincula solo a proyectos a los que el usuario puede acceder.
Para un control más detallado, los clientes Enterprise pueden contactar al equipo de soporte sobre un rol Personalizar.
Fallbacks
Si se establecen idiomas de respaldo 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 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 localización predeterminada del proyecto.
Los respaldos 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. La ventana se abre.
-
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, incluidos los códigos 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, usar esta pestaña para la configuración de lanzamientos programados 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 usar la versión más reciente de las traducciones que ha sido revisado. 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 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 de .
-
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 su selección. 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 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 base de código para esas claves. El filtrado 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 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 publicar la distribución, siga estos pasos:
-
Desde la página , haga clic en el icono de rueda dentada
junto a la distribución requerida.
Se muestra la ventana .
-
Seleccionar la pestaña Programar versión 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 , 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 se muestra solo si la ramificación está habilitada 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 .
Deje 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 guardada se mantiene.
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 de la biblioteca web o el SDK móvil apropiado permite actualizar las traducciones con un solo clic, pero también proporciona métricas para medir el uso. Los informes de la biblioteca web y el SDK móvil 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 activo, 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 .
El número de usuarios activo 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 la integración de los SDK OTA está disponible en el archivo README de cada repositorio de proyecto: