Controllo delle versioni client e server in App per dispositivi mobili e Servizi mobili
La versione più recente di Servizi mobili di Azure è la funzionalità App per dispositivi mobili del Servizio app di Azure.
Gli SDK del client e del server di App per dispositivi mobili in origine si basano su quelle in Servizi mobili, ma non sono compatibili tra loro.
È infatti necessario usare un SDK del client di App per dispositivi mobili con un SDK del server di App per dispositivi mobili e lo stesso vale per Servizi mobili. Questo contratto viene applicato tramite un valore di intestazione speciale utilizzato dagli SDK del client e del server, ZUMO-API-VERSION.
Nota: ogni volta che in questo documento si fa riferimento a un back-end di Servizi mobili , esso non deve necessariamente essere ospitato su Servizi mobili. È ora possibile eseguire la migrazione di un servizio mobile per l'esecuzione nel Servizio app senza apportare modifiche al codice, ma il servizio continuerà a utilizzare le versioni SDK di Servizi mobili .
Specifica di intestazione
La chiave ZUMO-API-VERSION può essere specificata nell'intestazione HTTP o nella stringa di query. Il valore è una stringa di versione nel formato x.y.z.
Ad esempio:
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
Esclusione del controllo della versione
È possibile rifiutare esplicitamente il controllo della versione impostando un valore true per l'impostazione dell'app MS_SkipVersionCheck. Specificarlo nel file web.config o nella sezione Impostazioni applicazione del portale di Azure.
Nota
Esistono una serie di modifiche di comportamento tra Servizi mobili e App per dispositivi mobili, in particolare per quanto riguarda la sincronizzazione offline, l’autenticazione e le notifiche push. È consigliabile rifiutare esplicitamente solo il controllo della versione dopo aver completato un test per assicurarsi che queste modifiche del comportamento non interferiscano con le funzionalità dell'applicazione.
Client e server di App per dispositivi mobili di Azure
SDK client di App per dispositivi mobili
Il controllo della versione è stata introdotta a partire dalle seguenti versioni dell’SDK del client per App per dispositivi mobili di Azure:
| Piattaforma client | Versione | Valore dell'intestazione della versione |
|---|---|---|
| Client gestito (Windows, Xamarin) | 2.0.0 | 2.0.0 |
| iOS | 3.0.0 | 2.0.0 |
| Android | 3.0.0 | 3.0.0 |
SDK del server di App per dispositivi mobili
Il controllo della versione è incluso nelle seguenti versioni dell’SDK del server:
| Piattaforma server | SDK | Intestazione della versione accettata |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Comportamento dei back-end di app per dispositivi mobili
| ZUMO-API-VERSION | Valore di MS_SkipVersionCheck | Risposta |
|---|---|---|
| x.y.z o Null | Vero | 200 - OK |
| Null | False/Non specificato | 400 - Richiesta non valida |
| 1.x.y | False/Non specificato | 400 - Richiesta non valida |
| 2.0.0-2.x.y | False/Non specificato | 200 - OK |
| 3.0.0-3.x.y | False/Non specificato | 400 - Richiesta non valida |