meta · Detalhes do pacote

Visão geral do pacote

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

O pacote meta fornece anotações em Dart que permitem aos desenvolvedores expressar intenções que não são inferíveis por análise estática. Essas anotações, como @required e @deprecated, melhoram a clareza do código e o suporte de ferramentas ao transmitir significado semântico para compiladores, linters e IDEs. Elas são essenciais para documentar comportamentos, impor restrições e permitir uma manutenção de código mais eficaz. O pacote faz parte do SDK do Dart e é amplamente utilizado em projetos Dart e Flutter para melhorar a qualidade do código e a experiência do desenvolvedor.

Casos de uso

Adicionar metadados aos parâmetros para validação obrigatória
Marcando APIs como obsoletas para remoção futura
Melhorando a documentação de código com dicas semânticas
Habilitar verificações de análise estática
Ferramentas de geração de código de apoio
Melhorando o feedback do IDE e das ferramentas

Principais recursos

anotações embutidas como @required e @deprecated
Integra-se de forma transparente com o SDK do Dart
Suporta análise de código e ferramentas
Leve e sem dependências
Usado em todo o ecossistema do Flutter e Dart
Facilita melhor manutenibilidade do código

Indicado para

Autores de bibliotecas Dart e Flutter
Equipes que impõem padrões de qualidade de código
Desenvolvedores usando geração de código
Projetos que exigem documentação de API robusta
Ferramentas e frameworks que precisam de metadados

Considerações

Anotações não afetam o comportamento em tempo de execução
Requer conhecimento de ferramentas de análise estática
Limitado à interpretação em tempo de compilação
Não é um substituto para a documentação adequada
Melhor usado com analisadores e verificadores

README original

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

Dart

An approachable, portable, and productive language for high-quality apps on any platform

Dart is:

Approachable: Develop with a strongly typed programming language that is consistent, concise, and offers modern language features like null safety and patterns.
Portable: Compile to ARM, x64, or RISC-V machine code for mobile, desktop, and backend. Compile to JavaScript or WebAssembly for the web.
Productive: Make changes iteratively: use hot reload to see the result instantly in your running app. Diagnose app issues using DevTools.

Dart's flexible compiler technology lets you run Dart code in different ways, depending on your target platform and goals:

Dart Native: For programs targeting devices (mobile, desktop, server, and more), Dart Native includes both a Dart VM with JIT (just-in-time) compilation and an AOT (ahead-of-time) compiler for producing machine code.
Dart Web: For programs targeting the web, Dart Web includes both a development time compiler (dartdevc) and a production time compiler (dart2js).

Dart platforms illustration

License & patents

Dart is free and open source.

See LICENSE and PATENT_GRANT.

Using Dart

Visit dart.dev to learn more about the language, tools, and to find codelabs.

Browse pub.dev for more packages and libraries contributed by the community and the Dart team.

Our API reference documentation is published at api.dart.dev, based on the stable release. (We also publish docs from our beta and dev channels, as well as from the primary development branch).