Instalação e Configuração do Ambiente
Para utilizar o scaffold do GetX, é necessário instalar o pacote globalmente. Execute o seguinte comando no terminal:
flutter pub global activate get_cli
Após a conclusão, é fundamantal configurar as variáveis de ambiente para que o comando get seja reconhecido pelo sistema. No macOS ou Linux, adicione o caminho do cache do pub ao seu arquivo de configuração do shell (como .zshrc ou .bashrc):
# Configurando o caminho do GetX CLI
export PATH="$PATH":"$HOME/.pub-cache/bin"
Recarregue as configurações do shell para aplicar as alterações imediatamente:
source ~/.zshrc
Para verificar se a instalação foi bem-sucedida, você pode executar get -v para checar a versão.
Criação de um Novo Projeto
O comando para inicializar um novo projeto é get create project.
get create project
Nota sobre compatibilidade: Em versões mais recentes do Dart (3.4+), você pode encontrar um aviso de depreciação relacionado ao waitFor durante a seleção interativa. Se o comando falhar com uma exceção síncrona, utilize a versão corrigida diretamente do repositório:
flutter pub global activate --source=git https://github.com/inyong1/get_cli.git
Durante a criação, o CLI solicitará o tipo de projeto (Flutter ou Get Server), o nome do projeto (ex: loja_virtual), o domínio da empresa (ex: com.minhaempresa), as linguagens para iOS (Swift) e Android (Kotlin), a aplicação de linters e a escolha da arquitetura (GetX Pattern ou CLEAN).
Geração de Estrutura de Páginas e Componentes
Uma vez dentro do diretório do projeto, o CLI acelera a criação de arquivos seguindo o padrão escolhido.
Criar uma Página
Gera automaticamente o controller, view, binding e configura as rotas.
get create page:dashboard
Criar um Controller
Adiciona um controller adicional a uma página ou módulo existente.
get create controller:stats on dashboard
Criar uma View
Gera apenas o arquivo de visualização (Widget) para um módulo.
get create view:grafico on dashboard
Criar um Provider
Utilizado para configurar requisições de API utilizando o GetConnect.
get create provider:produtos on dashboard
Internacionalização e Modelos de Dados
Configurar Locales
Para conifgurar traduções e múltiplos idiomas, gere os arquivos de localização:
get generate locales assets/i18n
Gerar Modelos a partir de JSON
O CLI pode converter arquivos JSON ou respostas de API em clases Dart modeláveis.
Incluindo o Provider para requisições:
get generate model on perfil with assets/data/usuario.json
Apenas a classe do modelo, sem o Provider:
get generate model on perfil with assets/data/usuario.json --skipProvider
Diretamente a partir de uma URL de API:
get generate model on perfil from "https://jsonplaceholder.typicode.com/users/1"
Gerenciamento de Dependências
O CLI também atua como um wrapper prático para o gerenciador de pacotes do Dart/Flutter.
Instalar pacotes (dependencies)
Versão mais recente:
get install cached_network_image
Múltiplos pacotes simultaneamente:
get install flutter_svg image_picker
Versão específica:
get install provider:6.0.0
Instalar pacotes de desenvolvimento (dev_dependencies)
get install flutter_launcher_icons --dev
Remover pacotes
Remoção única:
get remove flutter_svg
Remoção múltipla:
get remove image_picker cached_network_image
Comandos Auxiliares
Atualizar o próprio scaffold do CLI para a versão mais recente:
get update
Exibir o menu de ajuda com todos os comandos disponíveis:
get help