Control de versiones de cliente y servidor en Mobile Apps y Mobile Services
La versión más reciente de Azure Mobile Services es la característica Mobile Apps de Azure App Service.
Los SDK de cliente y servidor de Mobile Apps originalmente se basaban en los de Mobile Services, pero no son compatibles entre sí.
Es decir, debe usar el SDK de cliente de Mobile Apps con un SDK de servidor de Mobile Apps y algo parecido sucede con Mobile Services. Este contrato se aplica a través de un valor de encabezado especial usado por los SDK de cliente y servidor, ZUMO-API-VERSION.
Nota: cada vez que este documento hace referencia a un back-end de Mobile Services , no es necesario que esté hospedado en Mobile Services. Ahora es posible migrar un servicio móvil para que se ejecute en App Service sin realizar ningún cambio en el código, pero el servicio seguiría usando versiones de SDK de Mobile Services .
Especificación del encabezado
La clave ZUMO-API-VERSION se puede especificar en el encabezado HTTP o en la cadena de consulta. El valor es una cadena de versión con el formato x.y.z.
Por ejemplo:
GET https://service.azurewebsites.net/tables/TodoItem
HEADERS: ZUMO-API-VERSION: 2.0.0
POST https://service.azurewebsites.net/tables/TodoItem?ZUMO-API-VERSION=2.0.0
Anulación de la comprobación de la versión
Para anular la comprobación de la versión, establezca el valor true en la configuración de la aplicación MS_SkipVersionCheck. Especifique esto en el archivo web.config o en la sección Configuración de la aplicación del Portal de Azure.
Nota
Hay una serie de cambios de comportamiento entre Mobile Services y Mobile Apps, especialmente en las áreas de sincronización sin conexión, autenticación y notificaciones push. Solo debe anular la comprobación de versión después de realizar pruebas exhaustivas para asegurarse de que estos cambios de comportamiento no impiden la funcionalidad de la aplicación.
Cliente y servidor de Azure Mobile Apps
SDK de cliente de Mobile Apps
La comprobación de versión se introdujo a partir de las siguientes versiones del SDK de cliente de Azure Mobile Apps:
| Plataforma de cliente | Versión | Valor de encabezado de versión |
|---|---|---|
| Cliente administrado (Windows, Xamarin) | 2.0.0 | 2.0.0 |
| iOS | 3.0.0 | 2.0.0 |
| Android | 3.0.0 | 3.0.0 |
SDK de servidor de Mobile Apps
La comprobación de versión se incluye en las siguientes versiones del SDK de servidor:
| Plataforma de servidor | SDK | Encabezado de versión aceptado |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Comportamiento de back-ends de Mobile Apps
| ZUMO-API-VERSION | Valor de MS_SkipVersionCheck | Response |
|---|---|---|
| x.y.z o Null | Verdadero | 200 - CORRECTO |
| Null | False/Sin especificar | 400 - Solicitud incorrecta |
| 1.x.y | False/Sin especificar | 400 - Solicitud incorrecta |
| 2.0.0-2.x.y | False/Sin especificar | 200 - CORRECTO |
| 3.0.0-3.x.y | False/Sin especificar | 400 - Solicitud incorrecta |