Tutorial 1 - Seu primeiro app#

Estamos prontos para criar nossa primeira aplicação.

Instale as ferramentas do BeeWare#

Primeiro, precisamos instalar o Briefcase. Briefcase é uma ferramenta do BeeWare que pode ser usada para empacotar sua aplicação para distribuição aos usuários finais - mas também pode ser usada para iniciar um novo projeto. Certifique-se de estar no diretório beeware-tutorial que você criou em Tutorial 0, com o ambiente virtual beeware-venv ativado, e execute:

(beeware-venv) $ python -m pip install briefcase

Uma das ferramentas do BeeWare é o Briefcase. O Briefcase pode ser usado para empacotar sua aplicação para distribuição aos usuários finais - mas ele também pode ser usado para iniciar um novo projeto.

Iniciar um novo projeto#

Vamos começar nosso primeiro projeto BeeWare! Usaremos o comando new do Briefcase para criar um aplicativo chamado Hello World. Execute o seguinte comando no seu prompt de comando/terminal:

(beeware-venv) $ briefcase new

O Briefcase solicitará alguns detalhes sobre nosso novo aplicativo. Para os propósitos deste tutorial, utilize o seguinte:

  • Formal Name - Aceite o valor padrão: Hello World.

  • App Name - Aceite o valor padrão: helloworld.

  • Bundle - Se você possui seu próprio domínio, insira esse domínio invertido. (Por exemplo, se você possui o domínio «cupcakes.com», insira com.cupcakes como nome do bundle). Se você não possui seu próprio domínio, aceite o padrão (com.example).

  • Project Name - Aceite o valor padrão: Hello World.

  • Description - Aceite o valor padrão (ou, se quiser ser realmente criativo, crie sua própria descrição!)

  • Author - Insira seu próprio nome.

  • Author’s email - Insira seu próprio endereço de e-mail. Ele será usado no arquivo de configuração, em textos de ajuda e em qualquer lugar onde um e-mail seja necessário ao enviar o aplicativo para uma loja de aplicativos.

  • URL - A URL da página inicial do seu aplicativo. Novamente, se você possui seu próprio domínio, insira uma URL nesse domínio (incluindo o https://). Caso contrário, apenas aceite a URL padrão (https://example.com/helloworld). Esta URL não precisa realmente existir (por enquanto); ela será usada apenas se você publicar sua aplicação em uma loja de aplicativos.

  • License - Aceite o valor padrão (BSD). Isso não afetará nada sobre o funcionamento do tutorial. Se você tem preferências particulares em relação à escolha de licença, sinta-se à vontade para escolher outra licença.

  • GUI framework - Aceite a opção padrão, Toga (a própria biblioteca de interface gráfica da BeeWare).

O Briefcase então gerará uma estrutura básica de projeto para você usar. Se você seguiu este tutorial até agora e aceitou as configurações padrão como descrito, seu sistema de arquivos deve se parecer com algo assim:

beeware-tutorial/
    beeware-venv/
        ...
    helloworld/
        CHANGELOG
        LICENSE
        README.rst
        pyproject.toml
        src/
            helloworld/
                resources/
                    helloworld.icns
                    helloworld.ico
                    helloworld.png
                __init__.py
                __main__.py
                app.py
        tests/
            __init__.py
            helloworld.py
            test_app.py

Essa estrutura atual já é um aplicativo totalmente funcional sem adicionar mais nada. A pasta src contém todo o código do aplicativo, a pasta tests contém uma suíte de testes inicial, e o arquivo pyproject.toml descreve como empacotar o aplicativo para distribuição. Se você abrir o pyproject.toml em um editor, verá os detalhes de configuração que você acabou de fornecer ao Briefcase.

Agora que temos um aplicativo inicial, podemos usar o Briefcase para executar a aplicação.

Inicie o app no modo de desenvolvedor#

Vá para o diretório do projeto helloworld e peça ao Briefcase para iniciar o projeto no modo de Desenvolvedor (ou dev):

(beeware-venv) $ cd helloworld
(beeware-venv) $ briefcase dev

[hello-world] Installing requirements...
...

[helloworld] Starting in dev mode...
===========================================================================

Isso deve abrir uma janela GUI:

Janela do Tutorial 1 “Hello World”, no macOS

Pressione o botão de fechar (ou selecione “Sair” no menu do aplicativo) e pronto! Parabéns - você acabou de criar um aplicativo autônomo e nativo em Python!

Próximos passos#

Agora temos um aplicativo funcional, em execução no modo de desenvolvedor. Podemos adicionar alguma lógica própria para tornar nosso aplicativo um pouco mais interessante. No Tutorial 2, vamos colocar uma interface de usuário mais útil em nossa aplicação.