Ir para o conteúdo

Tutorial 0 - Vamos nos preparar!

Antes de criarmos nosso primeiro aplicativo BeeWare, precisamos garantir que tenhamos todos os pré-requisitos para executar o BeeWare.

Instalar o Python

A primeira coisa que precisaremos é de um interpretador Python instalado e funcionando.

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.

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.

O Xcode e as ferramentas de desenvolvimento de linha de comando fornecem uma versão do Python; no entanto, esse Python é a versão 3.9. O Python 3.9 chegou ao fim da vida útil e não é mais suportado pelo Python ou pelo BeeWare. Você não poderá usar a versão do Python fornecida pelo Xcode para executar este tutorial.

Para verificar a versão do Python que você instalou, execute o seguinte comando:

$ python3 --version

Se o Python estiver instalado, você verá o número da versão.

Se você estiver usando Linux, será necessário instalar o Python por meio do gerenciador de pacotes do sistema ([aptno Debian/Ubuntu/Mint,dnfno Fedora, oupacman` 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.

Importante: Você deve usar o sistema Python fornecido pelo seu sistema operacional. Instalações do Python provenientes de outras fontes (como uv, pyenv, Anaconda, Python compilado manualmente, etc.) impedirão que você empacote com sucesso seu aplicativo para distribuição nas etapas posteriores deste tutorial.

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.

Para o Raspberry Pi, o suporte está limitado neste momento.

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.

Instalar 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á incluído no Xcode ou nas ferramentas de linha de comando para desenvolvedores, que você instalou acima. Talvez seja necessário abrir o Xcode pela primeira vez para que o Git funcione em sua sessão de terminal. Se ainda assim não for registrado que o Git está instalado, talvez seja necessário reiniciar a sessão do terminal.

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

Red Hat / 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

Outras distribuições Linux

Se você estiver usando uma distribuição Linux que não consta nesta lista e não seja derivada de nenhuma das distribuições listadas (por exemplo, Linux Mint e Pop! OS são distribuições derivadas do Debian; AlmaLinux é derivada do Fedora), provavelmente terá dificuldade para concluir este tutorial. Se o Briefcase exibir uma mensagem de aviso informando que “Não é possível verificar os pacotes do sistema”, você não poderá concluir este tutorial.

Para criar aplicativos BeeWare no Windows, é necessário:

  • Git, um sistema de controle de versão. Você pode baixar o Git em [git-scm.com].

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 -3.12 -m venv beeware-venv
C:\...>beeware-venv\Scripts\activate

Se você não estiver usando o Python 3.12, substitua o -3.12 nestas instruções pelo número da versão que você está usando.

Erros na execução de 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 tem permissão para executar scripts. Para corrigir isso:

  1. Execute o Windows PowerShell como Administrador.
  2. Execute set-executionpolicy RemoteSigned
  3. 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

Se você estiver usando o Anaconda ou o miniconda, talvez esteja mais familiarizado com o uso de ambientes conda. Talvez você também já tenha ouvido falar do virtualenv, um predecessor do módulo venv incorporado do Python. Assim como nas instalações do Python, se você estiver no macOS ou no Windows, não importa como você cria seu ambiente virtual, desde que tenha um. Se estiver no Linux, você deve 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.