Activer la synchronisation hors connexion pour votre application mobile Xamarin.iOS

Article
06/25/2019

Vue d’ensemble

Ce didacticiel présente la fonctionnalité de synchronisation hors connexion d’Azure Mobile Apps pour Xamarin.iOS. La synchronisation hors connexion permet aux utilisateurs finaux d’interagir avec une application mobile pour afficher, ajouter ou modifier des données, même lorsqu’il n’existe aucune connexion réseau. Les modifications sont stockées dans une base de données locale. Une fois l'appareil de nouveau en ligne, ces modifications sont synchronisées avec le service distant.

Dans ce didacticiel, vous allez mettre à jour le projet d’application Xamarin.iOS dans Création d’une application Xamarin iOS pour prendre en charge les fonctionnalités hors connexion d’Azure Mobile Apps. Si vous n’utilisez pas le projet de serveur du démarrage rapide téléchargé, vous devez ajouter les packages d’extension d’accès aux données à votre projet. Pour plus d'informations sur les packages d'extension de serveur, consultez Fonctionnement avec le Kit de développement logiciel (SDK) du serveur principal .NET pour Azure Mobile Apps.

Pour plus d’informations sur la fonctionnalité de synchronisation hors connexion, consultez la rubrique Synchronisation des données hors connexion dans Azure Mobile Apps.

Mettre à jour l’application cliente pour prendre en charge les fonctionnalités hors connexion

Les fonctionnalités hors connexion de l’application mobile Azure vous permettent d’interagir avec une base de données locale hors connexion. Pour utiliser ces fonctionnalités dans votre application, initialisez un SyncContext dans un magasin local. Ensuite, référencez votre table par le biais de l’interface [IMobileServiceSyncTable]. SQLite est utilisé comme magasin local sur l’appareil.

ouvrez le gestionnaire de package NuGet dans le projet que vous avez terminé dans le didacticiel créer une application Xamarin iOS , puis recherchez et installez le package Microsoft. Azure. Mobile. Client. SQLiteStore NuGet.
Ouvrez le fichier QSTodoService.cs et supprimez les marques de commentaire de la définition #define OFFLINE_SYNC_ENABLED.
Régénérez et exécutez l’application cliente. L’application fonctionne de la même façon qu’avant d’activer la synchronisation hors connexion. Toutefois, la base de données locale est maintenant remplie avec des données qui peuvent être utilisées dans un scénario hors connexion.

Mise à jour de l’application pour se déconnecter du backend

Dans cette section, vous rompez la connexion avec votre backend d’application mobile afin de simuler un scénario hors connexion. Lorsque vous ajouterez des éléments de données, votre gestionnaire d’exceptions signalera que l’application est en mode hors connexion. Dans cet état, les nouveaux éléments ajoutés au magasin local seront synchronisés avec le backend de l’application mobile lors de la prochaine opération Push en état connecté.

Modifiez QSToDoService.cs dans le projet partagé. Modifiez la variable applicationURL afin de pointer vers une URL non valide :
```
  const string applicationURL = @"https://your-service.azurewebsites.fail";
```
Vous pouvez également illustrer le comportement en mode hors connexion en désactivant les réseaux Wi-Fi et cellulaire sur l’appareil ou en utilisant le mode avion.
Générez et exécutez l'application. Notez que la synchronisation a échoué lors de l’actualisation au lancement de l’application.
Entrez de nouveaux éléments et notez que l’opération d’envoi échoue avec un état [CancelledByNetworkError] chaque fois que vous cliquez sur Enregistrer. Cependant, les nouveaux éléments todo existent dans le magasin local tant qu’ils ne sont pas transmis au backend d’application mobile. Dans une application de production, si vous supprimez ces exceptions, l’application cliente se comporte comme si elle est encore connectée au backend de l’application mobile.
Fermez l'application et redémarrez-la pour vérifier que les nouveaux élément que vous avez créés sont conservés dans le magasin local.
(Facultatif) Si Visual Studio est installé sur votre PC, ouvrez l’Explorateur de serveurs. accédez à votre base de données dans Azure- >SQL bases de données. Cliquez avec le bouton droit sur votre base de données, puis sélectionnez Ouvrir dans l’Explorateur d’objets SQL Server. Maintenant, vous pouvez accéder à votre table de base de données SQL et à son contenu. Vérifiez que les données dans la base de données backend n’ont pas changé.
(Facultatif) Utilisez un outil REST tel que Fiddler ou Postman pour interroger votre serveur principal mobile, à l’aide d’une requête GET au format https://<your-mobile-app-backend-name>.azurewebsites.net/tables/TodoItem.

Mettre à jour l’application pour la reconnecter à votre backend d’applications mobiles

