usage: pyinstaller [-h] [-v] [-D] [-F] [--specpath DIR] [-n NAME]
[--add-data <SRC;DEST or SRC:DEST>]
[--add-binary <SRC;DEST or SRC:DEST>] [-p DIR]
[--hidden-import MODULENAME]
[--additional-hooks-dir HOOKSPATH]
[--runtime-hook RUNTIME_HOOKS] [--exclude-module EXCLUDES]
[--key KEY] [-d [{all,imports,bootloader,noarchive}]] [-s]
[--noupx] [-c] [-w]
[-i <FILE.ico or FILE.exe,ID or FILE.icns>]
[--version-file FILE] [-m <FILE or XML>] [-r RESOURCE]
[--uac-admin] [--uac-uiaccess] [--win-private-assemblies]
[--win-no-prefer-redirects]
[--osx-bundle-identifier BUNDLE_IDENTIFIER]
[--runtime-tmpdir PATH] [--bootloader-ignore-signals]
[--distpath DIR] [--workpath WORKPATH] [-y]
[--upx-dir UPX_DIR] [-a] [--clean] [--log-level LEVEL]
scriptname [scriptname ...]
positional arguments:
scriptname 要处理的脚本文件的名称或是一个
.spec-file。如果指定了一个.spec-file,大多数选项
都是不必要的,会被忽略。
optional arguments:
-h, --help 显示帮助信息
-v, --version 显示pyinstaller版本信息
--distpath DIR 打包存储的路径 (默认: .\dist)
--workpath WORKPATH 构建的临时文件、.log、.pyz
和其他文件都目录。(默认:.\build)
-y, --noconfirm 替换输出目录(默认: SPECPATH\dist\SPECNAME),而不需要确认。
--upx-dir UPX_DIR UPX工具的路径(默认:搜索执行路径)
-a, --ascii 不包括unicode编码支持(默认:如果有的话就包含在内)
--clean 在构建之前清理PyInstaller缓存并删除临时文件。
--log-level LEVEL 构建时控制台信息的日志级别
可以是TRACE, DEBUG, INFO, WARN, ERROR,CRITICAL(默认:INFO)。
What to generate:
-D, --onedir 创建一个包含可执行文件的单文件夹包(默认打包方式)
-F, --onefile 创建单文件的可执行文件包
--specpath DIR 用于存储生成的.spec文件的文件夹(默认: 当前目录)
-n NAME, --name NAME 为应用程序和.spec文件指定的名称(默认:第一个脚本的基本名称)
What to bundle, where to search:
--add-data <SRC;DEST or SRC:DEST>
额外的非二进制文件或文件夹将被添加到可执行文件。
路径分隔符是平台特定的,`os.pathsep`
(在Windows上是`;`,在大多数unix系统上是`:`)。
该选项可以多次使用。
--add-binary <SRC;DEST or SRC:DEST>
要添加到可执行文件中的额外二进制文件。
参见`--add-data`选项以了解更多细节。该选项可以被多次使用。
-p DIR, --paths DIR 搜索导入的路径(就像使用PYTHONPATH)。
允许多个路径,用';'分隔,或者多次使用该选项
--hidden-import MODULENAME, --hiddenimport MODULENAME
添加隐性导入包。该选项可以多次使用。
--additional-hooks-dir HOOKSPATH
搜索钩子的一个额外路径。这个选项可以多次使用。
--runtime-hook RUNTIME_HOOKS
自定义运行时钩子文件的路径。一个运行时钩子是
与可执行文件捆绑在一起的代码,并在任何其他代码或模块之前执行。
以设置运行时环境的特殊功能。这个选项可以被多次使用。
--exclude-module EXCLUDES
忽略的模块或包 (python name, 不是路径名) (就像没被找到一样). 这个选项可以被多次使用。
--key KEY 加密密钥
How to generate:
-d [{all,imports,bootloader,noarchive}], --debug [{all,imports,bootloader,noarchive}]
为调试一个冻结的应用程序提供帮助
应用程序提供帮助,方法是指定一个或多个
以下选择。
- all。以下所有三个选项;这是
默认选择,除非指定了下面的一个选项
指定。
- imports: 指定-v选项给底层的
解释器,使其在每次初始化模块时打印一条信息
信息,显示模块的
的地方 (文件名或内置模块)。
被加载的地方 (文件名或内置模块)。见
https://docs.python.org/3/using/cmdline.html#id4。
- bootloader:告诉bootloader在初始化和启动程序时发布进度信息。
消息,同时初始化和启动
捆绑的应用程序。用来诊断与丢失导入的问题。
- noarchive:不要把所有冻结的Python
源文件作为归档文件存储在生成的
可执行文件,而是将它们作为文件存储在结果的输出目录中。
-s, --strip 对可执行文件和共享库设置软链接(不建议用于Windows)。
--noupx 不使用UPX(Windows和*nix之间的工作方式不同)。
Windows and Mac OS X specific options:
-c, --console, --nowindowed
为标准i/o打开一个控制台窗口(默认)。
-w, --windowed, --noconsole
Windows和Mac OS X:无控制台窗口。在Mac OS X上,这构建一个OS X的.app 包。这个选项在*NIX系统中被忽略
-i <FILE.ico or FILE.exe,ID or FILE.icns>, --icon <FILE.ico or FILE.exe,ID or FILE.icns>
FILE.ico:将该图标应用于一个Windows可执行文件。
FILE.exe,ID,从一个exe中提取带有ID的图标。
FILE.icns:将该图标应用到Mac OS的.app包中。
Windows specific options:
--version-file FILE 从FILE中添加一个版本信息到exe中
-m <FILE or XML>, --manifest <FILE or XML>
将清单FILE或XML添加到exe中
-r RESOURCE, --resource RESOURCE
向Windows可执行文件添加或更新资源。该
RESOURCE格式:FILE[,TYPE[,NAME[,LANGUAGE]]]。
FILE可以是一个数据文件或一个exe/dll。
- 对于数据文件,须指定TYPE和NAME。语言LANGUAGE的默认值是0,或者可以
指定为通配符*,以更新所有属于给定的TYPE和NAME的所有资源。
- 对于exe/dll文件,所有来自FILE的资源将被添加/更新到最终的可执行文件中。
TYPE、NAME和LANGUAGE被省略或被指定为通配符*.此选项可以被多次使用。
可以多次使用。
--uac-admin 使用这个选项可以创建一个Manifest,它将在应用程序启动时请求提升admin权限。
--uac-uiaccess 使用该选项可以使应用程序与远程桌面一起工作。
Windows Side-by-side Assembly searching options (advanced):
--win-private-assemblies
捆绑在应用程序中的任何共享装配体将被改变为私有组件。
这意味着这些程序集的指定版本将始终被使用
而在用户机器上安装的任何较新版本都将被忽略。
--win-no-prefer-redirects
当搜索共享或私有程序集来打包到应用程序中时,PyInstaller会倾向于
不遵循重定向到较新版本的策略。
而会尝试打包指定的汇编的确切版本。
Mac OS X specific options:
--osx-bundle-identifier BUNDLE_IDENTIFIER
Mac OS X的.app打包标识符被用作默认的唯一的程序名称,用于代码签名。
通常的形式是反向DNS中的分级名称。
例如:com.mycompany.department.appname(默认:第一个脚本的基本名称)
Rarely used special options:
--runtime-tmpdir PATH
指定临时运行目录路径
单文件模式下bootloader将忽略任何由运行时操作系统定义的临时文件夹位置的临时文件夹。
`_MEIxxxxxx'-文件夹将在这里被创建。高级选项,懂得配置的可以使用这个选项。
--bootloader-ignore-signals
告诉bootloader忽略信号而不是将它们转发给子进程。
适用于在这样的情况下很有用,比如:一个监督者进程向bootoader和子进程发出信号(例如通过一个进程组进程组)以避免对子进程发出两次信号。
pyinstaller 3.4 帮助信息翻译
最新推荐文章于 2023-10-05 15:18:59 发布