Python桌面应用开发GTK3 Glade GTK主题

PyGObject简介

PyGObject是一个用于将GTK+和其他GLib库与Python语言绑定的工具。它允许开发者使用Python语言编写基于GTK+和GLib的应用程序，为Python提供了访问GTK3及其依赖库的接口。

• GTK3绑定： PyGObject主要用于与GTK3库进行绑定，使开发者能够使用Python语言构建现代的图形用户界面。
• GLib绑定： 除了GTK3，PyGObject还提供了对GLib库的绑定。GLib是GTK+的底层库，提供了许多通用的功能，例如事件循环、数据结构等。
• 对象系统： PyGObject使用了GTK+的对象系统。在Python中，你可以使用gi.repository模块导入并操作GTK3的类，例如Gtk.Window、Gtk.Button等。
• 自动类型转换： PyGObject通过使用gobject-introspection库，实现了自动的类型转换。这意味着Python开发者可以直接使用GTK3和GLib的API，而无需手动编写大量的绑定代码。
• 异步支持： PyGObject支持GLib的异步操作，允许你以异步的方式执行任务，而不会阻塞应用程序的用户界面。
• 版本兼容性： 由于GTK3是一个不断演进的库，PyGObject也在不断更新以保持与GTK3的兼容性。开发者应该根据他们使用的GTK3版本选择相应的PyGObject版本。

PyGObject Github

• https://github.com/GNOME/pygobject
• https://gitlab.gnome.org/GNOME/pygobject

PyGObject 文档

• https://pygobject.readthedocs.io/en/latest/

PyGObject 安装

注： 以下操作均在 Mac 环境

1. python >= 3.8.16 版本
2. gtk+3版本

安装GTK+3

• GTK Github

  • https://github.com/GNOME/gtk
  • https://gitlab.gnome.org/GNOME/gtk

• GTK官网

  • https://www.gtk.org/
  • https://www.gtk.org/docs/
  • https://docs.gtk.org/gtk4/

• 组件文档

  • https://docs.gtk.org/gtk4/index.html#classes
  • https://docs.gtk.org/gtk4/class.Button.html

# 安装相关依赖
xcode-select --install
brew install pkg-config
brew install gobject-introspection libffi
# 是否支持GTK+
brew search gtk
# 安装gtk+3
brew install gtk+3
# 验证是否安装成功
pkg-config --cflags --libs gtk+-3.0

• 配置环境变量

# 检查 pkgconfig 路径
find / -name pkgconfig
# 检查 libffi 路径
brew --prefix libffi
# 将以上路径添加到环境变量中（.bash_profile 或 .zshrc）
vim ~/.zshrc
export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig/:/usr/local/opt/libffi:$PKG_CONFIG_PATH
source ~/.zshrc

• 使用 pip3 安装 pygobject
  • 搜索pygobject版本：https://pypi.org/search/
  • pygobject历史版本：https://pypi.org/project/PyGObject/#history

pip3 install --upgrade pip
pip3 install pygobject

注意版本问题

gi.require_version("Gtk", "3.0")

使用 gtk+3 版本，如果还有安装 gtk4 需要先将 gtk4 版本卸载，不然import会报错

安装 Glade

Glade是一个用于创建GTK图形用户界面的用户界面构建器。它允许开发者通过可视化方式设计和布局GUI元素，而不必手动编写代码。Glade生成XML格式的描述文件，描述了用户界面的结构和属性。然后，这个XML文件可以由程序加载和解释，从而创建用户界面。

• 可视化设计：Glade提供了一个直观的图形用户界面，允许用户通过拖放方式设计和布局界面元素，无需手动编写代码。
• 生成XML描述文件：设计完成后，Glade会生成一个XML格式的描述文件，其中包含了用户界面的结构和属性信息。
• 与多种编程语言兼容：由于生成的描述文件是基于XML的，因此可以与多种编程语言一起使用。GTK支持多种编程语言，包括C、C++、Python等。
• 与IDE集成：Glade可以与多个集成开发环境（IDE）一起使用，例如GNOME Builder，以便更方便地进行开发和调试。
• Glade Github
  • https://github.com/GNOME/glade
  • https://gitlab.gnome.org/GNOME/glade
• Glade 教程
  • https://developer.gnome.org/
• 安装 Glade

# 目前版本支持gtk+3
brew install glade
glade --version
# 启动glade
glade

• Glade 操作界面

• 保存后会生成如下 demo.glade 文件

