Delen via


Versiebeheer voor clients en servers in Mobile Apps en Mobile Services

De nieuwste versie van Azure Mobile Services is de functie Mobile Apps van Azure App Service.

De CLIENT- en server-SDK's van Mobile Apps zijn oorspronkelijk gebaseerd op de SDK's in Mobile Services, maar zijn niet compatibel met elkaar. Dat wil gezegd, u moet een SDK voor de Mobile Apps-client gebruiken met een Mobile Apps-server-SDK en op dezelfde manier voor Mobile Services. Dit contract wordt afgedwongen via een speciale headerwaarde die wordt gebruikt door de client- en server-SDK's, ZUMO-API-VERSION.

Opmerking: wanneer dit document verwijst naar een back-end van Mobile Services , hoeft dit niet noodzakelijkerwijs te worden gehost op Mobile Services. Het is nu mogelijk om een mobiele service te migreren om te worden uitgevoerd op App Service zonder codewijzigingen, maar de service zou nog steeds gebruikmaken van Mobile Services SDK-versies.

Headerspecificatie

De sleutel ZUMO-API-VERSION kan worden opgegeven in de HTTP-header of de queryreeks. De waarde is een versietekenreeks in de vorm x.y.z.

Voorbeeld:

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

Afmelden voor versiecontrole

U kunt zich afmelden voor versiecontrole door een waarde van true in te stellen voor de app-instelling MS_SkipVersionCheck. Geef dit op in uw web.config of in de sectie Toepassingsinstellingen van Azure Portal.

Notitie

Er zijn een aantal gedragswijzigingen tussen Mobile Services en Mobile Apps, met name op het gebied van offlinesynchronisatie, verificatie en pushmeldingen. U moet zich alleen afmelden voor versiecontrole na het voltooien van het testen om ervoor te zorgen dat deze gedragswijzigingen de functionaliteit van uw app niet verstoren.

Azure Mobile Apps-client en -server

Client-SDK's voor Mobile Apps

Versiecontrole is geïntroduceerd vanaf de volgende versies van de client-SDK voor Azure Mobile Apps:

Clientplatform Versie Waarde van versieheader
Beheerde client (Windows, Xamarin) 2.0.0 2.0.0
Ios 3.0.0 2.0.0
Android 3.0.0 3.0.0

SDK's voor servers van mobiele apps

Versiecontrole is opgenomen in de volgende server-SDK-versies:

Server platform SDK Geaccepteerde versie-header
.NET Microsoft.Azure.Mobile.Server 2.0.0
Node.js azure-mobile-apps) 2.0.0

Gedrag van mobiele apps-backends

ZUMO-API-VERSION Waarde van MS_SkipVersionCheck Reactie
x.y.z of Null Klopt 200 - OK
Nul Onwaar/niet opgegeven 400 - Foute aanvraag
1.x.y Onwaar/niet opgegeven 400 - Foute aanvraag
2.0.0-2.x.y Onwaar/niet opgegeven 200 - OK
3.0.0-3.x.y Onwaar/niet opgegeven 400 - Foute aanvraag