Tutorial 0 - Vamos nos preparar!¶
Antes de criarmos nosso primeiro aplicativo BeeWare, precisamos garantir que tenhamos todos os pré-requisitos para executar o BeeWare.
Instalando o Python¶
A primeira coisa que precisaremos é de um interpretador Python instalado e funcionando.
Se você estiver usando o macOS, uma versão recente do Python já está incluída no Xcode ou nas ferramentas de linha de comando. Para verificar se você já o possui, execute o seguinte comando:
$ python3 --version
Se o Python estiver instalado, você verá o número da versão. Caso contrário, será solicitado que instale as ferramentas de linha de comando para desenvolvedores.
Se estiver usando o Windows, você pode baixar o instalador oficial no site do Python. Recomendamos usar qualquer versão estável do Python a partir da 3.8. Evite versões alpha, beta e candidatas a lançamento, a menos que você esteja realmente familiarizado com essas versões de desenvolvimento.
Se você estiver usando Linux, será necessário instalar o Python por meio do gerenciador de pacotes do sistema (apt no Debian/Ubuntu/Mint, dnf no Fedora, ou pacman no Arch).
Certifique-se de que a versão do Python do sistema seja 3.8 ou mais recente. Se não for (por exemplo, o Ubuntu 18.04 é fornecido com o Python 3.6), será necessário atualizar a distribuição Linux para uma versão mais recente.
Para o Raspberry Pi, o suporte está limitado neste momento.
Se estiver usando o Windows, você pode baixar o instalador oficial no site do Python. Recomendamos usar qualquer versão estável do Python a partir da 3.8. Evite versões alpha, beta e candidatas a lançamento, a menos que você esteja realmente familiarizado com essas versões de desenvolvimento.
Distribuições Alternativas do Python
Existem várias maneiras diferentes de instalar o Python. Você pode instalar o Python através do homebrew. Pode usar o pyenv para gerenciar várias instalações do Python na mesma máquina. Usuários do Windows podem instalar o Python pela Windows App Store. Usuários com foco em ciência de dados podem preferir utilizar o Anaconda ou o Miniconda.
Se você estiver usando macOS ou Windows, não importa a forma que usou ao instalar o Python. o importante é ter um interpretador Python operando ao executar o comando python3
no prompt de comando/terminal do seu sistema operacional.
Caso esteja no Linux, é recomendado utilizar o Python fornecido pelo seu sistema operacional. Embora seja possível concluir a maior parte deste tutorial utilizando uma versão não integrada ao sistema, você não conseguirá empacotar sua aplicação para distribuição a outros.
Instale as dependências¶
Em seguida, instale as dependências adicionais necessárias para o seu sistema operacional:
Para criar aplicativos BeeWare no macOS, é necessário:
Git, um sistema de controle de versão. Ele está incluso no Xcode ou nas ferramentas de linha de comando, que você instalou acima.
Para dar suporte ao desenvolvimento local, será necessário instalar alguns pacotes do sistema. A lista de pacotes necessários pode variar de acordo com a sua distribuição:
Ubuntu 20.04+ / Debian 10+
$ sudo apt update
$ sudo apt install git build-essential pkg-config python3-dev python3-venv libgirepository1.0-dev libcairo2-dev gir1.2-gtk-3.0 libcanberra-gtk3-module
Fedora
$ sudo dnf install git gcc make pkg-config rpm-build python3-devel gobject-introspection-devel cairo-gobject-devel gtk3 libcanberra-gtk3
Arch, Manjaro
$ sudo pacman -Syu git base-devel pkgconf python3 gobject-introspection cairo gtk3 libcanberra
OpenSUSE Tumbleweed
$ sudo zypper install git patterns-devel-base-devel_basis pkgconf-pkg-config python3-devel gobject-introspection-devel cairo-devel gtk3 'typelib(Gtk)=3.0' libcanberra-gtk3-module
Para criar aplicativos BeeWare no Windows, é necessário:
Git, um sistema de controle de versão. Você pode baixar o Git em git-scm.org.
Após instalar essas ferramentas, é importante reiniciar qualquer sessão de terminal. No Windows, apenas os terminais iniciados após a conclusão da instalação mostrarão as ferramentas recém-instaladas.
Configurar um ambiente virtual¶
Agora vamos criar um ambiente virtual - uma «sandbox» que podemos usar para isolar nosso trabalho neste tutorial de nossa instalação principal do Python. Se instalarmos pacotes no ambiente virtual, nossa instalação principal do Python (e qualquer outro projeto Python em nosso computador) não será afetada. Se bagunçarmos completamente nosso ambiente virtual, podemos simplesmente excluí-lo e começar novamente, sem afetar nenhum outro projeto Python em nosso computador e sem a necessidade de reinstalar o Python.
$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate
$ mkdir beeware-tutorial
$ cd beeware-tutorial
$ python3 -m venv beeware-venv
$ source beeware-venv/bin/activate
C:\...>md beeware-tutorial
C:\...>cd beeware-tutorial
C:\...>py -m venv beeware-venv
C:\...>beeware-venv\Scripts\activate
Erros ao executar scripts do PowerShell
Se você estiver usando o PowerShell e receber o erro:
File C:\...\beeware-tutorial\beeware-venv\Scripts\activate.ps1 cannot be loaded because running scripts is disabled on this system.
Sua conta do Windows não possui permissões para executar scripts. Para corrigir isso:
Execute o Windows PowerShell como Administrador.
Execute
set-executionpolicy RemoteSigned
Selecione
Y
para alterar a política de execução.
Depois de fazer isso, você pode executar novamente o comando beeware-venv\Scripts\activate.ps1
na mesma janela do PowerShell em que você fez as alterações nas permissões (a janela original) ou em uma nova janela do PowerShell no mesmo diretório.
Se isso funcionou, seu prompt deve estar diferente agora - ele deve ter um prefixo (beeware-venv)
. Isso indica que você está atualmente no seu ambiente virtual BeeWare. Sempre que estiver trabalhando neste tutorial, certifique-se de que seu ambiente virtual esteja ativado. Se não estiver, execute novamente o último comando (o comando activate
) para reativar seu ambiente.
Ambientes virtuais alternativos
Caso esteja usando o Anaconda ou Miniconda, você pode estar mais familiarizado com o uso de ambientes conda. Você também deve ter ouvido falar do virtualenv
, um antecessor do módulo venv
integrado ao Python. Da mesma forma que as instalações do Python - se você estiver no macOS ou Windows, não importa como você cria seu ambiente virtual, desde que tenha um. Se estiver no Linux, é recomendado usar o venv
e o Python do sistema.
Próximos passos¶
Agora que configuramos nosso ambiente, estamos prontos para criar nossa primeira aplicação BeeWare.