Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die neueste Version von Azure Mobile Services ist die Mobile Apps Funktion von Azure App Service.
Der Client und die Server-SDKs für mobile Apps basieren ursprünglich auf denen in Mobile Services, aber sie sind nicht miteinander kompatibel.
Das heißt, Sie müssen ein Mobile Apps Client SDK mit einem Mobile Apps Server SDK und ähnlich für Mobile Servicesverwenden. Dieser Vertrag wird durch einen speziellen Headerwert erzwungen, der von den Client- und Server-SDKs verwendet wird, ZUMO-API-VERSION.
Hinweis: Wenn sich dieses Dokument auf ein Mobile Services Back-End bezieht, muss es nicht unbedingt auf Mobile Services gehostet werden. Es ist jetzt möglich, einen mobilen Dienst ohne Codeänderungen auf App Service auszuführen, aber der Dienst würde weiterhin Mobile Services SDK-Versionen verwenden.
Headerspezifikation
Der Schlüssel ZUMO-API-VERSION kann entweder im HTTP-Header oder in der Abfragezeichenfolge angegeben werden. Der Wert ist eine Versionszeichenfolge in form 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
Deaktivierung der Versionsüberprüfung
Sie können die Versionsüberprüfung deaktivieren, indem Sie den Wert true für die App-Einstellung MS_SkipVersionCheckfestlegen. Geben Sie dies entweder in Ihrem web.config oder im Abschnitt "Anwendungseinstellungen" des Azure-Portals an.
Hinweis
Es gibt eine Reihe von Verhaltensänderungen zwischen Mobilen Diensten und mobilen Apps, insbesondere in den Bereichen Offlinesynchronisierung, Authentifizierung und Pushbenachrichtigungen. Sie sollten die Versionsüberprüfung erst nach abschluss des Tests deaktivieren, um sicherzustellen, dass diese Verhaltensänderungen die Funktionalität Ihrer App nicht unterbrechen.
Azure Mobile Apps-Client und -Server
Mobile Apps Client SDKs
Die Versionsüberprüfung wurde beginnend mit den folgenden Versionen des Client-SDK für Azure Mobile Appseingeführt:
| Clientplattform | Version | Versions-Header-Wert |
|---|---|---|
| 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 Server-SDK-Versionen enthalten:
| Serverplattform | Softwareentwicklungskit (SDK) | Akzeptierter Versionsheader |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Verhalten mobiler 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 |