Klient- och serverversionering i mobilappar och mobila tjänster

Den senaste versionen av Azure Mobile Services är funktionen Mobilappar i Azure App Service.

Mobile Apps-klienten och serverns SDK:er baseras ursprungligen på dem i Mobila tjänster, men de är inte kompatibla med varandra. Det vill säga, du måste använda en Mobile Apps klient SDK med en Mobile Apps server SDK och på samma sätt för mobila tjänster. Det här kontraktet tillämpas genom ett särskilt huvudvärde som används ZUMO-API-VERSIONav klient- och server-SDK:erna.

När det här dokumentet refererar till en mobile services-backend behöver det inte nödvändigtvis finnas på mobila tjänster. Det är nu möjligt att migrera en mobil tjänst för att köras på App Service utan några kodändringar, men tjänsten skulle fortfarande använda Mobile Services SDK-versioner.

Huvudspecifikation

Nyckeln ZUMO-API-VERSION kan anges i HTTP-huvudet eller frågesträngen. Värdet är en versionssträng i formuläret x.y.z.

Ett 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

Välja bort versionskontroll

Du kan välja bort versionskontrollen genom att ange värdet sant för appinställningen MS_SkipVersionCheck. Ange detta antingen i din web.config eller i avsnittet Programinställningar i Azure-portalen.

Anteckning

Det finns ett antal beteendeändringar mellan mobila tjänster och mobilappar, särskilt när det gäller offlinesynkronisering, autentisering och push-meddelanden. Du bör bara välja bort versionskontroll efter fullständig testning för att säkerställa att dessa beteendeförändringar inte bryter appens funktioner.

Azure Mobile Apps klient och server

SDK:er för mobile apps-klient

Versionskontrollen introducerades med början i följande versioner av klienten SDK för Azure Mobile Apps:

Klient plattform Version Värdet för versionshuvudet
Hanterad klient (Windows, Xamarin) 2.0.0 2.0.0
iOS 3.0.0 2.0.0
Android 3.0.0 3.0.0

SDK:er för mobilappar

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-mobilappar) 2.0.0

Beteende av mobile apps backends

ZUMO-API-VERSION Värdet på MS_SkipVersionCheck Svar
x.y.z eller Null True 200 - OK
Null Falskt/har inte angetts 400 – felaktig begäran
1.x.y Falskt/har inte angetts 400 – felaktig begäran
2.0.0-2.x.y Falskt/har inte angetts 200 - OK
3.0.0-3.x.y Falskt/har inte angetts 400 – felaktig begäran