Skip to main content

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

贡献

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

发布历史 发布通知| RSS订阅