Client- und Serverversionsverwaltung in Mobile Apps und Mobile Services
Die neueste Version von Azure Mobile Services ist das Feature Mobile Apps von Azure App Service.
Die Mobile Apps-Client- und -Server-SDKs basieren ursprünglich auf den SDKs in Mobile Services, aber sie sind nicht miteinander kompatibel.
Dies bedeutet, dass Sie ein Mobile Apps-Client-SDK mit einem Mobile Apps-Server-SDK und ebenso für Mobile Services verwenden müssen. Dieser Vertrag wird mit einem speziellen Headerwert durchgesetzt, der von den Client- und Server-SDKs verwendet wird: ZUMO-API-VERSION.
Hinweis: Wenn in diesem Dokument auf ein Mobile Services -Back-End verwiesen wird, heißt das nicht zwangsläufig, dass es unter Mobile Services gehostet wird. Es ist jetzt möglich, einen mobilen Dienst für die Ausführung unter App Service ohne Codeänderungen zu migrieren, aber für den Dienst würden dabei trotzdem Mobile Services -SDK-Versionen verwendet werden.
Headerspezifikation
Der Schlüssel ZUMO-API-VERSION kann entweder im HTTP-Header oder in der Abfragezeichenfolge angegeben werden. Der Wert ist eine Versionszeichenfolge im Format x.y.z.
Beispiel:
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
Deaktivieren der Versionsüberprüfung
Sie können die Versionsüberprüfung deaktivieren, indem Sie den Wert true für die App-Einstellung MS_SkipVersionCheck festlegen. Die Angabe kann entweder in der Datei „web.config“ oder im Azure-Portal im Abschnitt mit den Anwendungseinstellungen vorgenommen werden.
Hinweis
Es gibt einige Änderungen des Verhaltens zwischen Mobile Services und Mobile Apps, vor allem in den Bereichen der Offlinesynchronisierung, Authentifizierung und Pushbenachrichtigungen. Sie sollten die Versionsüberprüfung erst deaktivieren, wenn Sie sich durch umfassende Tests vergewissert haben, dass diese Änderungen des Verhaltens nicht zu Problemen mit den Funktionen Ihrer App führen.
Azure Mobile Apps-Client und -Server
Mobile Apps-Client-SDKs
Die Versionsüberprüfung wurde ab den folgenden Versionen des Client-SDK für Azure Mobile Appseingeführt:
| Clientplattform | Version | Versionsheaderwert |
|---|---|---|
| Verwalteter Client (Windows, Xamarin) | 2.0.0 | 2.0.0 |
| iOS | 3.0.0 | 2.0.0 |
| Android | 3.0.0 | 3.0.0 |
Mobile Apps -Server-SDKs
Die Versionsüberprüfung ist in den folgenden Versionen des Server-SDK enthalten:
| Serverplattform | SDK | Akzeptierter Versionsheader |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps | 2.0.0 |
Verhalten von Mobile Apps-Back-Ends
| ZUMO-API-VERSION | Wert von MS_SkipVersionCheck | Antwort |
|---|---|---|
| x.y.z oder NULL | Richtig | 200 – OK |
| NULL | False/Nicht angegeben | 400 – Ungültige Anforderung |
| 1.x.y | False/Nicht angegeben | 400 – Ungültige Anforderung |
| 2.0.0 - 2.x.y | False/Nicht angegeben | 200 – OK |
| 3.0.0-3.x.y | False/Nicht angegeben | 400 – Ungültige Anforderung |