pyinstaller - JavaShuo

简述

pyinstaller 打包的流程：读取编写好的 python 脚本，分析其中调用的模块和库，而后收集这些文件的副本（包括 Python 的解释器）。最后把副本与脚本，可执行文件等放在一个文件夹中，或者可选地封装在一个可执行文件中。html

基本使用方法

安装 pyinstaller

pip install pyinstaller
复制代码

生成 spec 文件

进入主程序目录，输入 pyi-makespec -w main.py 生成 main.spec 文件。python

几个经常使用参数git

参数	说明
-F,-onefile	打包一个单个文件
-D,-onedir	打包多个文件，在 dist 中生成不少依赖文件
-w,-windowed,-noconcole	当程序启动的时候不会打开命令行(只对windows有效)

根据须要编辑 spec 文件

onefile 模式web

# -*- mode: python ; coding: utf-8 -*-

block_cipher = None


a = Analysis(['main.py'],
             pathex=['C:\\Users\\lunckl\\Desktop\\qcm-python'],
             binaries=[('./NovaQCM.exe', '.')],  # non-python modules needed by the scripts
             datas=[('./*.ico', '.'), ('./*.png', '.'), ('./QCM/*.txt', 'QCM')],  # non-binary files included in the app
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher,
             noarchive=False)
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          a.binaries,
          a.zipfiles,
          a.datas,
          [],
          name='qcm',
          debug=False,
          bootloader_ignore_signals=False,
          strip=False,
          upx=True,
          upx_exclude=[],
          runtime_tmpdir=None,
          console=False,
          icon='favicon.ico')

复制代码

onedir 模式shell

# -*- mode: python ; coding: utf-8 -*-

block_cipher = None


a = Analysis(['main.py'],
             pathex=['C:\\Users\\lunckl\\Desktop\\qcm-python'],
             binaries=[('./NovaQCM.exe', '.')],
             datas=[('./*.ico', '.'), ('./*.png', '.'), ('./QCM/*.txt', 'QCM')],
             hiddenimports=[],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher,
             noarchive=False)
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          [],
          exclude_binaries=True,
          name='qcm',
          debug=False,
          bootloader_ignore_signals=False,
          strip=False,
          upx=True,
          console=False,
          icon='favicon.ico')
coll = COLLECT(exe,
               a.binaries,
               a.zipfiles,
               a.datas,
               strip=False,
               upx=True,
               upx_exclude=[],
               name='QCM')

复制代码

执行打包命令

pyinstaller main.spec
复制代码

进行测试

进入生成的 dist 目录，执行 main.exewindows

常见问题

打包多进程、线程

用 pyinstaller 打包好 exe 后，双击运行，会出现无限循环地进入主程序的状况。此时须要在调用多进程的前面加上以下的代码：bash

if __name__ == "__main__":
    multiprocessing.freeze_support()  # 不加这句，打包的程序就进不了下面的子进程了
    p1 = multiprocessing.Process(target=callback, target=(, ))
    p1.start()
复制代码

由于开启子进程是不支持打包 exe 文件的，因此会不停向操做系统申请建立子进程，而 multiprocessing.freeze_support() 做用就是支持打包到 windows 的 exe 文件。
多进程的程序运行后，若是直接关闭控制台窗口，那么整个程序都会退出，若是是进入任务管理，单独结束控制窗口的进程，若是子进程不是守护进程，那么子进程仍是会继续运行。
若是是多线程，则没有这个问题，能够直接打包。

pyinstaller 打包一个 exe 并加入内置图片

编辑生成的 main.spec 文件，修改 datas 列表，添加数据的格式为：datas = [('source_path1', 'exe_dir1'), ('source_path2', 'exe_dir2')]，可使用通配符markdown

source_path: 资源文件
exe_dir: 把资源文件放在 exe 程序中的文件夹。能够直接使用 . 表示把资源文件放在 exe 程序的顶级文件夹中。

最后须要在源代码的资源路径引用中进行以下修改：多线程

import os
import sys

def resource_path(relative_path):
    """Get absolute path to resource works for dev and for PyInstaller"""
    if getattr(sys, 'frozen', False):
        base_path = sys._MEIPASS
    else:
        base_path = os.getcwd()
    return os.path.join(base_path, relative_path)

pic_path = resource_path('pic.png')
复制代码

pyinstaller 会将文件夹的路径信息存储在 sys.MEIPASS 中，当使用的是单文件打包的方式，sys.MEIPASS 的值就是程序运行时建立 _MEIxxxxxx临时目录的绝对路径。路径通常在 C:\Users\user\AppData\Local\Temp\_MEIxxxxxapp

修改好 .spec 文件和源代码后，从新打包便可，pyinstaller main.spec

对于以 dir 方式进行打包，则只须要修改 .spec 文件，添加资源文件便可。

调用外部程序使用无命令行窗口模式会出现程序报错

问题出在 subprocess 上面，简单来讲，打包关闭了命令行窗口，stdin, stdout 无处安放，参考如下代码修改便可。

def run_stuff(command_line):
    output_filename = 'somefile.txt'
    output_file = open(output_filename, "w")

    if gui_mode:
        result = subprocess.call(command_line, shell=True, stdout=outputFile, stderr=subprocess.STDOUT)
    else:
        proc = subprocess.Popen(command_line, shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, stdin=subprocess.PIPE)
        proc.stdin.close()
        proc.wait()
        result = proc.returncode
        output_file.write(proc.stdout.read())
复制代码

参考

PyInstaller打包详解 pyinstaller 打包成 exe 遇到的一些坑 Python subprocess.call() fails PyInstaller Manual