Como Instalar Chocolatey no Windows (Passo a Passo)

Se trabalha frequentemente com o Windows e sente que a instalação de software é um processo repetitivo e manual, o Chocolatey pode ser a solução que procura. Pense nele como um “gestor de pacotes” para o Windows, semelhante ao que existe em sistemas Linux (como o apt no Ubuntu ou o yum no Fedora). Permite instalar, atualizar e remover software através de uma simples linha de comandos.

Instalar o Chocolatey no seu computador Windows é o primeiro passo para automatizar a gestão de software e poupar imenso tempo. Embora o processo seja relativamente simples, seguir os passos corretamente é fundamental para garantir que tudo funciona sem problemas. Este guia detalhado irá levá-lo pela mão, explicando cada etapa para que consiga instalar o Chocolatey no Windows com sucesso, mesmo que seja novo na utilização da linha de comandos.

Vamos abordar os pré-requisitos, o comando exato de instalação, como verificar se a instalação foi bem-sucedida e o que fazer se encontrar algum obstáculo. Prepare-se para dar um passo gigante na automatização da administração do seu sistema Windows!

Pré-requisitos para a Instalação do Chocolatey

Antes de mergulharmos na instalação do Chocolatey, é importante garantir que o seu ambiente Windows está preparado. Felizmente, os requisitos são bastante modestos e a maioria dos utilizadores já os cumpre.

Primeiro, certifique-se de que tem uma versão recente do Windows (Windows 7+, Windows Server 2003+). O Chocolatey funciona na maioria das versões modernas, mas ter as atualizações em dia é sempre uma boa prática para compatibilidade e segurança.

Em segundo lugar, o Chocolatey utiliza o PowerShell para a sua instalação e operação. O PowerShell está incluído por defeito na maioria das versões recentes do Windows, mas é bom saber que ele é a base desta ferramenta. Certifique-se de que tem o PowerShell versão 2 ou superior. Para verificar a sua versão do PowerShell, abra o PowerShell (pode pesquisar por “PowerShell” no menu Iniciar) e digite $PSVersionTable.PSVersion. Verifique o número na linha ‘Major’.

Um passo crucial é configurar a política de execução do PowerShell. Por motivos de segurança, o PowerShell tem restrições sobre a execução de scripts. O script de instalação do Chocolatey precisa de ser executado, por isso, precisamos de alterar temporariamente essa política. A política de execução padrão pode ser ‘Restricted’, ‘AllSigned’ ou ‘RemoteSigned’. Para instalar o Chocolatey, precisaremos de permitir a execução do script. Não se preocupe, o comando de instalação do Chocolatey inclui a alteração necessária, mas é importante entender porquê. Esta alteração é feita apenas para o processo atual (‘Scope Process’) e é temporária, regressando à política anterior assim que a janela do PowerShell for fechada, a menos que a altere globalmente (o que não é recomendado para este passo).

Passo 1: Abrir o PowerShell como Administrador

O processo de instalação do Chocolatey requer permissões elevadas no seu sistema Windows, pois irá fazer alterações ao nível do sistema, como adicionar ficheiros de programa e potencialmente modificar variáveis de ambiente. Por essa razão, é absolutamente essencial abrir o PowerShell com privilégios de administrador.

Ignorar este passo resultará, quase certamente, numa falha na instalação, pois o script não terá as permissões necessárias para completar as suas tarefas. Aqui estão as instruções claras para abrir o PowerShell como administrador:

1. Clique no botão Iniciar do Windows.
2. Na barra de pesquisa, digite “PowerShell”.
3. Nos resultados da pesquisa, clique com o botão direito do rato em “Windows PowerShell”.
4. No menu de contexto que aparece, selecione a opção “Executar como administrador”.
5. Poderá aparecer uma janela de Controlo de Conta de Utilizador (UAC) a perguntar se permite que a aplicação faça alterações no seu dispositivo. Clique em “Sim” para continuar.

Uma vez que o PowerShell abra com permissões de administrador, a barra de título da janela deverá indicar explicitamente “Administrador: Windows PowerShell”. Isto confirma que tem os privilégios necessários para prosseguir com a instalação do Chocolatey.

Passo 2: Executar o Comando de Instalação

Com a janela do PowerShell aberta como administrador, estamos prontos para executar o comando mágico que irá instalar o Chocolatey no seu sistema. O comando de instalação é fornecido diretamente pelo site oficial do Chocolatey e é a forma recomendada de instalar a ferramenta.

Este comando faz algumas coisas importantes: primeiro, ajusta temporariamente a política de execução do PowerShell para permitir a execução do script de instalação. Em seguida, descarrega o script de instalação a partir do site oficial e executa-o no seu sistema. A utilização deste método garante que está a descarregar a versão mais recente e oficial do Chocolatey.

Copie o seguinte comando na íntegra. É importante copiá-lo exatamente como está para evitar erros:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Cole o comando na janela do PowerShell (pode normalmente clicar com o botão direito do rato na janela ou usar Shift+Insert). Depois, pressione Enter para executar.

O que esperar após executar o comando? O PowerShell irá descarregar o script e começar a executá-lo. Verá várias linhas de texto a aparecer na janela, indicando o progresso da instalação. O script irá configurar o Chocolatey, criar as pastas necessárias e adicionar o Chocolatey ao PATH do sistema (veremos mais sobre isto no Passo 4). Se tudo correr bem, a instalação demorará apenas alguns momentos. A saída mostrará mensagens de sucesso à medida que os passos são concluídos.

Se encontrar algum erro, verifique se abriu o PowerShell como administrador e se copiou o comando exatamente. Mensagens de erro relacionadas com permissões ou acesso à rede são os problemas mais comuns nesta fase.

Passo 3: Verificar a Instalação

