Python pyinstaller类库使用学习总结
实践环境python3 .9.13
pyinstaller-6.10.0-py3-none-manylinux2014_x86_64.whl
CentOS 7.9
win11
实践操作
生成Linux版可执行文件
安装Python
# yum install -y gcc zlib* openssl-devel libffi-devel
# wget https://www.python.org/ftp/python/3.6.13/Python-3.6.13.tgz
# mkdir -p /usr/local/python
# mv Python-3.9.13.tgz /usr/local/python
# tar -xvzf Python-3.9.13.tgz
# cd python-3.9.13
# ./configure --prefix=/usr/local/python/python3.9.13 --enable-shared
# make && make install说明：
1、如果不安装libffi-devel，运行pyinstaller时会报错：ModuleNotFoundError: No module named '_ctypes'，以下
# pyinstaller simulator.py
Traceback (most recent call last):
File "/usr/bin/pyinstaller", line 8, in <module>
sys.exit(_console_script_run())
File "/usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/__main__.py", line 231, in _console_script_run
run()
File "/usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/__main__.py", line 172, in run
parser = generate_parser()
File "/usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/__main__.py", line 137, in generate_parser
import PyInstaller.building.build_main
File "/usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/building/build_main.py", line 28, in <module>
from PyInstaller.building.api import COLLECT, EXE, MERGE, PYZ
File "/usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/building/api.py", line 33, in <module>
from PyInstaller.building.splash import Splash# argument type validation in EXE
File "/usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/building/splash.py", line 23, in <module>
from PyInstaller.depend import bindepend
File "/usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/depend/bindepend.py", line 15, in <module>
import ctypes.util
File "/usr/local/python/python3.9.13/lib/python3.9/ctypes/__init__.py", line 8, in <module>
from _ctypes import Union, Structure, Array
ModuleNotFoundError: No module named '_ctypes'2、如果编译Python时不携带--enable-shared选项，运行pyinstaller时会报类似如下错误：
File "/usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/building/build_main.py", line 671, in assemble
raise PythonLibraryNotFoundError()
PyInstaller.exceptions.PythonLibraryNotFoundError: Python library not found: libpython3.9.so.1.0, libpython3.9.so
This means your Python installation does not come with proper shared library files.
This usually happens due to missing development package, or unsuitable build parameters of the Python installation.
* On Debian/Ubuntu, you need to install Python development packages:
* apt-get install python3-dev
* apt-get install python-dev
* If you are building Python by yourself, rebuild with `--enable-shared` (or, `--enable-framework` on macOS).添加/usr/lib64/libpython3.9.so.1.0文件
# find / -name libpython3.9.so.1.0
/root/Python-3.9.13/libpython3.9.so.1.0
/usr/local/python/python3.9.13/lib/libpython3.9.so.1.0
# cp /usr/local/python/python3.9.13/lib/libpython3.9.so.1.0 /usr/lib64/libpython3.9.so.1.0说明：如果不执行该操作，运行pyinstaller时生成可执行文件时可能报类似如下错误：
# pyinstaller simulator.py
/usr/local/python/python3.9.13/bin/python3.9: error while loading shared libraries: libpython3.9.so.1.0: cannot open shared object file: No such file or directory安装 pyinstaller
# pip3 install pyinstaller -i http://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com创建软连接，避免直接执行 pyinstaller 命令时，提示 pyinstaller: command not found
# find / -name pyinstaller
/usr/local/python/python3.9.13/bin/pyinstaller
#
# ln -fs /usr/local/python/python3.9.13/bin/pyinstaller /usr/binpyinstaller
# pyinstaller -v
6.10.0生成可执行文件
# pwd
/root/au02Simulator
# pyinstaller -ysimulator.py
87 INFO: PyInstaller: 6.10.0, contrib hooks: 2024.8
87 INFO: Python: 3.9.13
89 INFO: Platform: Linux-3.10.0-1160.el7.x86_64-x86_64-with-glibc2.17
89 INFO: Python environment: /usr/local/python/python3.9.13
90 INFO: wrote /root/au02Simulator/simulator.spec
93 INFO: Module search paths (PYTHONPATH):
['/usr/local/python/python3.9.13/lib/python39.zip',
'/usr/local/python/python3.9.13/lib/python3.9',
'/usr/local/python/python3.9.13/lib/python3.9/lib-dynload',
'/usr/local/python/python3.9.13/lib/python3.9/site-packages',
'/root/au02Simulator']
166 INFO: checking Analysis
172 INFO: checking PYZ
181 INFO: checking PKG
181 INFO: Bootloader /usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/bootloader/Linux-64bit-intel/run
181 INFO: checking EXE
182 INFO: checking COLLECT
182 INFO: Building COLLECT COLLECT-00.toc
210 INFO: Building COLLECT COLLECT-00.toc completed successfully.
# cd dist/
# ll
total 0
drwxr-xr-x. 3 root root 40 Oct 24 12:46 simulator
# cd simulator/
# ll
total 1204
drwxr-xr-x. 4 root root 4096 Oct 24 12:46 _internal
-rwxr-xr-x. 1 root root 1227016 Oct 24 12:46 simulator说明：这里的simulator.py为程序入口文件，即用python运行本程序时，位于其后的.py文件
只生成一个文件
# pyinstaller -y --onefile simulator.py
74 INFO: PyInstaller: 6.10.0, contrib hooks: 2024.8
75 INFO: Python: 3.9.13
76 INFO: Platform: Linux-3.10.0-1160.el7.x86_64-x86_64-with-glibc2.17
76 INFO: Python environment: /usr/local/python/python3.9.13
77 INFO: wrote /root/au02Simulator/simulator.spec
79 INFO: Module search paths (PYTHONPATH):
['/usr/local/python/python3.9.13/lib/python39.zip',
'/usr/local/python/python3.9.13/lib/python3.9',
'/usr/local/python/python3.9.13/lib/python3.9/lib-dynload',
'/usr/local/python/python3.9.13/lib/python3.9/site-packages',
'/root/au02Simulator']
146 INFO: checking Analysis
149 INFO: checking PYZ
157 INFO: checking PKG
158 INFO: Building because toc changed
158 INFO: Building PKG (CArchive) simulator.pkg
7881 INFO: Building PKG (CArchive) simulator.pkg completed successfully.
7882 INFO: Bootloader /usr/local/python/python3.9.13/lib/python3.9/site-packages/PyInstaller/bootloader/Linux-64bit-intel/run
7882 INFO: checking EXE
7883 INFO: Rebuilding EXE-00.toc because simulator missing
7883 INFO: Building EXE from EXE-00.toc
7883 INFO: Copying bootloader EXE to /root/au02Simulator/dist/simulator
7883 INFO: Appending PKG archive to custom ELF section in EXE
7900 INFO: Building EXE from EXE-00.toc completed successfully.
# cd dist/
# ll
total 12444
-rwxr-xr-x. 1 root root 12741136 Oct 24 12:50 simulator注意，生成的文件是不带配置的，程序所需配置需要自己添加
生成Windows版可执行文件
安装 pyinstaller
同Linux，安装完成后，会在${PYTHON_HOME}\Scripts目录下生成pyinstaller.exe，为方便执行，将其所在路径添加到环境变量
生成可执行文件
同Linux
pyinstaller [选项] program_entry_file.pypyinstaller常用选项
[*]-y 档输出目录下的存在旧生成文件时，不提示删除确认提示，直接删除
[*]-F,--onefile打包为一个独立文件
[*]--add-data ; (适用Win) 、--add-data : (适用Linux)用于将非python文件如配置，打包进程序。
[*]是资源文件的路径，可以是相对路径或绝对路径，建议使用绝对路径。
[*]是资源文件在打包后在可执行文件中的目标目录路径。是相对于应用程序顶层目录的目标目录，如果要将文件放入应用程序顶层目录，则使用 . 作为 。注意：如果该目录路径不存在，则会自动创建
--add-data 可重复使用，以支持单次添加多个文件的需求
例子：
假设我们有一个Python项目，其中包含一个名为config.ini的配置文件。希望在使用PyInstaller打包项目时，将这个配置文件也一起打包进去。
cd /d D:\PyProjects\ZenTaoTestcaseHelper
pyinstaller --add-data "D:\PyProjects\ZenTaoTestcaseHelper\config.json;." testcase_helper.py生成目标结果文件路径如下：
D:\PyProjects\ZenTaoTestcaseHelper\dist\testcase_helper\testcase_helper.exe
D:\PyProjects\ZenTaoTestcaseHelper\dist\testcase_helper\config.json运行可执行文件无法正确读取配置文件解决方案
实践时遇到过这样的情况：
直接使用python program_entry_file.py的方式运行程序时，可正确执行不报错，直接运行打包生成的可执行文件时，出现报错，提示相关配置文件不存在。
经过分析发现，直接运行可执行文件时，读取配置文件的路径不对，为了避免这种情况，可在代码中添加判断，设置采用可执行文件的方式运行时的配置文件读取路径:
program_entry_file.py(程序入口文件)中判断是否是运行打包生成的可执行文件，如果是，则设置环境变量，获取可执行文件所在目录
sys_executable = sys.executable
if not sys_executable.endswith('python.exe') and not re.findall('python\d*$', sys_executable):
os.environ['EXECUTABLE_DIR'] = os.path.dirname(sys.executable)其它需要读取配置文件的py文件中添加判断
假设我们期望可执行文件从位于同级目录的conf目录下的program.conf文件中读取配置
config_file_path = 'conf/program.conf'
if os.getenv('EXECUTABLE_DIR'):
config_file_path = os.path.join(os.environ['EXECUTABLE_DIR'], config_file_path)参考链接
https://pyinstaller.org/en/v6.2.0/usage.html
来源:https://www.cnblogs.com/shouke/p/18509425
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！
页:
[1]