pyinstaller 打包成 exe

通用参数

参数名	描述	说明
-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

指定打包哪些资源、代码

参数名	描述	说明

–add-data

打包额外资源

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

–add-binary

打包额外的代码

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

–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位的字符串

生成参数

参数名	描述	说明
-d	执行生成的main.exe时，会输出pyi的一些log，有助于查错	默认：不输出pyi的log
-s	优化符号表	原文明确表示不建议在windows上使用
–noupx	强制不使用upx	默认：尽可能使用

Windows和Mac特有的参数

参数名	描述	说明
–runtime-tmpdir	指定运行时的临时目录	默认：使用系统临时目录

其他

参数名	描述	说明
-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	请参考原文

遇到的错误：　　

ImportError: OpenCV loader: missing configuration file: [‘config.py‘]

--paths="D:\ProgramData\Anaconda3\lib\site-packages\cv2"

pathex=['C:\\Users\\Administrator\\AppData\\Local\\Programs\\Python\\Python37\\Lib\\site-packages\\cv2']

时间问题

# 手动导入 cftime 包

hiddenimports=['cftime'],

添加依赖包

from PyInstaller.utils.hooks import collect_all
datas, binaries, hiddenimports = collect_all("pyproj")

a = Analysis(
    ['radar_draw.py'],
    pathex=[],
    binaries=binaries,
    datas=datas,
    hiddenimports=hiddenimports,
    .
    .
    .

打包流程：

执行打包命令，-F 指定打包生成结果是一个exe文件，所有的第三方依赖、资源和代码均被打包进该exe内
```
pyinstaller -F xxx.py
```

修改生成的 xxx.spec 文件，手动添加静态文件，依赖文件，就是把该项目目录下所有需要的文件，都一一列到这里

datas=[('./cache_file/*', './cache_file'),('./config_file/*', './config_file'),
    ('./dispost/*', './dispost'),('./dispost/cma/__init__.py', './dispost/cma'),
    ('./dispost/cma/music/*', './dispost/cma/music'),
    ('./dispost/map/MicrosoftYaheiBold.ttf', './dispost/map'),
    ('./dispost/map/000/*', './dispost/map/000'),
    ('./dispost/map/111/*', './dispost/map/111'),
    ('./dispost/map/222/*', './dispost/map/222'),
    ('./dispost/map/333/*', './dispost/map/333'),
    ('./logger/*', './logger'),
    ('./pic_out/__init__.py', './pic_out'),
    ('./deleting_cached_files.py', './'),
    ('./plot_contourf.py', './'),
    ('./plot_line.py', './')],