<?xml version="1.0" encoding="UTF-8"?>
<!-- Generated with glade 3.40.0 -->
<interface><requires lib="gtk+" version="3.24"/><object class="GtkWindow" id="window"><property name="width-request">400</property><property name="height-request">200</property><property name="can-focus">False</property><property name="title" translatable="yes">demo</property><child><object class="GtkBox" id="box"><property name="visible">True</property><property name="can-focus">False</property><property name="orientation">vertical</property><child><object class="GtkButton" id="button"><property name="label" translatable="yes">button</property><property name="visible">True</property><property name="can-focus">True</property><property name="receives-default">True</property><property name="margin-start">10</property><property name="margin-end">10</property><property name="margin-top">10</property><property name="margin-bottom">10</property></object><packing><property name="expand">False</property><property name="fill">True</property><property name="position">0</property></packing></child><child><object class="GtkComboBoxText" id="combobox"><property name="visible">True</property><property name="can-focus">False</property><property name="margin-start">10</property><property name="margin-end">10</property><property name="margin-top">10</property><property name="margin-bottom">10</property><property name="active">0</property><property name="active-id">1</property><items><item id="1" translatable="yes">item1</item><item id="2" translatable="yes">item2</item><item id="3" translatable="yes">item3</item><item id="4" translatable="yes">item4</item></items></object><packing><property name="expand">False</property><property name="fill">True</property><property name="position">1</property></packing></child><child><object class="GtkEntry" id="entry"><property name="visible">True</property><property name="can-focus">True</property><property name="margin-start">10</property><property name="margin-end">10</property><property name="margin-top">10</property><property name="margin-bottom">10</property></object><packing><property name="expand">False</property><property name="fill">True</property><property name="position">2</property></packing></child></object></child></object>
</interface>

完整示例 demo.py

示例使用 gtk+3 与 demo.glade 文件构建界面

from gi.repository import Gtk
import gi
gi.require_version('Gtk', '3.0')class MyApplication:def __init__(self):builder = Gtk.Builder()builder.add_from_file("demo.glade")self.window = builder.get_object("window")self.window.set_position(Gtk.WindowPosition.CENTER)self.window.connect("destroy", self.__on_window_destroy)self.__button = builder.get_object("button")self.__combobox = builder.get_object("combobox")self.__entry = builder.get_object("entry")self.__button.connect("clicked", self.__on_button_clicked)self.__combobox.connect("changed", self.__on_combobox_changed)self.__entry.connect("changed", self.__on_entry_changed)self.__entry.connect("activate", self.__on_entry_activate)def __on_window_destroy(self, widget):print("Close Window")Gtk.main_quit()def __on_button_clicked(self, widget):print("Hello World!")def __on_combobox_changed(self, widget):selected_index = widget.get_active()selected_text = widget.get_active_text()print("Selected index option:", selected_index, selected_text)def __on_entry_changed(self, widget):new_text = widget.get_text()print("Entry text changed:", new_text)def __on_entry_activate(self, widget):entered_text = widget.get_text()print("Entry activated with text:", entered_text)if __name__ == "__main__":Gtk.init()app = MyApplication()app.window.show_all()Gtk.main()

运行效果

python demo.py

GTK 主题

• https://www.gnome-look.org/browse?cat=135&ord=latest

推荐主题

• https://www.gnome-look.org/p/1403328

• https://github.com/vinceliuice/WhiteSur-gtk-theme

• https://www.gnome-look.org/p/1357889

• https://github.com/vinceliuice/Orchis-theme

• https://github.com/vinceliuice/Mojave-gtk-theme

• https://github.com/paullinuxthemer/Prof-Gnome

全局主题配置

• GTK主题

# Mac 主题文件解压到.themes
# Windows msys64/mingw64/share/themes
cd ~/.themes

# 确保文件夹包含诸如 index.theme 文件以及其他图标和资源文件
ls ~/.themes/WhiteSur-Dark

• 设置主题

# Mac GTK配置文件settings.ini
# Windows msys64/mingw64/etc/gtk-3.0
vim ~/.config/gtk-3.0/settings.ini
# 添加主题
[Settings]
gtk-theme-name = WhiteSur-Dark
gtk-icon-theme-name = WhiteSur-Dark

• 运行效果

• 更新GTK缓存

gtk-update-icon-cache -f ~/.themes/WhiteSur-Dark

项目主题配置

• GTK主题

# Mac 主题文件解压到.themes
# Windows msys64/mingw64/share/themes
cd ~/.themes

• 通过代码指定主题

代码优先级高于settings.ini配置文件

import osif __name__ == "__main__":Gtk.init()# 设置 GTK_THEME 环境变量os.environ['GTK_THEME'] = 'WhiteSur-Dark'app = MyApplication()app.window.show_all()Gtk.main()

• GTK_CSD配置（默认值为0）

GTK_CSD=1时应用样式完全按主题样式

import osif __name__ == "__main__":Gtk.init()# 设置 GTK_THEME 环境变量os.environ['GTK_THEME'] = 'WhiteSur-Dark'# 设置环境变量,GTK_CSD=1应用主题样式os.environ['GTK_CSD'] = '1'app = MyApplication()app.window.show_all()Gtk.main()

Mac 电脑上显示效果