Documentação do Flutter em pt-BR

# Instalação no Windows

# Requisitos do sistema

Para instalar e executar o Flutter, seu ambiente de desenvolvimento deve cumprir os seguintes requisitos mínimos:

  • Sistema Operacional: Windows 7 SP1 ou mais atual (64-bit).

  • Espaço em disco: 400 MB (não incluí o espaço em disco necessário para IDE/ferramentas).

  • Ferramentas: O Flutter depende das seguintes ferramentas estarem disponíveis no seu ambiente.

# Obtenha o SDK do Flutter

  1. Baixe o seguinte pacote de instalação para obter a última release de versão estável do SDK do Flutter:
flutter_windows_1.17.1-stable.zip

Para outros canais de release, e versões mais antigas, veja o arquivo de SDK (opens new window).

  1. Extraia o arquivo zip e coloque o flutter na localização desejada para a instalação do SDK do Flutter (por exemplo, C:\src\flutter; não instale o Flutter em um diretório como C:\Arquivos de Programas que requer privilégios elevados).

Se você não deseja instalar a versão fixa do pacote de instalação, você pode pular os passos 1 e 2. Em vez disso, obtenha o código fonte do repositório do Flutter (opens new window) no GitHub, e mude as branches ou tags conforme necessário. Por exemplo:

  
C:src> git clone https://github.com/flutter/flutter.git -b stable

Agora você está pronto para executar os comandos do Flutter no Console do Flutter!

# Atualizando seu path

Se você deseja executar os comandos do Flutter no terminal comum do Windows, siga esses passos para adicionar o Flutter na variável de ambiente PATH:

  • Na barra de busca do menu Iniciar, digite env e selecione Editar as variáveis de ambiente para sua conta.
  • Em Variáveis do usuário verifique se existe um registro chamado Path:
    • Se o registro existir, acrescente o caminho completo até flutter\bin usando ; como separador dos valores existentes
    • Se o registro não existir, crie uma nova variável de usuário chamada Path com o caminho completo para flutter\bin como seu valor.

Note que você precisa fechar e reabrir qualquer terminal do Windows para que as mudanças tenham efeito.

# Execute flutter doctor

De uma janela do terminal que tenha o diretório do Flutter no path (veja acima), execute o seguinte comando para verificar se existe alguma dependência para a plataforma que você necessita para completar a configuração:

  
C:\src\flutter> flutter doctor

Esse comando verifica seu ambiente e mostra um relatório do estado da sua instalação do Flutter. Verifique cuidadosamente as informações para identificar outros programas que você precise instalar ou tarefas adicionais que você precise realizar.

Por exemplo:

[-] Android toolchain - develop for Android devices
  • Android SDK at D:\Android\sdk
  ✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ
  • Try re-installing or updating your Android SDK,
    visit https://flutter.dev/setup/#android-setup for detailed instructions.

As seções seguintes descrevem como realizar essas tarefas e finalizar o processo de instalação. Uma vez que você tenha instalado qualquer uma das dependências ausentes, você pode executar novamente o comando flutter doctor para verificar se tudo foi feito corretamente.

Aviso

A ferramenta flutter usa o Google Analytics para anonimamente reportar estatísticas de uso e relatórios de falha (opens new window). Esses dados são usados para ajudar a melhorar as ferramentas do Flutter com o decorrer do tempo.

O Flutter não envia esses dados na sua primeira execução. Para desabilitar esse envio, digite flutter config --no-analytics. Para exibir a configuração atual, digite flutter config. Se você optar por desabilitar a análise, um evento de saída será enviado, e então nenhuma informação será mais enviada pela ferramenta do Flutter.

Ao baixar o SDK do Flutter, você concorda com os Termos de Serviço do Google.

Nota: A Política de Privacidade (opens new window) do Google descreve como os dados são controlados nesse serviço.

Além disso, o Flutter incluí o SDK do Dart, que pode enviar métricas de utilização e relatórios de falha.

# Configuração do Android

Nota

O Flutter depende de uma instalação completa do Android Studio para fornecer todas as dependências da plataforma Android. Entretanto, você pode escrever seus aplicativos em vários editores diferentes; um passo mais a frente irá discutir isso.

# Instalação do Android Studio

  1. Baixe e instale o Android Studio (opens new window).
  2. Inicie o Android Studio, e siga o "Assistente de Instalação do Android Studio". Ele irá instalar o SDK do Android mais recente, as ferramentas de linha de comando do Android SDK, e as ferramentas de construção do Android Studio, que são necessárias pelo Flutter ao desenvolver para Android.

Aviso

No Android Studio 3.6 ou mais recente, você irá precisar adicionar manualmente a versão antiga das ferramentas de SDK do Android para o Flutter funcionar. Para fazer isso:

  1. Abra o Gerenciador de SDK do Android Studio
  2. Na aba Android SDK, desmarque a opção Esconder pacotes obsoletos
  3. Marque Android SDK Tools (Obsoleto)

A imagem abaixo mostra as configurações adequadas:

Esse é um problema conhecido (opens new window) que será tratado em versões futuras do Flutter.

# Configuração do seu dispositivo Android

Para se preparar para executar e testar seus aplicativos Flutter em um dispositivo Android, você irá precisar de um dispositivo rodando o Android 4.1 (API level 16) ou mais recente.

  1. Habilite as Opções de desenvolvedor e a Depuração USB no seu dispositivo. Instruções detalhadas estão disponíveis na Documentação do Android (opens new window).
  2. Apenas para Windows: Instale o Driver USB do Google (opens new window).
  3. Usando um cabo USB, plugue seu celular no computador. Se solicitado no seu dispositivo, autorize o computador a acessar seu dispositivo.
  4. No terminal, execute o comando flutter devices para verificar se o Flutter reconhece o seu dispositivo Android conectado. Por padrão, o Flutter utiliza a versão do SDK do Android onde a sua ferramenta adb está baseada. Se você deseja que o Flutter use uma instalação diferente da SDK do Android, você deve configurar a variável de ambiente ANDROID_HOME para esse diretório de instalação.

# Configuração de um emulador Android

Para se preparar para executar e testar seus aplicativos Flutter em um emulador Android, siga esses passos:

  1. Habilite a Aceleração de Hardware (opens new window) na sua máquina.
  2. Execute Android Studio > Ferramentas > Android > AVD Manager e selecione Criar um Dispositivo Virtual. (O submenu Android só está presente dentro de um projeto Android.)
  3. Escolha um dispositivo e selecione Próximo
  4. Escolha uma ou mais imagens de sistema para as versões do Android que você quer emular, e selecione Próximo Uma imagem x86 ou x86_64 é recomendada.
  5. Em Performance Emulada, selecione Hardware - GLES 2.0 para habilitar a aceleração por hardware (opens new window).
  6. Verifique se a configuração do AVD está correta, e selecione Finalizar. Para detalhes dos passos acima, veja Gerenciando AVDs (opens new window)
  7. No Gerenciador de Dispositivos Virtuais do Android, clique Executar na barra de ferramentas. O emulador irá iniciar e mostrar a tela inicial para a versão e dispositivo selecionado.

# Configuração Web

O Flutter tem um suporte antecipado para construção de aplicações web usando o canal beta do Flutter. Para adicionar suporte ao desenvolvimento web, siga essas instruções (opens new window) quando você tiver completado as configurações acima.

# Próximo passo

Configurar o seu editor preferido.

←