一个 Python 原生、操作系统原生 GUI 工具包。

导航

项目链接

统计数据

View statistics for this project via Libraries.io, or by using our public dataset on Google BigQuery

Meta

License: BSD License (New BSD)

作者: Russell Keith-Magee

Maintainers

Avatar for freakboy3742 from gravatar.com freakboy3742

分类

项目描述

一个 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 套件的一部分。您可以通过以下方式与社区交谈：

贡献

如果您在使用 Toga 时遇到问题，请将其记录在 GitHub 上。如果您想贡献代码，请分叉代码并提交拉取请求。