Visão geral
freezed_annotation fornece anotações para o gerador de código freezed, permitindo classes Dart concisas e seguras por tipo com suporte integrado para imutabilidade, métodos copyWith e serialização JSON. Funciona em conjunto com o pacote freezed para gerar automaticamente código boilerplate. Este pacote é essencial para desenvolvedores que buscam modelos de dados limpos e sustentáveis sem escrever código repetitivo. Ele suporta práticas modernas do Dart, como classes seladas e tipos união. As anotações são usadas durante a geração de código e não têm impacto no tempo de execução por si só.
Casos de uso
- Gerando classes de dados imutáveis
- Criando classes seladas para gerenciamento de estado
- Automatizando a serialização JSON
- Simplificando a representação de estado na interface do usuário
- Habilitar funcionalidade copyWith
- Definindo tipos união
Principais recursos
- Imutabilidade por padrão
- Métodos copyWith automáticos
- Suporte de serialização JSON
- Geração de classe selada
- Definições de tipo união
- Boilerplate mínimo
Indicado para
- desenvolvedores Dart usando freezed
- Projetos que exigem modelos de dados imutáveis
- Gerenciamento de estado com classes de estado limpas
- JSON-heavy applications
- Equipes que priorizam a manutenibilidade do código
- Aplicativos direcionados a múltiplas plataformas
Considerações
- Requer o pacote freezed para funcionar
- A geração de código deve ser habilitada
- Não adequado para reflexão em tempo de execução
- Limitado à geração de código em tempo de compilação
- As dependências devem ser gerenciadas com cuidado
- Nenhum comportamento de tempo de execução autônomo