Versão de cliente e servidor em Aplicativos Móveis e Serviços Móveis

A versão mais recente do Azure Serviços Móveis é a funcionalidade de Aplicações Móveis de Serviço de Aplicações do Azure.

Os SDKs e clientes de Aplicações Móveis são originalmente baseados nos Serviços Móveis, mas não são compatíveis uns com os outros. Ou seja, você deve usar um cliente de Aplicações Móveis SDK com um servidor de Aplicações Móveis SDK e similarmente para Serviços Móveis. Este contrato é aplicado através de um valor especial de cabeçalho utilizado pelo cliente e servidor SDKs, ZUMO-API-VERSION.

Nota: sempre que este documento se refere a um backend Serviços Móveis, não precisa necessariamente de ser hospedado em Serviços Móveis. Agora é possível migrar um serviço móvel para funcionar em Serviço de Aplicações sem alterações de código, mas o serviço ainda estaria a utilizar Serviços Móveis versões SDK.

Especificação do cabeçalho

A tecla ZUMO-API-VERSION pode ser especificada no cabeçalho HTTP ou na cadeia de consulta. O valor é uma cadeia de versão no formulário x.y.z.

Por exemplo:

GET https://service.azurewebsites.net/tables/TodoItem

CABEÇALHOS: ZUMO-API-VERSÃO: 2.0.0

POST https://service.azurewebsites.net/tables/TodoItem?ZUMO-API-VERSION=2.0.0

Optando por não verificar a versão

Pode optar por não verificar a versão definindo um valor verdadeiro para a definição da aplicação MS_SkipVersionCheck. Especifique isto no seu web.config ou na secção Definições de aplicação do portal do Azure.

Nota

Há uma série de mudanças de comportamento entre Serviços Móveis e Aplicações Móveis, particularmente nas áreas de sincronização offline, autenticação e notificações push. Só deve optar por não verificar a versão após os testes completos para garantir que estas alterações comportamentais não infringem a funcionalidade da sua aplicação.

Cliente e servidor de Aplicações Móveis Azure

SDKs cliente de Aplicações Móveis

A verificação de versão foi introduzida a partir das seguintes versões do cliente SDK para aplicações móveis Azure:

Cliente plataforma	Versão	Valor do cabeçalho da versão
Cliente gerido (Windows, Xamarin)	2.0.0	2.0.0
iOS	3.0.0	2.0.0
Android	3.0.0	3.0.0

SDKs de servidor de aplicativos móveis

A verificação de versão está incluída nas seguintes versões SDK do servidor:

Plataforma de servidor	SDK	Cabeçalho de versão aceite
.NET	Microsoft.Azure.Mobile.Server	2.0.0
Node.js	azure-mobile-apps)	2.0.0

Comportamento de Apps Móveis backends

VERSÃO ZUMO-API	Valor da MS_SkipVersionCheck	Resposta
x.y.z ou Nulo	Verdadeiro	200 - OK
Nulo	Falso/Não Especificado	400 – Pedido Incorreto
1.x.y	Falso/Não Especificado	400 – Pedido Incorreto
2.0.0-2.x.y	Falso/Não Especificado	200 - OK
3.0.0-3.x.y	Falso/Não Especificado	400 – Pedido Incorreto