Dans cette section, reconnectez l’application au serveur principal d’applications mobiles. Cette opération simule le passage de l’application d’un état hors connexion à un état connecté au backend d’applications mobiles. Si vous avez simulé la rupture du réseau en désactivant la connectivité réseau, aucune modification de code n’est nécessaire. Réactivez le réseau. Lorsque vous exécutez l’application pour la première fois, la méthode RefreshDataAsync est appelée. SyncAsync est ensuite appelée pour permettre la synchronisation de votre magasin local avec la base de données du serveur principal.

Ouvrez QSToDoService.cs dans le projet partagé et annulez votre modification de la propriété applicationURL.
Régénérez et exécutez l'application. L’application synchronise vos modifications locales avec le serveur principal d’applications mobiles Azure par des opérations d’extraction et d’envoi lorsque la méthode OnRefreshItemsSelected s’exécute.
(Facultatif) Affichez les données mises à jour à l’aide de l’Explorateur d’objets SQL Server ou d’un outil REST tel que Fiddler. Notez que les données ont été synchronisées entre la base de données du backend d’application mobile Azure et le magasin local.
Dans l'application, cochez la case en regard de quelques éléments pour les exécuter dans le magasin local.

CompleteItemAsync appelle SyncAsync pour synchroniser chaque élément complété avec le serveur principal d’applications mobiles. SyncAsync appelle des opérations Push et Pull. Chaque fois que vous exécutez une opération d’extraction sur une table modifiée par le client, une opération d’envoi préalable est effectuée automatiquement sur le contexte de synchronisation du client. Cette opération d’envoi implicite garantit la cohérence de toutes les tables du magasin local, mais aussi des relations. Pour plus d’informations, consultez la page Synchronisation des données hors connexion dans Azure Mobile Apps.

Examiner le code de synchronisation client

Le projet client Xamarin que vous avez téléchargé quand vous avez suivi le didacticiel Création d’une application Xamarin iOS contient déjà du code prenant en charge la synchronisation hors connexion à l’aide d’une base de données SQLite locale. Voici un bref aperçu de ce qui est déjà inclus dans le code du didacticiel. Pour obtenir une vue d’ensemble conceptuelle de la fonctionnalité, consultez Synchronisation des données hors connexion dans Azure Mobile Apps.

Avant de pouvoir effectuer des opérations de table, le magasin local doit être initialisé. La base de données du magasin local est initialisée quand QSTodoListViewController.ViewDidLoad() exécute QSTodoService.InitializeStoreAsync(). Cette méthode crée une base de données SQLite locale à l’aide de la classe MobileServiceSQLiteStore fournie par le Kit de développement logiciel (SDK) client Azure Mobile App.

La méthode DefineTable crée une table dans le magasin local qui correspond aux champs dans le type fourni, ToDoItem ici. Ce type n’a pas besoin d’inclure toutes les colonnes qui se trouvent dans la base de données distante. Il est possible de stocker uniquement un sous-ensemble de colonnes.
```
  // QSTodoService.cs

  public async Task InitializeStoreAsync()
  {
      var store = new MobileServiceSQLiteStore(localDbPath);
      store.DefineTable<ToDoItem>();

      // Uses the default conflict handler, which fails on conflict
      await client.SyncContext.InitializeAsync(store);
  }
```
Le membre todoTable de QSTodoService est du type IMobileServiceSyncTable au lieu d’IMobileServiceTable. Ainsi, IMobileServiceSyncTable redirige toutes les opérations de table CRUD (Create, Read, Update et Delete) vers la base de données du magasin local.

Vous décidez à quel moment ces modifications sont envoyées au serveur principal Azure Mobile App en appelant IMobileServiceSyncContext.PushAsync(). Le contexte de synchronisation permet de conserver les relations entre les tables grâce au suivi et à l’envoi des modifications dans toutes les tables qu’une application cliente modifie quand PushAsync est appelé.

Le code fourni appelle QSTodoService.SyncAsync() pour effectuer une synchronisation chaque fois que la liste des éléments de tâche est actualisée ou qu’un élément de tâche est ajouté ou terminé. L’application se synchronise après chaque modification locale. Si une extraction est exécutée sur une table qui comporte des mises à jour locales en attente faisant l’objet d’un suivi en fonction du contexte, cette opération déclenche automatiquement un envoi préalable sur le contexte.

Dans le code fourni, tous les enregistrements de la table TodoItem distante sont interrogés, mais il est également possible de filtrer les enregistrements en transmettant un ID de requête et une requête à PushAsync. pour plus d’informations, consultez la section synchronisation incrémentielle en mode hors connexion Synchronisation des données dans Azure Mobile Apps.
```
  // QSTodoService.cs
  public async Task SyncAsync()
  {
      try
      {
          await client.SyncContext.PushAsync();
          await todoTable.PullAsync("allTodoItems", todoTable.CreateQuery()); // query ID is used for incremental sync
      }

      catch (MobileServiceInvalidOperationException e)
      {
          Console.Error.WriteLine(@"Sync Failed: {0}", e.Message);
      }
  }
```

Partager via