Ir para o conteúdo

Lab 1.1: Checklist de Dependências e requerimentos

Pré-requisitos

Para este treinamento, bem como os ambientes de desenvolvimento e execução, você precisará ter em seu computador as seguintes dependências:

  • Navegador Web (Firefox, Chrome ou qualquer outro)
  • Java
  • Python 3.7 ou superior
  • Pacotes Python
    • pip
    • setuptools
    • virtualenv
    • cookiecutter (apenas desenvolvimento)

Java

Para verificar a versão do Java disponível em seu computador faça o seguinte comando no terminal:

java -version

A saída do comando deve ser algo como:

java version "17.0.2" 2022-01-18 LTS
Java(TM) SE Runtime Environment (build 17.0.2+8-LTS-86)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.2+8-LTS-86, mixed mode, sharing)

Caso você não tenha o Java instalado, você pode instalar seguindo as instruções disponíveis em Java Downloads.

Python

Para confirmar a versão do Python disponível em seu sistema faça o seguinte comando no terminal:

python --version

A saída do comando deve ser algo como: 

Python 3.10.2

Caso o Python não esteja disponível em seu sistema, siga as instruções disponíveis no guia Instalando o Python.

Atenção

Em alguns sistemas a versão 3 do Python pode estar acessível como python3 ou py. Para esses casos, teste a versão com:

python3 --version
ou 
py --version

Pacotes Python

Precisaremos também dos seguintes pacotes Python que serão utilizados durante todo o processo:

  • pip
  • setuptools
  • virtualenv
  • cookiecutter

Mesmo tendo esses pacotes instalados é ideal que eles estejam atualizados.

python -m pip install --upgrade pip setuptools virtualenv cookiecutter

Nota

Pode ser que em seu sistema o pip seja identificado como pip3. Ajuste o comando acima conforme o necessário.

Verificando o ambiente

Para garantirmos que tudo está certo para prosseguirmos, siga as etapas abaixo.

Criando um ambiente virtual

Após instalar o pacote virtualenv, vamos testá-lo criando um ambiente virtual temporário:

python -m venv temporario

Ativando o ambiente virtual

Vamos ativar o ambiente virtual para garantirmos que tudo está correto:

temporario\Scripts\activate

source temporario/bin/activate

Instalando um pacote

Vamos verificar permissões e funcionamento do sistema instalando um pacote:

pip install botcity-framework-core

Se chegamos até aqui, o seu ambiente está corretamente configurado! 🏆

Desativando o ambiente virtual

Desative o ambiente virtual com o comando abaixo e remova a pasta temporario:

deactivate

Solução de Problemas

Durante a configuração do ambiente, alguns erros comuns podem acontecer.
Abaixo estão as soluções para os principais problemas relatados.

Pip não é reconhecido

Problema

Ao tentar rodar o pip, o sistema informa que o comando não foi encontrado.

Solução

  • Verifique se o diretório do pip está incluído nas variáveis de ambiente do sistema.
  • Rode o comando abaixo para garantir a instalação do pip:
python -m ensurepip

Sobre o ensurepip

O módulo ensurepip inicializa o instalador do pip em uma instalação existente do Python ou em um ambiente virtual.
Ele não acessa a internet, pois todos os componentes necessários já vêm incluídos no Python.
Esse comando é útil quando o pip não foi instalado junto com o Python ou foi removido.

Para garantir a atualização do pip, use:

python -m ensurepip --upgrade

Erro de permissão ao instalar pacotes com pip

Problema

Ao instalar pacotes, pode aparecer uma mensagem de erro como:

ERROR: Could not install packages due to an OSError: [Errno 13] Permission denied: 'C:\\users\\usuario\\appdata\\local\\pip\\cache\\wheels\\...'

Solução

  • Verifique as permissões da sua conta de usuário.
  • Limpe o cache do pip com o comando:
pip cache purge

Erro ao ativar ambiente virtual no PowerShell

Problema

Ao tentar ativar o ambiente virtual no PowerShell, pode aparecer a mensagem:

temporario\Scripts\activate : File C:\Users\user\Desktop\BotCity\Projeto\temporario\Scripts\Activate.ps1 cannot be loaded because      running scripts is disabled on this system. For more information, see about_Execution_Policies at https://go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:1
+ temporario\Scripts\activate
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

Solução

Use o arquivo .bat em vez do .ps1:

temporario\Scripts\activate.bat

Por que isso acontece?

O PowerShell bloqueia a execução de scripts (Activate.ps1) por padrão devido às Execution Policies.
Se não quiser alterar essa configuração de segurança do PowerShell, utilize o Prompt de Comando (cmd) para ativar o ambiente.