一个 Python 原生、操作系统原生 GUI 工具包。
项目描述
一个 Python 原生、操作系统原生 GUI 工具包。
快速开始
要获得 Toga 功能的演示,请运行以下命令:
$ pip install toga-demo $ toga-demo
这将弹出一个带有一些示例小部件的 GUI 窗口。
先决条件
Toga 有一些最低要求:
如果您使用的是 OS X,则需要使用 10.7 (Lion) 或更高版本。
如果您使用的是 Linux,则需要 GTK+ 3.4 或更高版本。这是从 Ubuntu 12.04 和 Fedora 17 开始附带的版本。
如果您想使用 WebView 小部件,您还需要安装 WebKit,以及安装到 WebKit 的 GI 绑定。
对于由 ( libwebkitgtk-3.0-0 ) 和 ( gir1.2-webkit-3.0 ) 软件包提供的 Ubuntu。
对于 Fedora,它都在 ( webkitgtk3 ) 包中提供。
如果不满足这些要求,Toga 要么根本无法工作,要么没有完整的功能。
源安装问题
在内部,Toga 由许多子包组成 - 每个它支持的平台一个。如果您使用轮子安装,安装过程将正确识别所需的软件包并安装它们。但是,如果您使用 pip 从源代码安装,则 pip 中有一个已知错误会导致无法安装依赖项。可能需要手动安装以下先决条件:
OS X: pip install toga-cocoa
Linux:pip install toga-gtk toga-cassowary食火鸡
Win32: pip install toga-win32 toga-cassowary食火鸡
Linux下使用virtualenv的问题
在 Linux 下运行时,Toga 使用系统本机 python GTK+3 绑定来进行显示。但是,如果您使用--no-site-packages virtualenv,则 GTK 的 Python 绑定不会在您的PYTHONPATH中。
不幸的是,您无法pip install GTK+ 绑定,因此您必须使用解决方法。要使系统 GTK+ 绑定可用于您的 virtualenv,请将系统 dist-packages 目录中的gi模块符号链接到您的 virtualenv 的站点包中:
For a Ubuntu 32bit system (assuming Python 3.5):: $ cd $VIRTUAL_ENV/lib/python3.5/site-packages $ ln -si /usr/lib/python3.5/dist-packages/gi For a Fedora 64bit system (assuming Python 3.5):: $ cd $VIRTUAL_ENV/lib/python3.5/site-packages $ ln -si /usr/lib64/python3.5/site-packages/gi/
文档
Toga 的文档可以在Read The Docs上找到。
社区
Toga 是BeeWare 套件的一部分。您可以通过以下方式与社区交谈:
Gitter 上的pybee/general频道。
贡献
如果您在使用 Toga 时遇到问题,请将其记录在 GitHub 上。如果您想贡献代码,请分叉代码并提交拉取请求。