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 - 잘못된 요청 |