Управление версиями клиента и сервера в мобильных приложениях и мобильных службах
Последняя версия мобильных служб Azure — компонент Мобильные приложения службы приложений Azure.
Пакеты SDK для клиента и сервера мобильных приложений основаны на аналогичных пакетах мобильных служб, но не совместимы с ними.
Другими словами, пакет SDK клиента мобильных приложений необходимо использовать с пакетом SDK сервера мобильных приложений (точно так же и для мобильных служб). Этот контракт реализуется посредством специального значения заголовка, используемого пакетами SDK для клиента и сервера, ZUMO-API-VERSION.
Примечание. Когда в этом документе упоминается внутренний сервер мобильных служб, он не обязательно должен размещаться в мобильных службах. теперь можно перенести мобильную службу для запуска на Служба приложений без изменения кода, но служба по-прежнему будет использовать версии пакета 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.
Примечание
Работа мобильных приложений отличается от мобильных служб в нескольких аспектах, в частности, в сфере автономной синхронизации, проверки подлинности и push-уведомлений. Вы можете отказаться от проверки версий только после выполнения тщательного тестирования, чтобы изменения в работе не нарушили функциональность приложения.
Клиент и сервер мобильных приложений Azure
Клиентские пакеты SDK для мобильных приложений
Проверка версии была добавлена, начиная со следующих версий пакета SDK для клиента мобильных приложений Azure:
| Платформа клиента | Версия | Значение заголовка версии |
|---|---|---|
| Управляемый клиент (Windows, Xamarin) | 2.0.0 | 2.0.0 |
| iOS | 3.0.0 | 2.0.0 |
| Android | 3.0.0 | 3.0.0 |
Пакеты SDK для сервера мобильных приложений
Проверка версий входит в состав следующих версий пакета SDK сервера:
| Платформа сервера | SDK | Принятый заголовок версии |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Поведение внутренних серверов мобильных приложений
| ZUMO-API-VERSION | Значение параметра MS_SkipVersionCheck | Ответ |
|---|---|---|
| x.y.z или значение NULL | Верно | 200 – OK |
| NULL | False/не указан | 400 – неверный запрос |
| 1.x.y | False/не указан | 400 – неверный запрос |
| 2.0.0-2.x.y | False/не указан | 200 – OK |
| 3.0.0-3.x.y | False/не указан | 400 – неверный запрос |