使用PyInstaller轻松分发Python应用程序!

你是否嫉妒Go开发人员构建了一个可执行文件并轻松地将其交付给用户?如果你的用户可以在不安装任何东西的情况下运行你的应用程序，那不是很棒吗?这是一个梦想，而PyInstaller是在Python生态系统中实现这个梦想的一种方法。

Python资源共享群：626017123

有无数关于如何设置虚拟环境、管理依赖项和发布到PyPI的教程，这在创建Python库时非常有用。针对开发人员构建Python应用程序的信息要少得多。本教程适用于希望将应用程序分发给用户的开发人员，用户可能是Python开发人员也可能不是。

 

在本教程中，你将学习以下内容:

 

• PyInstaller如何简化 应用 程序分发

• 如何在你自己的项目中使用 PyInstaller

• 如何调试PyInstaller错误

• PyInstaller不能做什么事情

 

PyInstaller使你能够创建一个文件夹或可执行文件，用户无需任何额外安装就可以立即运行该文件夹或可执行文件。为了充分了解PyInstaller的强大功能，有必要回顾一下PyInstaller帮助你避免的一些分发问题。

 

 

分发问题

 

设置Python项目可能会令人沮丧，尤其是对非开发人员来说。通常，设置从打开一个终端开始，这对于大量的潜在用户来说是不可能的。在安装指南并深入研究虚拟环境、Python版本和大量潜在依赖关系的复杂细节之前，这个障碍就已经阻止了用户。

 

在为Python开发设置一个新机器时，请考虑一下你通常要经历的事情。大概是这样的:

 

• 下载并安装 一 个 特定的Python版本

• 设置pip

• 设置虚拟环境

• 得到代码的副本

• 安装依赖项

 

如果你不是开发人员，请停下来考虑一下上面的步骤是否有意义，Python开发人员就更不用说了。可能不会停下来考虑。

 

如果你的用户足够幸运地到达了安装的依赖项部分，这些问题就会爆发。在过去的几年里，随着wheel的流行，这一点已经变得更好了，但是一些依赖项仍然需要C/C++，甚至是FORTRAN编译器!

 

如果你的目标是让尽可能多的用户可以使用应用程序，那么这个要求就太高了。正如Raymond Hettinger在他精彩的演讲中经常说的：“一定有一个更好的方法。”

 

 

PyInstaller

 

PyInstaller通过查找所有这些依赖项并将它们绑定在一起，从用户那里抽象出这些细节。你的用户甚至不知道他们正在运行一个Python项目，因为Python解释器本身被绑定到你的应用程序中。再见了，复杂的安装说明!

 

PyInstaller通过自省你的Python代码,检测依赖项，然后根据你的操作系统将它们打包成一个合适的格式，从而实现这一惊人的功能。

 

PyInstaller有很多有趣的细节，但现在你将了解它的基本工作原理以及如何使用它。如果你想了解更多细节，你可以参考优秀的PyInstaller文档。

 

此外，PyInstaller还可以为Windows、Linux或macOS创建可执行程序。这意味着Windows用户将获得一个.exe，Linux用户将得到一个常规的可执行文件，macOS用户将得到一个.app包。这一功能还是有一定的限制。了解更多信息，请参见限制部分。

 

 

准备你的项目

 

PyInstaller要求你的应用程序要遵循一些最小的结构，即有一个CLI脚本来启动你的应用程序。通常，这意味着在Python包之外创建一个小脚本，该脚本只导入你的包并运行main()。

 

入口点脚本是一个Python脚本。从技术上来说，你可以在入口点脚本中做任何你想做的事情，但是你应该避免使用显式的相对导入。如果你的首选样式是相对导入，那么你仍然可以在应用程序的其余部分中使用相对导入。

 

注意: 入口点是启动项目或应用程序的代码。

 

你可以在自己的项目中进行尝试，或者跟随真正的Python阅读器项目。有关阅读器项目的更详细信息，请参阅《关于在PyPI上发布包的教程》。

 

构建此项目的可执行版本的第一步是添加入口点脚本。幸运的是，阅读器项目结构良好，所以你只需要在包外编写一个简短的脚本来运行它。例如，你可以在reader包旁边创建一个名为cli.py的文件,并添加以下代码:

 

 

 

 

 

这个cli.py脚本会调用main()来启动阅读器。