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 servidor y cliente de Mobile Apps se basan originalmente en los de Mobile Services, pero no se compatibles entre sí.
Es decir, debe usar un SDK de cliente de Mobile Apps con un SDK de servidor de Mobile Apps y de forma similar para Mobile Services. Este contrato se aplica a través de un valor de encabezado especial utilizado 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é alojado en Mobile Services. Ahora es posible migrar un servicio móvil para que se ejecute en App Service sin cambios en el código, pero el servicio seguiría usando Mobile Services versiones del SDK.
Especificación de encabezado
La clave ZUMO-API-VERSION puede especificarse 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
ENCABEZADOS: ZUMO-API-VERSION: 2.0.0
POST https://service.azurewebsites.net/tables/TodoItem?ZUMO-API-VERSION=2.0.0
No participar en la comprobación de versiones
Puede optar por no participar en la comprobación de versiones estableciendo un valor de true para el ajuste de la aplicación MS_SkipVersionCheck. Especifique esto en la 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, autenticación y notificaciones push sin conexión. Solo debes rechazar la comprobación de versiones después de realizar pruebas completas para asegurarte de que estos cambios de comportamiento no interrumpen la funcionalidad de la aplicación.
Cliente y servidor de Azure Mobile Apps
SDKs de cliente de Aplicaciones Móviles
La comprobación de versiones se introdujo a partir de las siguientes versiones del SDK de cliente para Azure Mobile Apps:
| Plataforma 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 |
| Androide | 3.0.0 | 3.0.0 |
SDK de servidor para aplicaciones móviles
La comprobación de versiones se incluye en las siguientes versiones del SDK de servidor:
| Plataforma de servidor | SDK | Encabezado de versión aceptada |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Comportamiento de los back-end de Mobile Apps
| ZUMO-API-VERSION | Valor de MS_SkipVersionCheck | Respuesta |
|---|---|---|
| x.y.z o Null | Cierto | 200 - OK |
| Nulo | False/No especificado | 400 - Solicitud incorrecta |
| 1.x.y | False/No especificado | 400 - Solicitud incorrecta |
| 2.0.0-2.x.y | False/No especificado | 200 - OK |
| 3.0.0-3.x.y | False/No especificado | 400 - Solicitud incorrecta |