Mobile Apps 및 Mobile Services에서 클라이언트 및 서버 버전 관리

Azure Mobile Services의 최신 버전은 Azure App Service의 Mobile Apps 기능입니다.

Mobile Apps 클라이언트 및 서버 SDK는 원래 Mobile Services를 기반으로 하지만 서로 호환되지 않습니다 . 즉, Mobile Apps 서버 SDK 및 마찬가지로 Mobile Services를 사용하는 Mobile Apps 클라이언트 SDK를 사용해야 합니다. 이 계약은 클라이언트 및 서버 SDK인 ZUMO-API-VERSION에서 사용하는 특별한 헤더 값을 통해 적용됩니다.

참고: 이 문서가 Mobile Services 백 엔드를 참조할 때마다 반드시 Mobile Services에서 호스팅해야 할 필요는 없습니다. 이제 코드를 변경하지 않고 App Service에서 실행되도록 Mobile Services를 마이그레이션할 수 있지만 서비스는 Mobile Services SDK 버전을 사용합니다.

헤더 사양

키 ZUMO-API-VERSION 는 HTTP 헤더 또는 쿼리 문자열에 지정될 수 있습니다. 값은 x.y.z형식의 버전 문자열입니다.

다음은 그 예입니다.

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

버전 확인 건너뛰기

앱 설정 MS_SkipVersionCheck에 대한 true 값을 설정하여 버전 확인을 건너뛸 수 있습니다. Web.config 또는 Azure Portal의 애플리케이션 설정 섹션에서 이를 지정합니다.

참고

오프라인 동기화, 인증 및 푸시 알림 영역에서 특히 Mobile Services와 Mobile Apps 간의 많은 동작 변경 사항이 있습니다. 이러한 동작 변경이 앱의 기능을 중단하지 않도록 테스트를 완료한 후에 버전 확인을 옵트아웃해야 합니다.

Azure Mobile Apps 클라이언트 및 서버

Mobile Apps 클라이언트 SDK

버전 확인은 Azure Mobile Apps에 대한 클라이언트 SDK의 다음 버전부터 도입됩니다.

클라이언트 플랫폼	버전	버전 헤더 값
관리된 클라이언트(Windows, Xamarin)	2.0.0	2.0.0
iOS	3.0.0	2.0.0
Android	3.0.0	3.0.0

Mobile Apps 서버 SDK

버전 검사는 다음 서버 SDK 버전에 포함됩니다.

서버 플랫폼	SDK)	수락된 버전 헤더
.NET	Microsoft.Azure.Mobile.Server	2.0.0
Node.js	azure-mobile-apps)	2.0.0

Mobile Apps 백 엔드의 동작

ZUMO-API-VERSION	MS_SkipVersionCheck의 값	응답
x.y.z 또는 Null	True	200 - 확인
Null	False/지정되지 않음	400 - 잘못된 요청
1.x.y	False/지정되지 않음	400 - 잘못된 요청
2.0.0-2.x.y	False/지정되지 않음	200 - 확인
3.0.0-3.x.y	False/지정되지 않음	400 - 잘못된 요청