Dela via


Klient- och serverversionshantering i Mobile Apps och Mobile Services

Den senaste versionen av Azure Mobile Services är mobile apps-funktionen i Azure App Service.

Mobile Apps-klienten och server-SDK:erna baseras ursprungligen på dem i Mobile Services, men de är inte kompatibla med varandra. Du måste alltså använda en Mobile Apps-klient-SDK med en Mobile Apps-server-SDK och på liknande 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 en Mobile Services-serverdel behöver det inte nödvändigtvis finnas i Mobile Services. Nu är det möjligt att migrera en mobiltjä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.

Rubrikspecifikation

Nyckeln ZUMO-API-VERSION kan anges i http-huvudet eller frågesträngen. Värdet är en versionssträng i formatet 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

Avregistrera dig från versionskontroll

Du kan avregistrera dig från versionskontrollen genom att ange värdet true för appinställningen MS_SkipVersionCheck. Ange detta antingen i din web.config eller i avsnittet Programinställningar i Azure-portalen.

Anmärkning

Det finns ett antal beteendeändringar mellan Mobile Services och Mobile Apps, särskilt när det gäller synkronisering, autentisering och push-meddelanden offline. Du bör bara avregistrera dig från versionskontrollen efter fullständig testning för att säkerställa att dessa beteendeändringar inte bryter appens funktioner.

Azure Mobile Apps-klient och -server

Mobile Apps-klient-SDK:er

Versionskontrollen introducerades från och med följande versioner av klient-SDK:t för Azure Mobile Apps:

Klientplattform Utgåva 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

SDK:er för Mobile Apps-server

Versionskontroll ingår i följande server-SDK-versioner:

Serverplattform SDK Sidhuvud för godkänd version
.NÄT Microsoft.Azure.Mobile.Server 2.0.0
Node.js azure-mobile-apps) 2.0.0

Beteende för Mobile Apps-serverdelar

ZUMO-API-VERSION Värdet för MS_SkipVersionCheck Svar
x.y.z eller Null Sann 200 - OK
Noll 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