data_migration

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das data_migration-Paket bietet eine strukturierte Möglichkeit, Datenmodelle über verschiedene Versionen hinweg durch Anwendung einer Sequenz von Migrationen zu entwickeln. Es ist darauf ausgelegt, veraltete Datenstrukturen sicher auf das aktuellste Schema zu aktualisieren und dabei die Datenintegrität während App-Updates zu gewährleisten. Entwickler definieren Migrations-Schritte, die alte Datenformate in neue umwandeln, was es ideal für Apps mit persistentem lokalen Speicher macht. Die Bibliothek unterstützt mehrere Plattformen und integriert sich nahtlos in Flutter-Anwendungen.

Anwendungsfälle

Lokale Datenbankschemata aktualisieren
Benutzerdaten zwischen App-Versionen migrieren
Die Abwärtskompatibilität erhalten
Schemaänderungen in gemeinsamen Einstellungen verarbeiten
Automatisierung der Datenumwandlung beim App-Start
Unterstützung der komplexen Datenmodell-Evolution

Hauptmerkmale

Versionsbasiertes Migrationsystem
Sichere Datenumwandlung
Erweiterbare Migrationsdefinitionen
Plattformübergreifende Unterstützung
Einfaches API zum Definieren von Migrationen
Eingebaute Fehlerbehandlung

Geeignet für

Apps mit persistierenden lokalen Daten
Entwickler, die Schemaänderungen verwalten
Projekte, die rückwärtskompatibel sein müssen
Teams, die versionierte Datenmodelle verwenden
Flutter-Apps mit sich weiterentwickelnden Datenstrukturen

Hinweise

Erfordert sorgfältige Planung der Migrierungsstufen
Manuelle Definition jeder Migration
Möglicher Leistungseinbruch bei großen Datensätzen
Eingeschränkte eingebaute Validierung
Nicht geeignet für Szenarien mit Echtzeit-Synchronisierung
Abhängig von der korrekten Versionsverfolgung

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

Data Migration

A library for applying a series of migrations to update old versions of data structures to the most recent one.

Installation

dependencies:
  data_migration:

How to use

Create your set of migration

class CounterV1DataMigration implements DataMigration {
  const CounterV1DataMigration();

  @override
  int get fromVersion => 1;

  @override
  int get toVersion => 2;

  @override
  Future<dynamic> migrate(dynamic data) async {
    final counter = SimpleCounter(data as int);
    return counter.toJson();
  }
}

final migrator = DataMigrationManager(
  [
    CounterV1DataMigration(),
  ],
);

Apply migration on data

  final migrated1 = await _migrator.migrateIfNeeded(
     3,
     fromVersion: 1,
  );

Examples

In the example and tests, there are some examples of "data migration."

Pakete, Repositories und App-Kategorien suchen

Paket installieren