pip install pyinstaller
#系统的python打包
pyinstaller -F ./autocheckin.py -p ~/.local/lib/python3.8/site-packages/
#pyenv的虚拟环境打包（注意替换里面的`虚拟环境名称`,是否需要指定多个路径取决于实际情况）
pyinstaller -F ./autocheckin.py \
-p '~/.pyenv/versions/虚拟环境名称/lib/python3.8/site-packages/,\
/usr/local/lib/python3.8/dist-packages,\
/usr/lib/python3/dist-packages,\
/usr/lib/python3.8/dist-packages'
#添加其他资源（Linux）data或者binary文件路径之前使用冒号。
pyinstaller --noconfirm --log-level=WARN \
    --onefile --nowindow \
    --add-data="README:." \
    --add-data="image1.png:img" \
    --add-binary="libfoo.so:lib" \
    --hidden-import=secret1 \
    --hidden-import=secret2 \
    --upx-dir=/usr/local/share/ \
    myscript.spec
#windows需要不一样的换行符,data或者binary文件路径之前使用分号。
pyinstaller --noconfirm --log-level=WARN ^
    --onefile --nowindow ^
    --add-data="README;." ^
    --add-data="image1.png;img" ^
    --add-binary="libfoo.so;lib" ^
    --hidden-import=secret1 ^
    --hidden-import=secret2 ^
    --icon=..\MLNMFLCN.ICO ^
    myscript.spec
pyinstaller通用参数

参数名

描述

说明

-h

显示帮助

无

-v

显示版本号

无

–distpath

生成文件放在哪里

默认：当前目录的dist文件夹内

–workpath

生成过程中的中间文件放在哪里

默认：当前目录的build文件夹内

-y

如果dist文件夹内已经存在生成文件，则不询问用户，直接覆盖

默认：询问是否覆盖

–upx-dir

UPX_DIR 指定upx工具的目录

默认：execution path

-a

不包含unicode支持

默认：尽可能支持unicode

–clean

在本次编译开始时，清空上一次编译生成的各种文件

默认：不清除

–log-level

LEVEL 控制编译时pyi打印的信息 一共有6个等级，由低到高分别为TRACE DEBUG INFO(默认) WARN ERROR CRITICAL。

默认:清空下，不打印TRACE和DEBUG信息

与生成结果有关的参数

参数名

描述

说明

-D

生成one-folder的程序

（默认） 生成结果是一个目录，各种第三方依赖、资源和exe同时存储在该目录

-F

生成one-file的程序

生成结果是一个exe文件，所有的第三方依赖、资源和代码均被打包进该exe内

–specpath

指定.spec文件的存储路径

默认：当前目录

-n

生成的.exe文件和.spec的文件名

默认：用户脚本的名称，即main.py和main.spec

-d

执行生成的main.exe

会输出pyi的一些log，有助于查错 默认：不输出pyi的log

-s

优化符号表

原文明确表示不建议在windows上使用

–noupx

强制不使用upx

默认：尽可能使用。

–runtime-tmpdir

指定运行时的临时目录

默认：使用系统临时目录

指定打包哪些资源、代码

参数名

描述

说明

–add-data

打包额外资源

用法：pyinstaller main.py --add-data=src;dest。windows以;分割，linux以:分割

–add-binary

打包额外的代码

用法：同–add-data。与–add-data不同的是，用binary添加的文件，pyi会分析它引用的文件并把它们一同添加进来

-p

指定额外的import路径

类似于使用PYTHONPATH 参见PYTHONPATH

–hidden-import

打包额外py库 pyi在分析过程中

有些import没有正确分析出来，运行时会报import error，这时可以使用该参数

–additional-hooks-dir

指定用户的hook目录

hook用法参见其他，系统hook在PyInstaller\hooks目录下

–runtime-hook

指定用户runtime-hook

如果设置了此参数，则runtime-hook会在运行main.py之前被运行

–exclude-module

需要排除的module

pyi会分析出很多相互关联的库，但是某些库对用户来说是没用的，可以用这个参数排除这些库，有助于减少生成文件的大小

–key

pyi会存储字节码

指定加密字节码的key 16位的字符串

Windows和Mac特有的参数

参数名

描述

说明

-c

显示命令行窗口 与-w相反，

默认含有此参数

-w

不显示命令行窗口

编写GUI程序时使用此参数有用。

-i

为main.exe

指定图标 pyinstaller -i beauty.ico main.py

Windows特有的参数

参数名

描述

说明

–version-file

添加版本信息文件

pyinstaller --version-file ver.txt

-m, --manifest

添加manifest文件

pyinstaller -m main.manifest

-r RESOURCE

请参考原文

–uac-admin

请参考原文

–uac-uiaccess

请参考原文

例子

如下脚本将autocheckin.py打包为一个文件（参数-F），并且指定包含一个库文件libtdjson.so（文件路径用文件名冒号之后的符号指定，本例中是当前目录.），还要包含pyenv中名为tele的虚拟环境以及系统 内置python3.8中的各种模块相关文件（注意替换里面的虚拟环境名称,是否需要指定多个路径取决于实际情况）

pyinstaller -F ./autocheckin.py --add-binary="libtdjson.so:."\
-p '~/.pyenv/versions/虚拟环境名称/lib/python3.8/site-packages/,\
/usr/local/lib/python3.8/dist-packages,\
/usr/lib/python3/dist-packages,\
/usr/lib/python3.8/dist-packages'

#或者
pyinstaller -F ./autocheckin.py 
-p ~/.pyenv/versions/虚拟环境名称/lib/python3.8/site-packages/