Pyinstaller打包用spec添加资源文件,亲测可用

2024-04-01 05:58

本文主要是介绍Pyinstaller打包用spec添加资源文件,亲测可用,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

最近写的翻译软件——transdocx,就是给普通用户而非Python程序员用的,所以它必须是一个开箱即用的软件,普通用户下载下来就能双击运行。

Pyinstaller打包用spec添加资源文件

而Python作为一个脚本语言,要运行是必须有解释器的,它不能像C/C++那样编译成二进制。同样,也不能要求普通用户首先安装Python解释器、再安装依赖的包、最后运行transdocx。所以,需要把Python写好的软件打包成一个exe程序,让用户双击既可以使用。打包Python程序的最好的工具可能就是pyinstaller了。

下面我就结合transdocx打包的过程来讲讲pyinstaller的使用,平台是Windows,Linux和macOS类似。

一、用pyinstaller给纯Python代码打包

如果你的软件中只有.py文件,即Python代码文件,不包括图标、图片等资源文件,那么使用pyinstaller打包是非常简单的,往往只需要下面一行命令即可:

pyinstaller -F -w -i icon.ico transdocx.py

第一版本的transdocx就是这样完成的。其中的几个选项:
-F 把整个软件(包括依赖的各种库文件)打包成单一文件;
-w 禁止Windows的命令行窗口。不然双击exe时会打开一个黑乎乎的dos窗口;
-i 生成的exe文件会带有这个图标,有识别度也更好看;
最后的transdocx.py就是翻译软件的入口程序。

运行完上面的命令,会在当前目录下生成一个transdocx.spec文件和两个文件夹build和dist,其中dist里面就是最终生成的exe文件,把这个文件发给普通用户就可以了。当然,你要先自己测试没有问题。

transdocx.spec 是于pyinstaller生成的配置文件,下次打包时,可以不运行上面带参数的命令,而直接运行:

pyinstaller transdocx.spec

二、用pyinstaller给带有资源文件的代码打包

第二版为了支持PDF,添加了目录bin/下面的相关资源文件,主要是:
pdftotext.exe : Windows下面的提取PDF文本内容的命令行工具;
pdftotext : Linux下面提取PDF文本内容的命令行工具;
default.docx : 生成docx的默认模板文件。

提取PDF内容是通过Python的subprocess模块调用命令行工具pdftotext.exe 实现的。如果按照上面比较简单的打包方式,就会报错:找不到这个命令行工具。因为这些资源文件没有被打包到最终的exe文件。

要把这些资源文件包含进去,可以给pyinstaller添加选项,也可以修改spec文件。我通过修改transdocx.spec来实现:

给spec添加资源文件路径

(关于spec的说明可以查看pyinstaller的官方文档)
添加过程还是很简单的,看图中红框部分就是。
前面pyinstaller 自动生成的spec文件中,binaries原本是空的:

binaries=[]

就是一个空的list,把要添加的资源文件以tuple的形式传入,tuple的第一个元素是资源文件的路径,第二个元素是打包后存放资源的文件夹。比如:

(‘./bin/pdftotext.exe’, ‘bin’)

就是把 ‘./bin/pdftotext.exe’ 打包后放到bin目录下面。打包后的目录跟Python代码的目录结构一直即可,pdftotext.exe原先放在bin下面可以让程序运行,那么打包后也放在bin下面即可。

在spec文件中添加好要包含的资源文件再次打包就可以把资源文件打包到最终的exe文件了。然而,这时得到的最终exe还是不能运行! 报的错误还是找不到相关文件。

三、修改资源文件路径以保证打包结果能执行

为什么还不能运行?这样从pyinstaller打包后的exe的运行机制讲起。打包得到的exe文件是一个可自解压的程序,它会把这个exe文件中包含的文件打包到一个名为 _MEIxxxxxx 的临时目录下面,这个目录在系统的临时文件夹下面(Linux下是 /tmp),当程序退出时,会自动清空删除这个临时目录 _MEIxxxxxx。

我们先来看看这个临时目录 _MEIxxxx 里面都是些什么,下面截图是Linux下面的,Windows类似,只不过路径不一样,Windows下是.dll等。

spec mei临时目录

其中的bin目录下就是我添加的资源文件。

最终的exe文件有可能放在任何目录执行,其当前目录下不会有bin目录下面的资源文件,而是被解压到了临时目录下面,所以程序报错找不到相关文件。

因此,我们要在程序中指定资源文件的路径,使得它在非打包模式和打包模式下运行时都能找到相关资源文件。这需要添加一个路径解析函数:

给spec添加一个路径解析函数

这个函数很简单,把资源的相对路径转换为绝对路径。如果找到 _MEIPASS 路径就以此为资源的基准路径,否则以当前路径为基准路径。

代码中任何使用资源文件的相对路径都用该函数转换一下即可保证资源文件可以被找到。比如代码中:

转换spec资源文件路径

可以从transdocx的源码中查找更多resource_path的示例。

