← Flutter / Dart

Flutter / Dart · 21 / 24

Drift-Migrationen mit vorhandenen Daten

Du öffnest eine Datenbank aus Version 1 mit Version 2 und erhältst die vorhandenen Einträge.

  • Groß
  • Anspruchsvoll
  • 90 min

Voraussetzungen: SQL verstehen und Drift/SQLite einordnen

In diesem Tutorial
  1. Die Grenze festlegen
  2. Das Lernprojekt einrichten
  3. Den Erfolgsfall nachvollziehen
  4. Fehler bewusst beobachten
  5. Die Erweiterung selbst lösen
  6. Die Lösung vergleichen
  7. Übung und Lösung
  8. Projektbezug und Quellen

Lernpaket herunterladen

Einrichtung und Prüfstand

Flutter ab 3.41.5 mit Dart 3.11. Zusätzlich Python 3 für den gemeinsamen Prüfstart. Entpacke das Lernpaket in einen neuen Ordner und führe dort python3 run_checks.py aus. Das Skript kopiert die enthaltenen Dateien in einen temporären Lernordner. Dort prüft es zuerst das Beispiel und danach die mitgelieferte Lösung. Die Ausgangsdateien bleiben erhalten. Benötigte Pakete werden beim ersten Lauf aus dem Netz geladen.

Geprüft am 20.10.2026 unter Linux x86_64. Prüfe, dass alte Namen erhalten bleiben, archived den Standardwert erhält und ein erneutes Öffnen kein zweites Upgrade benötigt. Das Löschen der Datei wäre kein Migrationstest.

Eine frische Datenbank prüft keinen Upgrade-Pfad. Deshalb erzeugt der Test zunächst eine echte Datei mit dem alten Schema und einem Datensatz. Danach wird dieselbe Datei mit der neuen Version geöffnet. Der neue Standardwert muss für den alten Datensatz gelten. Eine zweite Öffnung prüft, dass die Migration nicht erneut ausgeführt wird.

Paketinhalt und einzelne Dateien

01Die Grenze festlegen

Eine neue Spalte ist ein Schemawechsel. Die Migration ergänzt archived mit einem definierten Standardwert. Der Test erzeugt zuerst die alte Datei und öffnet sie danach mit dem neuen Schema. Eine frisch erzeugte Datenbank würde diesen Fehlerfall nicht abdecken.

lib/model.dart · dartDatei öffnen
import 'dart:io';
import 'package:drift/drift.dart';
import 'package:drift/native.dart';

class VehicleDb extends GeneratedDatabase {
  VehicleDb(File file, this.version) : super(NativeDatabase(file));
  final int version;
  @override
  int get schemaVersion => version;
  @override
  Iterable<TableInfo> get allTables => const [];
  @override
  MigrationStrategy get migration => MigrationStrategy(
    onCreate: (_) async {
      await customStatement(
        'CREATE TABLE vehicles(id INTEGER PRIMARY KEY, name TEXT NOT NULL)',
      );
      if (version >= 2) await addArchived();
    },
    onUpgrade: (_, from, to) async {
      if (from < 2 && to >= 2) await addArchived();
    },
  );
  Future<void> addArchived() => customStatement(
    'ALTER TABLE vehicles ADD COLUMN archived INTEGER NOT NULL DEFAULT 0',
  );
  Future<void> insert(String name) =>
      customStatement('INSERT INTO vehicles(name) VALUES (?)', [name]);
  Future<List<QueryRow>> rows() =>
      customSelect('SELECT * FROM vehicles ORDER BY id').get();
}

02Das Lernprojekt einrichten

Die Abhängigkeiten sind direkt fixiert. Entpacke alle Dateien zusammen und starte flutter pub get. Verwende für Tests keine bestehende App-Datenbank. Die Testfälle erzeugen ihre eigenen Daten und räumen sie wieder auf.

pubspec.yaml · yamlDatei öffnen
name: learning_example
publish_to: none
environment:
  sdk: ">=3.11.0 <4.0.0"
dependencies:
  flutter:
    sdk: flutter
  flutter_riverpod: 3.3.1
  drift: 2.33.0
  path_provider: 2.1.5
dev_dependencies:
  flutter_test:
    sdk: flutter
