快速入门
安装
通过 PyPI 安装
pip3 install pyinstaller
打包
简单来说,打包分为两个步骤:
- 进入你的
程序目录
- 针对你的
Python程序脚本
执行如下命令:
这将会在pyinstaller yourprogram.py
dist子目录
中生成打好的包
。
使用
命令行语法
pyinstaller 命令
的语法是:
pyinstaller [options] script [script …] | specfile
打包
在大多数的简单情况下,将当前目录
设置为你myscript.py 程序
的位置,并执行:
pyinstaller myscript.py
打包过程
PyInstaller
会分析myscript.py
并:
- 将
myscript.spec
写入到与myscript.py
相同的目录中 - 在与
myscript.py
所在的相同目录中创建一个build 目录
(如果不存在的话) - 向
build 目录
中写入一些日志文件(log files)
和工作文件(working files)
- 在与
myscript.py
所在的相同目录中创建一个dist 目录
(如果不存在的话) - 向
dist 目录
中写入myscript 可执行目录
- 在
dist 目录
中,你可以找到你打算分发给用户的已打包好的应用程序(bundled app)
。
打包多个程序脚本文件
通常情况下,在命令行
你只会上声明一个脚本文件
,如果你声明了多个,那么所有的脚本文件
都会被分析,并包含到输出
中。 但是,第一个声明的脚本
提供了spec文件
的名称与可执行目录或文件
的名称。并且,它的代码也是在运行期间(run-time)
第一个被执行的。
关于Spec文件的说明
针对某些特定的用途,你可以通过编辑myscript.spec
的内容来定制。在完成编辑后,你需要向pyinstaller 命令
提供这个spec文件
,而不再是那个脚本
:
pyinstaller myscript.spec
myscript.spec 文件
包含了由pyinstaller
(或pyi-makespec
)以脚本文件
作为参数
运行时所指定的选项
所提供的大部分信息。 在使用spec文件
运行pyinstaller
时,通常不需要指定任何选项
。因为,通过spec文件
构建时,只有少数命令行选项
会起作用。
通过路径指定
你甚至可以通过指定脚本文件路径
或spec文件路径
来运行pyinstaller
,例如:
- 在
Linux/Mac
上:pyinstaller options… ~/myproject/source/myscript.py
- 在
Windows
上:pyinstaller "C:\Documents and Settings\project\myscript.spec"