至此,打包的问题完美解决了。再次使用spec打包一下,看看exe应该可以正常运行了。

双击exe运行正常,选取一个PDF文件,点击“翻译”。纳尼?!又报错!!

双击pyinstaller打包后的程序出错

一番搜索后,stackoverflow上找到了原因:
https://stackoverflow.com/questions/337870/

问题出在subprocess上面:

要使用subprocess pipe来打包

简单来说就是,打包是关闭了命令行窗口,stdin, stdout 无处安放。
所以,把它们用subprocess.PIPE 管道代替即可。
shell=True 可以防止执行subprocess.Popen()时闪现一个黑糊糊的dos窗口。

这时候,才算完美解决了pyinstaller打包的问题。总结一下pyinstaller打包的过程:
(1)pyinstaller -F -w xxx.py;
(2)修改上一把生成的xxx.spec文件,添加资源文件;
(3)pyinstaller xxx.spec 打包为exe文件。

这篇关于Pyinstaller打包用spec添加资源文件,亲测可用的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/866373

相关文章

nginx部署https网站的实现步骤(亲测)

《nginx部署https网站的实现步骤(亲测)》本文详细介绍了使用Nginx在保持与http服务兼容的情况下部署HTTPS,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值... 目录步骤 1:安装 Nginx步骤 2:获取 SSL 证书步骤 3:手动配置 Nginx步骤 4:测

配置springboot项目动静分离打包分离lib方式

《配置springboot项目动静分离打包分离lib方式》本文介绍了如何将SpringBoot工程中的静态资源和配置文件分离出来,以减少jar包大小,方便修改配置文件,通过在jar包同级目录创建co... 目录前言1、分离配置文件原理2、pom文件配置3、使用package命令打包4、总结前言默认情况下,

解读静态资源访问static-locations和static-path-pattern

《解读静态资源访问static-locations和static-path-pattern》本文主要介绍了SpringBoot中静态资源的配置和访问方式,包括静态资源的默认前缀、默认地址、目录结构、访... 目录静态资源访问static-locations和static-path-pattern静态资源配置

Python项目打包部署到服务器的实现

《Python项目打包部署到服务器的实现》本文主要介绍了PyCharm和Ubuntu服务器部署Python项目,包括打包、上传、安装和设置自启动服务的步骤,具有一定的参考价值,感兴趣的可以了解一下... 目录一、准备工作二、项目打包三、部署到服务器四、设置服务自启动一、准备工作开发环境:本文以PyChar

centos7基于keepalived+nginx部署k8s1.26.0高可用集群

《centos7基于keepalived+nginx部署k8s1.26.0高可用集群》Kubernetes是一个开源的容器编排平台,用于自动化地部署、扩展和管理容器化应用程序,在生产环境中,为了确保集... 目录一、初始化(所有节点都执行)二、安装containerd(所有节点都执行)三、安装docker-

python使用watchdog实现文件资源监控

《python使用watchdog实现文件资源监控》watchdog支持跨平台文件资源监控,可以检测指定文件夹下文件及文件夹变动,下面我们来看看Python如何使用watchdog实现文件资源监控吧... python文件监控库watchdogs简介随着Python在各种应用领域中的广泛使用,其生态环境也

Python pyinstaller实现图形化打包工具

《Pythonpyinstaller实现图形化打包工具》:本文主要介绍一个使用PythonPYQT5制作的关于pyinstaller打包工具,代替传统的cmd黑窗口模式打包页面,实现更快捷方便的... 目录1.简介2.运行效果3.相关源码1.简介一个使用python PYQT5制作的关于pyinstall

javafx 如何将项目打包为 Windows 的可执行文件exe

《javafx如何将项目打包为Windows的可执行文件exe》文章介绍了三种将JavaFX项目打包为.exe文件的方法:方法1使用jpackage(适用于JDK14及以上版本),方法2使用La... 目录方法 1:使用 jpackage(适用于 JDK 14 及更高版本)方法 2:使用 Launch4j(

springboot3打包成war包,用tomcat8启动

1、在pom中,将打包类型改为war <packaging>war</packaging> 2、pom中排除SpringBoot内置的Tomcat容器并添加Tomcat依赖,用于编译和测试,         *依赖时一定设置 scope 为 provided (相当于 tomcat 依赖只在本地运行和测试的时候有效,         打包的时候会排除这个依赖)<scope>provided

Sentinel 高可用流量管理框架

Sentinel 是面向分布式服务架构的高可用流量防护组件,主要以流量为切入点,从限流、流量整形、熔断降级、系统负载保护、热点防护等多个维度来帮助开发者保障微服务的稳定性。 Sentinel 具有以下特性: 丰富的应用场景:Sentinel 承接了阿里巴巴近 10 年的双十一大促流量的核心场景,例如秒杀(即突发流量控制在系统容量可以承受的范围)、消息削峰填谷、集群流量控制、实时熔断下游不可用应