Execução de Comandos no Ambiente de Desenvolvimento

Para interagir com o ecossistema ABP diretamente do Visual Studio, a forma mais eficiente é utilizar o terminal integrado. Você pode acessá-lo clicando com o botão direito sobre a solução ou um projeto específico no Solution Explorer e selecionando a opção "Open in Terminal".

Gerenciamento da ABP CLI

A interface de linha de comando (CLI) do ABP é uma ferramenta global do .NET fundamental para automação de tarefas. Para garantir que você possui a versão mais estável ou para atualizar uma instalação existente, utilize o seguinte comando:

dotnet tool update -g Volo.Abp.Cli

Configuração do ABP Suite

O ABP Suite é uma ferramenta gráfica para produtividade (scaffolding). Antes de instalá-lo, é necessário realizar a autenticação com sua conta oficial:

abp login seu_usuario

Após o login bem-sucedido, proceda com a instalação do utilitário:

abp suite install

Atualização e Resolução de Problemas no Suite

Sempre que houver novas versões do framework, atualize a CLI e o Suite em sequência:

dotnet tool update -g Volo.Abp.Cli
abp suite update

Caso encontre falhas de versão ou inconsistências no cache, recomenda-se uma reinstalação limpa limpando os pacotes locais:

dotnet tool uninstall -g Volo.Abp.Suite
dotnet nuget locals all --clear
abp suite install --version 8.0.2

Manutenção de Cache do NuGet

Se novos pacotes publicados em servidores privados (como Nexus ou ProGet) não estiverem sendo detectados pelo Visual Studio, limpe o cache de requisições HTTP do NuGet:

dotnet nuget locals http-cache --clear

Gestão de Bibliotecas de Frontend (abp install-libs)

Ao iniciar projetos Blazor ou Web que apresentam falta de dependências na pasta wwwroot/libs, utilize o comando de instalação de bibliotecas. Para que funcione corretamente, é necessário ter o Node.js e o gerenciador de pacotes Yarn instalados globalmente:

npm install --global yarn
abp install-libs

Certifique-se de que o arquivo package.json no diretório do projeto esteja configurado corretamente antes da execução.

Ferramentas do Entity Framework Core

Para gerenciar migrações e o banco de dados, a ferramenta dotnet-ef deve estar disponível:

# Instalação global
dotnet tool install -g dotnet-ef

# Atualização
dotnet tool update -g dotnet-ef

Operações de Migração de Dados

O fluxo de trabalho padrão para persistência de dados envolve a criação e aplicação de migrações:

# Gerar uma nova migração
dotnet ef migrations add InitialDatabaseSetup

# Remover a última migração ainda não aplicada
dotnet ef migrations remove

# Sincronizar as mudanças com o banco de dados
dotnet ef database update

Otimização do Sistema Operacional para Caminhos Longos

Projetos .NET com estruturas de pastas profundas podem exceder o limite de caracteres de caminho do Windows. Para habilitar o suporte a caminhos longos (LongPathsEnabled) via PowerShell com privilégios administrativos, execute:

New-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force