wxPython官方文档中文翻译 - 下载

259 阅读6分钟

官方文档地址:wxpython.org,此文档记录了阅读官网文档过程的翻译

当前版本

从wxPython 4.0(第一个Phoenix版本)开始,wxPython源代码归档文件,以及针对受支持平台的 wxPython二进制wheel文件,都可以从PyPI获取。 wxPython在PyPI上的页面是:pypi.org/project/wxP…

可以直接从项目页面下载源代码或二进制wheel文件,或者你也可以使用出色的pip工具来为你完成下载操作。

Windows和macOS

pip install -U wxPython

如果你使用的是Windows系统或macOS系统,且安装了与之兼容的Python版本,那么上述显示的命令将从最新版本中下载合适的wheel文件,并将其安装到你当前激活的Python环境或虚拟环境中。

如果没有适用于你所在平台或你所使用的Python版本的二进制wheel文件,那么pip将会下载源代码归档文件,并尝试为你进行构建。下面有一些关于此事的信息。

是的,我们有适用于Linux系统的wheel文件。算是有吧。

由于Linux发行版之间存在差异(主要是默认安装的核心库版本不同,同时还包括平台架构等方面的差异),除非能够在PEP 513的限制条件下使二进制wheel文件正常工作,否则不可能在PyPI上托管适用于Linux的二进制wheel文件。遗憾的是,试图让wxPython适配manylinux1的标准并没有取得很大成功。也许manylinux2会更合适一些。与此同时,如果你所使用的Linux系统与用于构建wxPython附加组件的linux文件夹下的wheel文件所基于的Linux系统足够相似,那么你就可以直接使用这些wheel文件,而无需自己去构建wheel了。

由于在发行版和wx端口(GTK2或GTK3)方面存在多种选择,因此这些文件无法全部存放在同一个文件夹中,以便让pip轻松访问。这仅仅意味着你需要再深入查找一下,才能找到要提供给pip的网址。例如,要获取适用于Ubuntu 16.04(以及16.10、LinuxMint 18,可能还有其他版本)的GTK3 wxPython构建版本,你可以使用如下这样的pip命令:

pip install -U \
    -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-16.04 \
    wxPython

当然,你总是可以自己下载wheel文件,然后使用pip来安装你本地的该文件副本。

使用pip构建

如果pip无法找到与你的平台和所使用的Python版本相匹配的二进制wheel文件,那么它将下载源代码归档文件,并尝试为你进行构建。如果你已安装了所需的编译器和依赖库,那么对于你来说,这将是一种可行的方法,尽管构建过程可能需要花费一些时间。最终的结果与有可用的二进制wheel文件时是一样的。实际上,你也可以指示pip仅构建wheel文件而不进行安装。这样一来,你就可以在不同的Python环境中或其他机器上重复使用该wheel文件,或者用于其他任何情况,而无需为每个环境或机器重新进行构建。

有关如何针对你自己的Linux机器和所安装的Python来构建wxPython的wheel文件的说明,请参考博客中的这篇文章

Conda或Anaconda

如果你正在使用由CondaAnaconda管理的Python环境,那么你可以像安装其他任何软件包一样,使用 conda工具来安装wxPython。有关有哪些可用版本的详细信息,请查看此处Conda-forge的优秀团队在使 wxPython随新版本保持更新方面做得很好。

在使用通过Conda构建的wxPython时,有一个小细节需要注意:在OSX/macOS系统上,你需要使用pythonw来执行你的wxPython应用程序,而不是通常的python命令。要使用pythonw,你需要从Conda安装python.app软件包。

额外文件

除了在PyPI上可获取的源代码和二进制文件外,每个版本还包含一些额外的文件,这些文件托管在 extras.wxPython.org/wxPython4/e…。在那里你可以找到以下内容:

  • 一个包含wxPython API文档的压缩包,其内容与docs.wxpython.org上的内容相同。你可以使用这份参考文档的副本在本地离线阅读API参考资料。查找名为类似wxPython-docs-VERSION.tar.gz的文件。
  • 一个包含wxPython演示程序示例的压缩包。强烈建议无论是wxPython的新用户还是有经验的用户都下载这个文件。它是一个很棒的学习资源,里面有大量示例,展示了如何使用wxPython库的各种组件。查找名为类似wxPython-demo-VERSION.tar.gz的文件。
  • 包含扩展名为*.pdb文件的压缩文件,这些文件是Visual Studio调试器信息文件。
  • 适用于几种不同类型Linux系统的二进制wheel文件。

前沿版本

如果你是那种敢于冒险的人,并且更倾向于使用绝对最新版本的wxPython,我们为你提供了几种选择。

快照构建版本

每天只要有对wxPython Phoenix主分支的代码提交,buildbot就会尝试进行一次“每日构建”。如果构建成功,那么生成的wheel文件、文档以及源代码归档文件将会被上传到快照文件夹中。虽然从技术层面上讲,这些并不是正式发布的版本,并且可能存在尚未被发现和解决的新 bug,但仍有不少人在他们自己的项目中成功使用了这些版本。

GitHub

wxPython的GitHub项目地址为github.com/wxWidgets/P…。如果你想要对代码进行修改调试(最好是为了提交拉取请求),那么这个选择正是你所需要的。为自己派生并克隆一份该Git仓库的副本,然后就可以在底层开始进行调整修改了。

由于生成的文件并未提交到Git中,你将需要再经过几个步骤来生成和构建代码,但这些步骤都由build.py脚本处理,并且在README文件中对该过程以及所需步骤有一个概述。如果你遇到困难,那么可以在wxPython-dev上询问相关问题。

历史版本

4.0版本之前的wxPython发行版(也称为“经典版” wxPython)仍可在SourceForge上获取。其中包括源代码、文档、演示程序,以及适用于Windows和Mac系统的各种二进制安装程序。