Démarrage rapide

Vous revoilà! Commençons à utiliser la base de données Flutter la plus cool qui soit...

Nous allons être brefs en mots et rapides en code dans ce démarrage rapide.

1. Ajout des dépendances

Avant de débuter, nous devons ajouter quelques dépendances au fichier pubspec.yaml. Nous pouvons utiliser la commande pub pour faire le gros du travail à notre place.

dart pub add isar:^4.0.3 isar_flutter_libs:^4.0.3 --hosted-url=https://pub.isar-community.dev

2. Annotation de classes

Annotez vos classes de collection avec @collection et choisissez un champ Id.

import 'package:isar/isar.dart';

part 'user.g.dart';

@collection
class User {
  late int id;

  String? name;

  int? age;
}

Les Ids identifient de manière unique les objets d'une collection et vous permettent de les retrouver ultérieurement.

3. Exécuter le générateur de code

Exécutez la commande suivante pour démarrer le build_runner:

dart run build_runner build

4. Ouverture l'instance Isar

Ouvrez une nouvelle instance d'Isar et passez tous vos schémas de collection. En option, vous pouvez spécifier un nom d'instance et un dossier.

final dir = await getApplicationDocumentsDirectory();
final isar = await Isar.openAsync(
  schemas: [UserSchema],
  directory: dir.path,
);

5. Écriture et lecture

Une fois que votre instance est ouverte, vous pouvez commencer à utiliser les collections.

Toutes les opérations CRUD de base sont disponibles via IsarCollection.

final newUser = User()
  ..id = isar!.users.autoIncrement()
  ..name = 'Jane Doe'
  ..age = 36;

await isar!.writeAsync((isar) {
  return isar.users.put(newUser); // Insertion & modification
});

final existingUser = isar!.users.get(newUser.id); // Obtention

if (existingUser != null) {
  await isar!.writeAsync((isar) {
    return isar.users.delete(existingUser.id); // Suppression
  });
}

Autre ressources

Vous apprenez mieux visuellement ? Regardez ces vidéos pour commencer avec Isar: