Versionshantering av klienter och servrar i Mobile Apps och Mobile Services
Den senaste versionen av Azure Mobile Services är Mobile Apps av Azure App Service.
De Mobile Apps klient- och server-SDK:erna baseras ursprungligen på de i Mobile Services, men de är inte kompatibla med varandra.
Det innebär att du måste använda en Mobile Apps klient-SDK med en Mobile Apps-server-SDK och på samma sätt för Mobile Services. Det här kontraktet tillämpas via ett särskilt huvudvärde som används av klient- och server-SDK:erna, ZUMO-API-VERSION.
Obs! När det här dokumentet refererar till Mobile Services en backend behöver det inte nödvändigtvis finnas på Mobile Services. Det är nu möjligt att migrera en mobiltjänst som ska köras på App Service utan kodändringar, men tjänsten skulle fortfarande använda Mobile Services SDK-versioner.
Rubrikspecifikation
Nyckeln kan ZUMO-API-VERSION anges i HTTP-huvudet eller frågesträngen. Värdet är en versionssträng i formen x.y.z.
Till exempel:
GET https://service.azurewebsites.net/tables/TodoItem
RUBRIKER: ZUMO-API-VERSION: 2.0.0
POST https://service.azurewebsites.net/tables/TodoItem?ZUMO-API-VERSION=2.0.0
Avanmäla sig från versionskontroll
Du kan välja bort versionskontroll genom att ange värdet true för appinställningen MS_SkipVersionCheck. Ange detta antingen i web.config eller i avsnittet Inställningar program i Azure Portal.
Anteckning
Det finns ett antal beteendeändringar mellan Mobile Services och Mobile Apps, särskilt när det gäller offlinesynkronisering, autentisering och push-meddelanden. Du bör endast välja bort versionskontroll efter fullständig testning för att säkerställa att dessa beteendeändringar inte bryter appens funktioner.
Azure Mobile Apps klient och server
Klient-SDK:er för Mobile Apps
Versionskontroll introducerades från och med följande versioner av klient-SDK för Azure Mobile Apps:
| Klient plattform | Version | Versionshuvudvärde |
|---|---|---|
| Hanterad klient (Windows, Xamarin) | 2.0.0 | 2.0.0 |
| iOS | 3.0.0 | 2.0.0 |
| Android | 3.0.0 | 3.0.0 |
Server-SDK:er för Mobile Apps
Versionskontroll ingår i följande server-SDK-versioner:
| Serverplattform | SDK | Godkänt versionshuvud |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Beteende för Mobile Apps serverfunktioner
| ZUMO-API-VERSION | Värdet för MS_SkipVersionCheck | Svarsåtgärder |
|---|---|---|
| x.y.z eller Null | Sant | 200 – OK |
| Null | Falskt/inte angivet | 400 – felaktig begäran |
| 1.x.y | Falskt/inte angivet | 400 – felaktig begäran |
| 2.0.0-2.x.y | Falskt/inte angivet | 200 – OK |
| 3.0.0-3.x.y | Falskt/inte angivet | 400 – felaktig begäran |