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 ze zijn niet compatibel met elkaar.
Dat wil gezegd, u moet een Mobile Apps client SDK 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 Mobile Services back-end, hoeft dit niet per se 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 de versiecontrole uitschakelen door een waarde van waar 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
Clientsdk's voor mobiele -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 mobiele -apps-servers
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 |