Criando interfaces gráficas com Python (PyGObject) e Gtk 4

📝 Descrição

Repositório criado para documentar e centralizar conteúdos, dicas, tutoriais e exemplos de código sobre a construção de interfaces gráficas com a linguagem de programação Python (PyGObject) e o toolkit gráfico Gtk 4.

🛠 Tecnologias utilizadas

Até o presente momento as seguintes tecnologias estão sendo utilizadas na construção do projeto:

🤓 Autor

Feito com 💙 por Renato Cruz 🤜🤛 Entre em contato!

Uma das playlist que costumo ouvir quando estou estudando ou "codando" 😁:

Sempre que possível escrevo tutoriais no meu blog pessoal 🚀:

💝 Doações

Ko-Fi

Pix

Chave: b1839493-2afe-484d-9272-82a3e402b36f

🎓 Tutoriais

🔗 Links uteis

Documentação

Softwares

RADs

Gnome Glade. Não é mais recomendado para o desenvolvimento com Gtk 4:

Cambalache (Em desenvolvimento):

Gnome Drafting (Em desenvolvimento):

IDEs

Gnome Builder:

Icons

Sobre o Gtk

O GTK é um toolkit multiplataforma para a criação de interfaces gráficas.

O mesmo utiliza licença GNU LGPL, o que permite a sua utilização para construção de softwares que sejam livres ou proprietários.

Foi desenvolvido inicialmente para o GIMP (GNU Image Manipulation Program), por isso foi batizado de GIMP Toolkit ou simplesmente GTK.

Originalmente criado por, Peter Mattis, Spencer Kimball e Josh MacDonald.

O GTK é comumente utilizado na elaboração de aplicativos para o ambiente de desktop GNOME, contudo por ser multiplataforma pode ser executado sem problemas em diversos sistemas operacionais e ambientes gráficos.

O toolkit é escrito em C e o seu design é orientado a objeto com base no sistema de objetos da biblioteca GLib.

Existe o suporte a diversas linguagens de programação (bindings), contudo as linguagem que são suportadas oficialmente (até o momento que escrevo) são:

Sempre que possível de preferencia por iniciar um projeto utilizando o Gnome Builder.

🚨 O Gnome Builder não está disponível para Microsoft Windows.

Gtk 4

O GTK 4 foi lançado em 16 de dezembro 2020.

No GTK 4 é desencorajado o uso do Gnome Glade, isso porque o Gnome Builder fornece uma forma padronizada e moderna de se criar e gerenciar os projetos.

Arquitetura

bibliotecas:

GLib

GLib é uma biblioteca central de baixo nível que forma a base do GTK. Ele fornece manipulação de estrutura de dados para C, wrappers de portabilidade e interfaces para funcionalidade de tempo de execução como um loop de eventos, threads, carregamento dinâmico e um sistema de objetos.

Pango

Pango é uma biblioteca para layout e renderização de texto com ênfase na internacionalização. Ele forma o núcleo do manuseio de texto e fonte para GTK.

Cairo

Cairo é uma biblioteca para gráficos 2D com suporte para vários dispositivos de saída (incluindo o X Window System, Win32) ao mesmo tempo em que produz uma saída consistente em todas as mídias, aproveitando a aceleração do hardware de exibição quando disponível.

GdkPixbuf

GdkPixbuf é uma biblioteca para carregar ativos gráficos como ícones em vários formatos, como PNG, JPEG e GIF.

ATK

ATK é uma biblioteca para um conjunto de interfaces que fornecem acessibilidade. Ao suportar as interfaces ATK, um aplicativo ou kit de ferramentas pode ser usado com ferramentas como leitores de tela, ampliadores e dispositivos de entrada alternativos.

Gtk 4 estilos

Até o presente momento o Gtk 4 permite a utilização de 2 estilos no desenvolvimneto de aplicativos.

Aplicativo do Gnome

Para utilizar este estilo deve-se adicionar no código Adw.init().

🚨 Ao se utilizar a biblioteca libadwaita juntamente com arquivos de interface (*.ui) é obrigatório o uso de Adw.init() no código.

Caso não seja utilizado é exibido o erro: Error building template class '' for an instance of type '': .:0:0 Invalid object type ''.

Aplicativo Gtk 4

Este é o estilo padrão e para utilizar o mesmo não adicione Adw.init() no código.

Gtk 4 Blueprint

Instalação

Flatpak

Se estiver utilizando o Gnome Builder basta adicionar o seguinte código no arquivo de manifesto que fica na raiz do projeto (*.json):

{
  "name": "blueprint-compiler",
  "buildsystem": "meson",
  "sources": [
    {
      "type": "git",
      "url": "https://gitlab.gnome.org/jwestman/blueprint-compiler",
      "branch": "main"
    }
  ]
}

Instalação manual

Dependências

Debian, Ubuntu e derivados:

sudo apt install \
meson \
ninja-build

Fedora, Centos, RHEL e derivados:

