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