Após executar o comando de instalação, é crucial verificar se o Chocolatey foi instalado corretamente e está acessível a partir da linha de comandos. Este passo é simples e rápido, mas garante que a instalação foi bem-sucedida antes de tentar usar o gestor de pacotes para instalar software.

A maneira mais fácil e fiável de verificar a instalação do Chocolatey é executar o comando para ver a sua versão. Na mesma janela do PowerShell que usou para a instalação (ou pode abrir uma nova, mas certifique-se de que não é uma janela de Prompt de Comandos normal, use PowerShell), digite o seguinte comando:

choco --version

Pressione Enter para executar.

Se a instalação foi bem-sucedida, este comando deverá retornar o número da versão do Chocolatey que foi instalado no seu sistema. Por exemplo, poderá ver algo como “1.4.0” (o número exato dependerá da versão mais recente disponível no momento da sua instalação).

Interpretação da saída:

• Se vir um número de versão (ex: 1.4.0), parabéns! O Chocolatey está instalado e pronto a usar.
• Se vir uma mensagem de erro como “Termo ‘choco’ não é reconhecido como nome de um cmdlet, função, ficheiro de script ou programa operável.”, isso significa que o comando ‘choco’ não foi encontrado.

Solução de problemas comuns nesta fase:

• Comando ‘choco’ não encontrado: A razão mais comum para isto é o Chocolatey não ter sido adicionado corretamente ao PATH do sistema, ou a janela do PowerShell não ter sido reiniciada após a instalação (embora o script de instalação geralmente trate disto). Feche a janela do PowerShell e abra uma nova (como administrador, para garantir), e tente choco --version novamente. Se ainda assim não funcionar, pode ser necessário adicionar o Chocolatey ao PATH manualmente (ver Passo 4).
• Erro durante a execução do comando de instalação: Se o comando de instalação falhou no Passo 2, o Chocolatey não estará instalado. Reveja o Passo 2, garantindo que o PowerShell foi aberto como administrador e que o comando foi copiado e colado corretamente. Problemas de rede também podem impedir o download do script.

Uma vez que obtenha o número da versão, pode ter a certeza de que o Chocolatey está instalado e operacional no seu Windows.

Passo 4: Adicionar o Chocolatey ao PATH (Se necessário)

O PATH é uma variável de ambiente no Windows que diz ao sistema operativo onde procurar por ficheiros executáveis quando digita um comando na linha de comandos ou no PowerShell. Quando digita choco --version, o Windows procura por um ficheiro executável chamado choco nas pastas listadas na variável PATH.

A instalação padrão do Chocolatey através do script no Passo 2 geralmente adiciona automaticamente o diretório onde o choco.exe está instalado (normalmente C:\ProgramData\chocolatey\bin) à variável PATH do seu sistema. Isto permite que execute os comandos do Chocolatey a partir de qualquer diretório no PowerShell ou Prompt de Comandos.

No entanto, se no Passo 3 recebeu a mensagem de erro indicando que o comando ‘choco’ não foi encontrado, é provável que o diretório de instalação do Chocolatey não tenha sido adicionado corretamente ao PATH. Neste caso, precisará de adicioná-lo manualmente.

Aqui estão os passos genéricos para adicionar um diretório ao PATH no Windows:

1. Clique no botão Iniciar do Windows.
2. Pesquise por “variáveis de ambiente” e selecione “Editar as variáveis de ambiente do sistema”.
3. Na janela “Propriedades do Sistema”, clique no botão “Variáveis de Ambiente…”.
4. Na secção “Variáveis do sistema”, encontre a variável chamada “Path” e selecione-a.
5. Clique no botão “Editar…”.
6. Na janela “Editar variável de ambiente”, clique em “Novo” e adicione o caminho para o diretório bin do Chocolatey, que é tipicamente C:\ProgramData\chocolatey\bin.
7. Clique em “OK” em todas as janelas abertas para guardar as alterações.

Após adicionar o caminho ao PATH, é necessário fechar e reabrir as janelas do PowerShell ou Prompt de Comandos para que as alterações na variável de ambiente tenham efeito. Tente executar choco --version novamente numa nova janela para confirmar que o comando é agora reconhecido.

Este passo manual só é necessário se a adição automática ao PATH falhar. Para a maioria dos utilizadores, o Passo 3 já confirmará que o Chocolatey está acessível e este passo pode ser ignorado.

Conclusão

Parabéns! Se seguiu este guia passo a passo, agora tem o Chocolatey instalado e a funcionar no seu sistema Windows. Deu um passo importante em direção à automatização e simplificação da gestão de software no seu computador.

Recapitulando, o processo envolveu verificar os pré-requisitos, abrir o PowerShell como administrador, executar o comando de instalação oficial e verificar se o Chocolatey foi instalado corretamente usando choco --version. Cobrimos também como solucionar o problema comum de o comando ‘choco’ não ser reconhecido, adicionando o diretório de instalação ao PATH.

Agora que tem o Chocolatey instalado, o mundo da automatização de software no Windows está à sua espera. Pode começar a explorar comandos como choco install [nome_do_pacote] para instalar software, choco upgrade all para atualizar todo o seu software instalado via Chocolatey, e choco uninstall [nome_do_pacote] para remover aplicações.

Esperamos que este guia claro e detalhado tenha sido útil. A instalação do Chocolatey é o ponto de partida. Recomendamos que explore a documentação oficial do Chocolatey para descobrir todas as suas capacidades e como pode tornar a sua vida digital mais fácil. Fique atento a futuros artigos onde abordaremos como usar o Chocolatey para instalar e gerir as suas aplicações favoritas.

Teve sucesso na instalação? Encontrou alguma dificuldade? Deixe o seu comentário abaixo e partilhe a sua experiência ou coloque as suas dúvidas!