Client- en serverversiebeheer in Mobile Apps en Mobile Services
De nieuwste versie van Azure Mobile Services is de Mobile Apps-functie van Azure App Service.
De Mobile Apps client- en server-SDK's zijn oorspronkelijk gebaseerd op de SDK's in Mobile Services, maar ze zijn niet compatibel met elkaar.
Dat wil zeggen dat u een Mobile Apps client-SDK moet 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 naar een back-Mobile Services verwijst, hoeft het niet noodzakelijkerwijs te worden gehost op Mobile Services. Het is nu mogelijk om een mobiele service te migreren die op App Service kan worden uitgevoerd 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 versiereeks in de vorm x.y.z.
Bijvoorbeeld:
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
Opt-out van versiecontrole
U kunt ervoor kiezen om versiecontrole uit te stellen door de waarde true in te stellen voor de app-instelling MS_SkipVersionCheck. Geef dit op in uw web.config of in de Instellingen toepassing van de 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 er alleen voor kiezen om versiecontrole uit te schakelen na het voltooien van het testen om ervoor te zorgen dat deze gedragswijzigingen de functionaliteit van uw app niet breken.
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:
| Client platform | 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 |
Server-SDK's voor Mobile Apps
Versiecontrole is opgenomen in de volgende server-SDK-versies:
| Serverplatform | SDK | Geaccepteerde versieheader |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Gedrag van Mobile Apps back-Mobile Apps
| ZUMO-API-VERSION | Waarde van MS_SkipVersionCheck | Antwoord |
|---|---|---|
| x.y.z of Null | Waar | 200 - OK |
| Null | False/Not Specified | 400 - Foute aanvraag |
| 1.x.y | False/Not Specified | 400 - Foute aanvraag |
| 2.0.0-2.x.y | False/Not Specified | 200 - OK |
| 3.0.0-3.x.y | False/Not Specified | 400 - Foute aanvraag |