sudo dnf install \
meson \
ninja-build

Arch

sudo pacman -S \
meson

Após realizar a instalação das dependências clone o repositório do blueprint-compiler:

git clone https://gitlab.gnome.org/jwestman/blueprint-compiler.git

Acesse a pasta que foi clonada:

cd blueprint-compiler

Ao acessar a pasta execute:

meson _build

Por fim execute:

ninja -C _build

Sintaxe

Converter arquivos do projeto de *.ui para *.blp:

blueprint-compiler port

📝 comando deve ser executádo na raiz do projeto. Um shell interativo será iniciado.

Gerar arquivo de *.ui a partir de um arquivo *.blp:

blueprint-compiler compile MainWindow.blp --output MainWindow.ui

Extensões

💻 Gtk 4 Widgets

🚜 Em construção 🚧.

Gtk.ActionBar.
Gtk.ApplicationWindow.
Gtk.Box (horizontal).
Gtk.Box (vertical).
Gtk.Button.
Gtk.Calendar.
Gtk.CheckButton.
Gtk.ColorButton.
Gtk.ComboBoxText.
Gtk.Dialog.
Gtk.DragAndDrop (Gtk.DragSource e Gtk.DropTarget).
Gtk.Entry.
Gtk.EntryCompletion.
Gtk.FileChooserDialog (folder).
Gtk.FileChooserDialog (open).
Gtk.FileChooserDialog (save).
Gtk.Fixed.
Gtk.FlowBox.
Gtk.Grid.
Gtk.HeaderBar.
Gtk.Image.
Gtk.InfoBar.
Gtk.ListBox.
Gtk.MenuButton.
Gtk.Overlay.
Gtk.Picture.
Gtk.Popover.
Gtk.PopoverMenu.
Gtk.RadioButton.
Gtk.SearchBar.
Gtk Signal e Slots.
Gtk.StackSidebar.
Gtk.StackSwitcher.
Gtk Style add class.
Gtk.Switch.
Translator (gettext).
Gtk.TreeView editable.
Gtk.TreeView filter.
Gtk.TreeView sort.
Gtk.Video.
Gtk.Window.

💻 Gtk 4 Widgets

🚜 Em construção 🚧.

A libadwaita deve estar disponível a partir do Gnome 41 ou 42, a mesma vem para substituir a biblioteca libhandy.

🚨 Ao se utilizar a biblioteca libadwaita juntamente com arquivos de interface (*.ui) é obrigatório o uso de Adw.init() no código.

Caso não seja utilizado é exibido o erro: Error building template class '' for an instance of type '': .:0:0 Invalid object type ''.

Gtk 4 Libadwaita widgets

Gtk 4 Libadwaita Classes de estilo

🚨 Ao se utilizar a biblioteca libadwaita juntamente com arquivos de interface (*.ui) é obrigatório o uso de Adw.init() no código.

Caso não seja utilizado é exibido o erro: Error building template class '' for an instance of type '': .:0:0 Invalid object type ''.

📝 Para que o estilo visual seja aplicado de forma correta utilize Adw.init() no código.

💡 Extra

Poetry

requirements.txt

Para gerar o arquivo de dependências requirements.txt através do Poetry utilizar o comando:

poetry export \
--without-hashes \
-f requirements.txt \
-o requirements.txt

requirements-dev.txt

Para gerar um arquivo que possua também as dependências de desenvolvimento (requirements-dev.txt):

poetry export \
--dev \
--without-hashes \
-f requirements.txt \
-o requirements-dev.txt

Name		Name	Last commit message	Last commit date
Latest commit History 7 Commits
.github		.github
_includes		_includes
_layouts		_layouts
docs		docs
src		src
tools		tools
.gitignore		.gitignore
CNAME		CNAME
LICENSE		LICENSE
README.md		README.md
_config.yml		_config.yml
poetry.lock		poetry.lock
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt

License

ag-python/gui-python-pygobject-gtk4

Folders and files

Latest commit

History

Repository files navigation

Criando interfaces gráficas com Python (PyGObject) e Gtk 4

📝 Descrição

🛠 Tecnologias utilizadas

🤓 Autor

💝 Doações

Ko-Fi

Pix

🎓 Tutoriais

🔗 Links uteis

Documentação

Softwares

RADs

IDEs

Icons

Sobre o Gtk

Gtk 4

Arquitetura

bibliotecas:

GLib

Pango

Cairo

GdkPixbuf

ATK

Gtk 4 estilos

Aplicativo do Gnome

Aplicativo Gtk 4

Gtk 4 Blueprint

Instalação

Flatpak

Instalação manual

Dependências

Sintaxe

Extensões

💻 Gtk 4 Widgets

💻 Gtk 4 Widgets

Gtk 4 Libadwaita widgets

Gtk 4 Libadwaita Classes de estilo

💡 Extra

Poetry

requirements.txt

requirements-dev.txt

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages