GuidesApplications mobiles

Une appli mobile qui marche hors ligne

Par l’équipe Banzai LabsMis à jour le 3 min de lecture

Hors ligneSQLiteFile d’attenteRetour réseauSynchronisationL’appli marche sans réseau et rattrape au retour
Sans réseau, l’appli écrit en local et met les envois en file ; la synchronisation se fait au retour du réseau.

Le principe

  1. 1Écrire en localChaque action est enregistrée sur le téléphone.
  2. 2Mettre en fileLa modification attend son envoi.
  3. 3SynchroniserAu retour du réseau, dans l’ordre.
  4. 4RécupérerLes changements faits par les autres.

La file d’attente

type Operation = { id: string; type: 'creer' | 'modifier' | 'supprimer'; table: string; donnees: unknown; tentatives: number };

async function synchroniser() {
  const ops = await db.getAllAsync<Operation>('SELECT * FROM file ORDER BY rowid');
  for (const op of ops) {
    const r = await fetch(`${API}/sync`, { method: 'POST', body: JSON.stringify(op) }).catch(() => null);
    if (!r?.ok) break; // on réessaiera au prochain retour du réseau
    await db.runAsync('DELETE FROM file WHERE id = ?', op.id);
  }
}

Les règles qui évitent les ennuis

Règle Pourquoi
Identifiants créés sur le téléphone (UUID) Pas besoin du serveur pour créer
Opérations idempotentes Un renvoi ne crée pas de doublon
Horodatage de chaque modification Pour arbitrer les conflits
Indicateur visible « en attente d’envoi » L’utilisateur sait où il en est

Les conflits

  • Dernier gagneSimple, suffisant pour des notes personnelles.
  • Le serveur tranchePour des stocks ou des paiements.
  • Fusion par champDeux personnes, deux champs différents : on garde les deux.

Le choix de départ : Expo ou développement natif. Le parcours : créer une application mobile.

Questions fréquentes

Que se passe-t-il si deux personnes modifient la même donnée ?
Il faut une règle écrite : la dernière modification gagne, le serveur tranche, ou les deux versions sont fusionnées champ par champ. Le choix dépend du métier.
Quelle base locale choisir ?
SQLite (par exemple avec expo-sqlite) convient à la plupart des cas. Des bibliothèques de synchronisation existent pour des besoins plus lourds.
Comment savoir si l’appareil est en ligne ?
Une bibliothèque comme NetInfo signale les changements. Ne vous y fiez pas seule : une requête qui échoue reste le vrai test.

À lire ensuite

Tous les guides