data_migration

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote data_migration fornece uma forma estruturada de evoluir modelos de dados em diferentes versões aplicando uma sequência de migrações. Foi projetado para atualizar com segurança estruturas de dados desatualizadas para o esquema mais recente, garantindo a integridade dos dados durante as atualizações do aplicativo. Os desenvolvedores definem etapas de migração que transformam formatos antigos de dados em novos, tornando-o ideal para aplicativos com armazenamento local persistente. A biblioteca suporta múltiplas plataformas e se integra perfeitamente com aplicativos Flutter.

Casos de uso

Atualizando esquemas de banco de dados locais
Migrando dados do usuário entre versões do aplicativo
Manter compatibilidade com versões anteriores
Manipulando alterações de esquema em preferências compartilhadas
Automatizando a transformação de dados no início do aplicativo
Apoiar a evolução de modelos de dados complexos

Principais recursos

Sistema de migração versão
Transformação segura de dados
Definições de migração extensíveis
Suporte multiplataforma
API simples para definir migrações
Tratamento de erro embutido

Indicado para

Aplicativos com dados locais persistentes
Desenvolvedores gerenciando alterações de esquema
Projetos que exigem compatibilidade com versões anteriores
Equipes usando modelos de dados com versão
Aplicativos Flutter com estruturas de dados em evolução

Considerações

Requer planejamento cuidadoso das etapas de migração
Definição manual de cada migração
Impacto potencial no desempenho com grandes conjuntos de dados
Validação interna limitada
Não adequado para cenários de sincronização em tempo real
Depende do rastreamento correto da versão

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

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."

Buscar pacotes, repositórios e categorias de apps

Instalar pacote