Contrôle de version client et serveur dans Mobile Apps et Mobile Services
La dernière version d'Azure Mobile Services est la fonctionnalité Mobile Apps d'Azure App Service.
Les Kits de développement logiciel (SDK) clients et serveurs Mobile Apps se fondent à l'origine sur ceux de Mobile Services, mais ils ne sont pas compatibles les uns avec les autres.
Autrement dit, vous devez utiliser un SDK client Mobile Apps avec un SDK serveur Mobile Apps et il en est de même pour Mobile Services. Ce contrat s'applique au moyen d'une valeur d'en-tête spéciale utilisée par les SDK clients et serveurs, ZUMO-API-VERSION.
Remarque : chaque fois que ce document fait référence à un backend Mobile Services , il n'est pas nécessaire qu'il soit hébergé sur Mobile Services. Il est désormais possible de faire migrer un service mobile sur App Service sans aucune modification de code, mais dans ce cas le service utilisera toujours les versions du SDK Mobile Services .
Spécification de l’en-tête
La clé ZUMO-API-VERSION peut être spécifiée dans l'en-tête HTTP ou dans la chaîne de requête. La valeur est une chaîne de version sous la forme x.y.z.
Par exemple :
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
Désactivation de la vérification de version
Vous pouvez désactiver la vérification de version en définissant la valeur true pour le paramètre d’application MS_SkipVersionCheck. Spécifiez cette valeur dans votre fichier web.config ou dans la section Paramètres de l’application du portail Azure.
Notes
Il existe un certain nombre de différences de comportement entre Mobile Services et Mobile Apps, en particulier dans les domaines de la synchronisation hors connexion, de l'authentification et des notifications Push. Avant de désactiver la vérification de version, assurez-vous par des tests complets que ces modifications de comportement ne suppriment pas de fonctionnalités dans votre application.
Client et serveur Azure Mobile Apps
Kits de développement logiciel (SDK) clients mobile apps
La vérification de version a été introduite à partir des versions suivantes du SDK client pour Azure Mobile Apps:
| Plateforme cliente | Version | Valeur d'en-tête de version |
|---|---|---|
| Client géré (Windows, Xamarin) | 2.0.0 | 2.0.0 |
| iOS | 3.0.0 | 2.0.0 |
| Android | 3.0.0 | 3.0.0 |
Kits de développement logiciel (SDK) du serveur Mobile Apps
La vérification de version est incluse dans les versions suivantes du SDK serveur :
| Plateforme de serveur | Kit SDK | En-têtes de versions acceptés |
|---|---|---|
| .NET | Microsoft.Azure.Mobile.Server | 2.0.0 |
| Node.js | azure-mobile-apps) | 2.0.0 |
Comportement des serveurs principaux Mobile Apps
| ZUMO-API-VERSION | Valeur de MS_SkipVersionCheck | response |
|---|---|---|
| x.y.z ou Null | True | 200 - OK |
| Null | False/Non spécifié | 400 - Requête incorrecte |
| 1.x.y | False/Non spécifié | 400 - Requête incorrecte |
| 2.0.0-2.x.y | False/Non spécifié | 200 - OK |
| 3.0.0-3.x.y | False/Non spécifié | 400 - Requête incorrecte |