Partager via

Activation de la synchronisation hors connexion pour votre application mobile Android

  • Article

Vue d’ensemble

Ce didacticiel traite de la fonctionnalité de synchronisation hors connexion d’Azure Mobile Apps pour Android. La synchronisation hors connexion permet aux utilisateurs finaux d’interagir avec une application mobile (en affichant, en ajoutant ou en modifiant des données) même en l’absence de 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 serveur principal distant.

Si vous n’avez aucune expérience d’Azure Mobile Apps, vous devez commencer par suivre le didacticiel Création d’une application Android. 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 pour prendre en charge la synchronisation hors connexion

Avec la synchronisation hors connexion, vous disposez d’un accès en lecture et en écriture à partir d’une table de synchronisation (à l’aide de l’interface IMobileServiceSyncTable), qui fait partie d’une base de données SQLite sur votre appareil.

Pour envoyer et extraire des modifications entre l’appareil et Azure Mobile Services, faites appel à un contexte de synchronisation (MobileServiceClient.SyncContext), que vous initialisez avec la base de données locale utilisée pour stocker des données localement.

  1. Dans TodoActivity.java, commentez la définition existante de mToDoTable et supprimez les marques de commentaires de la version de table de synchronisation :

     private MobileServiceSyncTable<ToDoItem> mToDoTable;

  2. Dans la méthode onCreate, commentez l’initialisation existante de mToDoTable et supprimez les marques de commentaires de cette définition :

     mToDoTable = mClient.getSyncTable("ToDoItem", ToDoItem.class);

  3. Dans refreshItemsFromTable commentez la définition de results et supprimez les marque de commentaires de cette définition :

     // Offline Sync
 final List<ToDoItem> results = refreshItemsFromMobileServiceTableSyncTable();

  4. Commentez la définition de refreshItemsFromMobileServiceTable.

  5. Supprimez les marques de commentaires de la définition de refreshItemsFromMobileServiceTableSyncTable:

     private List<ToDoItem> refreshItemsFromMobileServiceTableSyncTable() throws ExecutionException, InterruptedException {
     //sync the data
     sync().get();
     Query query = QueryOperations.field("complete").
             eq(val(false));
     return mToDoTable.read(query).get();
 }

  6. Supprimez les marques de commentaires de la définition de sync:

     private AsyncTask<Void, Void, Void> sync() {
     AsyncTask<Void, Void, Void> task = new AsyncTask<Void, Void, Void>(){
         @Override
         protected Void doInBackground(Void... params) {
             try {
                 MobileServiceSyncContext syncContext = mClient.getSyncContext();
                 syncContext.push().get();
                 mToDoTable.pull(null).get();
             } catch (final Exception e) {
                 createAndShowDialogFromTask(e, "Error");
             }
             return null;
         }
     };
     return runAsyncTask(task);
 }

Test de l'application

Dans cette section, vous testez le comportement de l’application avec le Wi-Fi activé, puis vous désactivez le Wi-Fi pour créer un scénario hors connexion.

Lorsque vous ajoutez des éléments de données, ils sont stockés dans le magasin local SQLite, mais ils ne sont synchronisés avec le service mobile que si vous appuyez sur le bouton Actualiser . D’autres applications peuvent avoir des besoins différents concernant la fréquence de synchronisation des données, mais à des fins de démonstration, l’utilisateur doit en faire explicitement la requête dans le cadre de ce didacticiel.

Lorsque vous appuyez sur ce bouton, une nouvelle tâche en arrière-plan démarre. Elle commence par transmettre toutes les modifications apportées dans le magasin local à l’aide du contexte de synchronisation, puis extrait tous les données modifiées à partir d’Azure vers la table locale.

Test hors connexion

  1. Mettez l’appareil ou le simulateur en Mode avion. Cela crée un scénario hors connexion.

  2. Ajoutez des éléments TODO ou marquez certains éléments comme étant terminés. Quittez l’appareil ou le simulateur (ou forcez la fermeture de l’application) et redémarrez. Vérifiez que vos modifications persistent sur l’appareil, car elles sont stockées dans le magasin SQLite local.

  3. Affichez le contenu de la table TodoItem d’Azure avec un outil SQL, par exemple SQL Server Management Studio ou un client REST, comme Fiddler ou Postman. Vérifier que les nouveaux éléments n’ont pas été synchronisés sur le serveur

    + For a Node.js backend, go to the [Azure portal](https://portal.azure.com/), and in your Mobile App backend click **Easy Tables** > **TodoItem** to view the contents of the `TodoItem` table.
+ For a .NET backend, view the table contents either with a SQL tool such as *SQL Server Management Studio*, or a REST client such as *Fiddler* or *Postman*.

  4. Activez le Wi-Fi sur le simulateur ou l’appareil. Appuyez ensuite sur le bouton Actualiser .

  5. Affichez à nouveau les données TodoItem sur le portail Azure. Les nouveaux éléments TodoItems et ceux modifiés doivent maintenant s'afficher.

Ressources supplémentaires