首页 > Python资料 博客日记
Python pyinstaller类库使用学习总结
2024-10-28 00:30:02Python资料围观11次
实践环境
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 -y simulator.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.py
pyinstaller常用选项
-
-y
档输出目录下的存在旧生成文件时,不提示删除确认提示,直接删除 -
-F,--onefile
打包为一个独立文件 -
--add-data <source>;<dest_dir> (适用Win)
、--add-data <source>:<dest_dir> (适用Linux)
用于将非python文件如配置,打包进程序。<source>
是资源文件的路径,可以是相对路径或绝对路径,建议使用绝对路径。<dest_dir>
是资源文件在打包后在可执行文件中的目标目录路径。是相对于应用程序顶层目录的目标目录,如果要将文件放入应用程序顶层目录,则使用.
作为<dest_dir>
。注意:如果该目录路径不存在,则会自动创建
--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)
参考链接
标签:
相关文章
最新发布
- python的csv库常用操作
- 全网最详细Gradio教程系列5——Gradio Client: python
- 【AI 大模型】OpenAI 接口调用 ② ( MacOS 中进行 OpenAI 开发 | 安装 openai 软件包 | PyCharm 中开发 Python 程序调用 OpenAI 接口 )
- 笔试真题——机器人拧魔方模拟
- 大学生玩转小袁口算:Python 抓包破解代码
- **LLAMA-CPP-PYTHON 安装与配置完全指南**
- Python毕业设计选题:基于Python的个性化旅游路线推荐系统-flask+vue
- 【完整版解决方案】sklearn加州房价数据集出错 housing = fetch_california_housing() HTTPError: HTTP Error 403: Forbidden
- python-爬虫实例(1):获取京东商品评论
- hyper-v虚拟机使用教程
点击排行
- 版本匹配指南:Numpy版本和Python版本的对应关系
- 版本匹配指南:PyTorch版本、torchvision 版本和Python版本的对应关系
- Python 可视化 web 神器:streamlit、Gradio、dash、nicegui;低代码 Python Web 框架:PyWebIO
- 相关性分析——Pearson相关系数+热力图(附data和Python完整代码)
- Python与PyTorch的版本对应
- Anaconda版本和Python版本对应关系(持续更新...)
- Python pyinstaller打包exe最完整教程
- Could not build wheels for llama-cpp-python, which is required to install pyproject.toml-based proj