Solucionar problemas de instalação do AWS Toolkit for Visual Studio - AWS Kit de ferramentas com Amazon Q
Permissões de administrador do Visual StudioObter um log de instalaçãoInstalar diferentes extensões do Visual StudioEntrar em contato com o suporte

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solucionar problemas de instalação do AWS Toolkit for Visual Studio

Sabemos que as informações a seguir podem resolver problemas comuns de instalação durante a configuração do AWS Toolkit for Visual Studio.

Se você encontrar um erro ao instalar o AWS Toolkit for Visual Studio ou se não estiver claro se a instalação foi concluída ou não, revise as informações em cada uma das seções a seguir.

Permissões de administrador do Visual Studio

A extensão AWS Toolkit for Visual Studio requer permissões de administrador para garantir que todos os serviços e recursos da AWS estejam acessíveis.

Se você tiver permissões de administrador local, é possível que suas permissões de administrador não se estendam diretamente à instância do Visual Studio.

Para iniciar localmente o Visual Studio com permissões de administrador:

  1. No Windows, localize o inicializador de aplicações do Visual Studio (ícone).

  2. Abra o menu de contexto (clique com o botão direito) do ícone do Visual Studio e abra o menu de contexto.

  3. Escolha Executar como administrador no menu de contexto.

Para iniciar remotamente o Visual Studio com permissões de administrador:

  1. No Windows, localize o inicializador de aplicações que você está usando para se conectar à instância remota do Visual Studio.

  2. Abra o menu de contexto (clique com o botão direito) do ícone do Visual Studio e abra o menu de contexto.

  3. Escolha Executar como administrador no menu de contexto.

nota

Se você estiver iniciando o programa localmente ou se conectando remotamente, o Windows poderá solicitar que você confirme suas credenciais administrativas.

Obter um log de instalação

Se você concluiu as etapas na seção Permissões de administrador, localizada acima, e foi confirmado que você está executando ou se conectando ao Visual Studio com permissões de administrador, a obtenção de um arquivo de log de instalação pode ajudar a diagnosticar outros problemas.

Para instalar manualmente o AWS Toolkit for Visual Studio por meio de de um arquivo .vsix e gerar um arquivo de log de instalação, conclua as etapas a seguir.

  1. Na página inicial do AWS Toolkit for Visual Studio, siga o link Baixar e salve o arquivo .vsix da versão do AWS Toolkit for Visual Studio que você deseja instalar.

  2. No menu principal do Visual Studio, expanda o cabeçalho Ferramentas e o submenu Linha de comando e escolha Prompt de comando de desenvolvedor do Visual Studio.

  3. No Prompt de comando de desenvolvedor do Visual Studio, digite o comando vsixinstaller com o seguinte formato:

    vsixinstaller /logFile:[file path to log file] [file path to Toolkit installation file]

  4. Substitua [file path to log file] pelo nome do arquivo e pelo caminho completo do diretório no qual você deseja que o log de instalação seja criado. Um exemplo do comando vsixinstaller com o caminho e o nome do arquivo especificados é semelhante ao seguinte:

    vsixinstaller /logFile:C:\Users\Documents\install-log.txt [file path to AWSToolkitPackage.vsix]

  5. Substitua [file path to Toolkit installation file] pelo caminho completo do arquivo do diretório em que o AWSToolkitPackage.vsix está localizado.

    Um exemplo do comando vsixinstaller com o caminho completo do arquivo de instalação do kit de ferramentas deve ser semelhante ao seguinte:

    vsixinstaller /logFile:[file path to log file] C:\Users\Downloads\AWSToolkitPackage.vsix

  6. Verifique se o nome e os caminhos do arquivo estão corretos e execute o comando vsixinstaller.

    Um exemplo de um comando vsixinstaller completo é semelhante ao seguinte:

    vsixinstaller /logFile:C:\Users\Documents\install-log.txt C:\Users\Downloads\AWSToolkitPackage.vsix

Instalar diferentes extensões do Visual Studio

Se você obteve um arquivo de log de instalação e ainda não consegue determinar por que o processo de instalação está apresentando falha, verifique se consegue instalar outras extensões do Visual Studio. A instalação de diferentes extensões do Visual Studio pode fornecer informações adicionais sobre problemas de instalação. Caso você não consiga instalar nenhuma extensão do Visual Studio, talvez seja necessário solucionar problemas do Visual Studio, e não do AWS Toolkit for Visual Studio.

Entrar em contato com o suporte

Se você revisou todas as seções contidas neste guia e precisa de recursos ou suporte adicionais, você pode ver os problemas anteriores ou abrir um novo problema no menu Issues do Github da AWS Toolkit for Visual Studio.

Para ajudar a agilizar uma solução para seu problema:

  • Verifique os problemas anteriores e atuais para ver se outras pessoas se depararam com uma situação semelhante.

  • Faça anotações detalhadas de cada etapa que você executou para resolver o problema.

  • Salve todos os arquivos de log que você obteve da instalação do AWS Toolkit for Visual Studio ou de outras extensões.

  • Anexe os arquivos de log de instalação do AWS Toolkit for Visual Studio ao novo problema.