Convenções de codificação em Flutter e Dart

[beecodersteam]

O Dart e o Flutter têm um conjunto de convenções de codificação bem definidas que a comunidade e o time oficial do Flutter aconselham seguir para manter a consistência e a legibilidade do código. Abaixo, vou resumir as principais recomendações, mas você pode ler os detalhes completos na Dart Language Tour e no Flutter's API documentation (em inglês).

Regras gerais do Dart:

• Identação: Use 2 espaços para identação em vez de tabs.

• Nomes:

  • Use UpperCamelCase para tipos (classes, enums, typedefs, e extensiones).
  • Use lowercase_with_underscores (também conhecido como snake_case) para bibliotecas, pacotes, diretórios, fontes de recursos e arquivos.
  • Use lowerCamelCase para constantes, variáveis, funções, parâmetros, nomes de propriedades, etc.

• Ordenação de declarações: Organize as declarações no topo de uma classe da seguinte maneira: static (primeiro const, depois final, depois variáveis regulares), depois variáveis de instância (primeiro final, depois regulares).

• Imports: Ordene as seções de importação alfabeticamente, mas coloque 'dart:' e 'package:' antes de outros imports.

Guia de estilo Flutter

• Identação: Use a formatação automática do Flutter (flutter format ou dartfmt). Isso cuidará de coisas como indentação e posicionamento de chaves para você.

• Construção de Widgets: Ao construir um widget com vários filhos, coloque cada filho em uma nova linha e alinhe os filhos pelo parâmetro nomeado.

• Funções de construtor: Prefira usar funções de construtor para configuração de widget que não requer contexto.

• Constantes: Use const ao criar widgets que não dependem de nenhum estado. Isso melhora o desempenho do aplicativo.

Por fim, recomenda-se o uso da extensão Dart no Visual Studio Code ou em outros editores de texto compatíveis, que fornecem formatação automática, linting e outras funcionalidades úteis ao escrever Dart e Flutter.