flutter:
  uses-material-design: true

03Den Erfolgsfall nachvollziehen

Prüfe, dass alte Namen erhalten bleiben, archived den Standardwert erhält und ein erneutes Öffnen kein zweites Upgrade benötigt. Das Löschen der Datei wäre kein Migrationstest.

test/model_test.dart · dartDatei öffnen
import 'dart:io';
import 'package:flutter_test/flutter_test.dart';
import 'package:learning_example/model.dart';

void main() {
  test('v1 data survives upgrade and reopening', () async {
    final directory = await Directory.systemTemp.createTemp('migration-');
    addTearDown(() => directory.delete(recursive: true));
    final file = File('${directory.path}/learning.sqlite');
    final old = VehicleDb(file, 1);
    await old.insert('Family car');
    await old.close();
    final upgraded = VehicleDb(file, 2);
    final rows = await upgraded.rows();
    expect(rows.single.read<String>('name'), 'Family car');
    expect(rows.single.read<int>('archived'), 0);
    await upgraded.close();
    final reopened = VehicleDb(file, 2);
    expect(await reopened.rows(), hasLength(1));
    await reopened.close();
  });
}

Starten / prüfen

flutter pub get
flutter test
Erwartetes Ergebnis

Prüfe, dass alte Namen erhalten bleiben, archived den Standardwert erhält und ein erneutes Öffnen kein zweites Upgrade benötigt. Das Löschen der Datei wäre kein Migrationstest.

04Fehler bewusst beobachten

Ändere eine erwartete Zahl oder einen erwarteten Zustand im Test. flutter test muss fehlschlagen. Stelle danach die richtige Erwartung wieder her. Unterscheide eine fachliche Abweichung von einem fehlenden Plugin oder einer fehlenden Entwicklungsumgebung.

05Die Erweiterung selbst lösen

Prüfe zusätzlich eine leere Neuinstallation direkt auf Version 2.

06Die Lösung vergleichen

Neuinstallation und Upgrade müssen dasselbe nutzbare Schema ergeben. Die Lösung schreibt in eine neue V2-Datei und prüft anschließend archived. Sie ersetzt den Upgrade-Test nicht.

Erwartetes Ergebnis

flutter test besteht für Ausgangsbeispiel und ergänzte Lösung.

Deine Übung

Prüfe zusätzlich eine leere Neuinstallation direkt auf Version 2.

Lösung mit Erklärung anzeigen

Neuinstallation und Upgrade müssen dasselbe nutzbare Schema ergeben. Die Lösung schreibt in eine neue V2-Datei und prüft anschließend archived. Sie ersetzt den Upgrade-Test nicht.

solution/model_test.dart · dartDatei öffnen
import 'dart:io';
import 'package:flutter_test/flutter_test.dart';
import 'package:learning_example/model.dart';

void main() {
  test('fresh v2', () async {
    final dir = await Directory.systemTemp.createTemp('fresh-');
    final db = VehicleDb(File('${dir.path}/new.sqlite'), 2);
    try {
      await db.insert('New');
      expect((await db.rows()).single.read<int>('archived'), 0);
    } finally {
      await db.close();
      await dir.delete(recursive: true);
    }
  });
  test('v1 data survives upgrade and reopening', () async {
    final directory = await Directory.systemTemp.createTemp('migration-');
    addTearDown(() => directory.delete(recursive: true));
    final file = File('${directory.path}/learning.sqlite');
    final old = VehicleDb(file, 1);
    await old.insert('Family car');
    await old.close();
    final upgraded = VehicleDb(file, 2);
    final rows = await upgraded.rows();
    expect(rows.single.read<String>('name'), 'Family car');
    expect(rows.single.read<int>('archived'), 0);
    await upgraded.close();
    final reopened = VehicleDb(file, 2);
    expect(await reopened.rows(), hasLength(1));
    await reopened.close();
  });
}

Projektbezug und Quellen

Das eigenständige Lernprojekt vertieft ein Thema aus diesem Technologiebereich. Die Projektverweise zeigen einen festgehaltenen Quellstand als Architekturkontext. Sie sind kein Beleg dafür, dass jede hier neu eingeführte Bibliothek oder Funktion bereits in dieser App verwendet wird.