Wersje klientów i serwerów w Mobile Apps i Mobile Services
Najnowsza wersja usługi Azure Mobile Services to Mobile Apps usługi Azure App Service.
Zestawy SDK Mobile Apps klienta i serwera są pierwotnie oparte na zestawach Mobile Services, ale nie są ze sobą zgodne.
Oznacza to, że należy użyć zestawu SDK Mobile Apps z zestawem SDK Mobile Apps i podobnie do Mobile Services. Ten kontrakt jest wymuszany za pomocą specjalnej wartości nagłówka używanej przez zestawy SDK klienta i serwera, ZUMO-API-VERSION.
Uwaga: zawsze, gdy ten dokument odwołuje się Mobile Services zaplecza, nie musi być hostowany na Mobile Services. Teraz można migrować usługę mobilną, która będzie działać na platformie App Service bez żadnych zmian kodu, ale nadal będzie używać Mobile Services ZESTAWU SDK.
Specyfikacja nagłówka
Klucz można ZUMO-API-VERSION określić w nagłówku HTTP lub ciągu zapytania. Wartość jest ciągiem wersji w postaci x.y.z.
Na przykład:
GET https://service.azurewebsites.net/tables/TodoItem
NAGŁÓWKI: ZUMO-API-VERSION: 2.0.0
POST https://service.azurewebsites.net/tables/TodoItem?ZUMO-API-VERSION=2.0.0
Rezygnacja ze sprawdzania wersji
Możesz zrezygnować ze sprawdzania wersji, ustawiając wartość true dla ustawienia aplikacji MS_SkipVersionCheck. Określ tę wartość w web.config lub w sekcji Application Ustawienia sekcji Azure Portal.
Uwaga
Istnieje wiele zmian zachowania między Mobile Services i Mobile Apps, szczególnie w obszarach synchronizacji w trybie offline, uwierzytelniania i powiadomień wypychanych. Należy zrezygnować ze sprawdzania wersji tylko po zakończeniu testowania, aby upewnić się, że te zmiany zachowania nie przerwą w funkcjonalności aplikacji.
Klient Mobile Apps i serwer platformy Azure
Zestawy SDK klienta usługi Mobile Apps
Sprawdzanie wersji zostało wprowadzone od następujących wersji zestawu SDK klienta dla usługi Azure Mobile Apps:
| Klient platforma | Wersja | Wartość nagłówka wersji |
|---|---|---|
| Zarządzany klient (Windows, Xamarin) | 2.0.0 | 2.0.0 |
| iOS | 3.0.0 | 2.0.0 |
| Android | 3.0.0 | 3.0.0 |
Zestawy SDK serwera usługi Mobile Apps
Sprawdzanie wersji jest uwzględnione w następujących wersjach zestawu SDK serwera:
| Platforma serwera | SDK | Nagłówek zaakceptowanej wersji |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Zachowanie Mobile Apps zaplecza
| ZUMO-API-VERSION | Wartość MS_SkipVersionCheck | Reakcja |
|---|---|---|
| x.y.z lub Null | Prawda | 200 – OK |
| Zero | False/Not Specified | 400 — Nieprawidłowe żądanie |
| 1.x.y | False/Not Specified | 400 — Nieprawidłowe żądanie |
| 2.0.0–2.x.y | False/Not Specified | 200 – OK |
| 3.0.0–3.x.y | False/Not Specified | 400 — Nieprawidłowe żądanie |