최신 버전의 Azure Mobile Services는 Azure App Service의 Mobile Apps 기능입니다.
Mobile Apps 클라이언트 및 서버 SDK는 원래 Mobile Services의 SDK를 기반으로 하지만 서로 호환 되지 않습니다 .
즉, Mobile Apps 서버 SDK 및 Mobile Services와 유사하게 Mobile Apps 클라이언트 SDK를 사용해야 합니다. 이 계약은 클라이언트 및 서버 SDK에서 사용하는 특수 헤더 값을 통해 적용됩니다 ZUMO-API-VERSION.
참고: 이 문서가 Mobile Services 백 엔드를 참조할 때마다 반드시 Mobile Services 에서 호스팅될 필요는 없습니다. 이제 코드 변경 없이 App Service에서 실행되도록 모바일 서비스를 마이그레이션할 수 있지만 서비스는 여전히 Mobile Services SDK 버전을 사용합니다.
헤더 사양
HTTP 헤더 또는 쿼리 문자열에서 키를 ZUMO-API-VERSION 지정할 수 있습니다. 값은 x.y.z 형식의 버전 문자열입니다.
다음은 그 예입니다.
GET https://service.azurewebsites.net/tables/TodoItem
헤더: ZUMO-API-VERSION: 2.0.0
POST https://service.azurewebsites.net/tables/TodoItem?ZUMO-API-VERSION=2.0.0
버전 검사 제외 설정
앱 설정 MS_SkipVersionChecktrue 값을 설정하여 버전 확인을 옵트아웃할 수 있습니다. 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 |
| 안드로이드 | 3.0.0 | 3.0.0 |
Mobile Apps 서버 SDK들
버전 검사는 다음 서버 SDK 버전에 포함됩니다.
| 서버 플랫폼 | SDK (소프트웨어 개발 키트) | 허용되는 버전 헤더 |
|---|---|---|
| .그물 | 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 | 진실 | 200 - 확인 |
| 없음 | False/지정되지 않음 | 400 - 잘못된 요청 |
| 1.x.y | False/지정되지 않음 | 400 - 잘못된 요청 |
| 2.0.0-2.x.y | False/지정되지 않음 | 200 - 확인 |
| 3.0.0-3.x.y | False/지정되지 않음 | 400 - 잘못된 요청 |