首页 > 解决方案 > 使用 cx_Freeze 创建 MSI 时可用的 bdist_msi 选项

问题描述

在使用安装脚本bdist_msi创建 MSI 时,我无法找到有关命令可用选项的文档。cx_Freeze

我在与该主题相关的其他 SO 帖子中看到了以下选项:

bdist_msi_options = {'data': '','add_to_path':'','initial_target_dir':'','upgrade_code':'',}

setup(
    options = {
        "bdist_msi": bdist_msi_options,
    },
    executables = [
        Executable(
            "test.py",
            )
        ]
)

Windows 安装程序文档提到了一些分散在各处的选项。cx_Freeze文档记录了两个选项(包括upgrade_code),提到它们与标准选项集一起可用。我在哪里可以找到上面提到的标准选项集列表?

标签: pythonwindows-installercx-freeze

解决方案


您可以查看cx_Freeze/windist.py中的源代码以查看预期选项的列表:

class bdist_msi(distutils.command.bdist_msi.bdist_msi):
    user_options = distutils.command.bdist_msi.bdist_msi.user_options + [
        ('add-to-path=', None, 'add target dir to PATH environment variable'),
        ('upgrade-code=', None, 'upgrade code to use'),
        ('initial-target-dir=', None, 'initial target directory'),
        ('target-name=', None, 'name of the file to create'),
        ('directories=', None, 'list of 3-tuples of directories to create'),
        ('environment-variables=', None, 'list of environment variables'),
        ('data=', None, 'dictionary of data indexed by table name'),
        ('product-code=', None, 'product code to use'),
        ('install-icon=', None, 'icon path to add/remove programs ')
    ]

正如你看到的:

  1. cx_Freeze 添加了比文档中提到的更多的选项
  2. cx_Freeze 的bdist_msi类派生自标准模块的谐音类distutils,它本身需要您在问题中提到的“标准选项集”,您可以阅读path_to_python\Lib\distutils\command\bdist_msi.py
class bdist_msi(Command):

    description = "create a Microsoft Installer (.msi) binary distribution"

    user_options = [('bdist-dir=', None,
                     "temporary directory for creating the distribution"),
                    ('plat-name=', 'p',
                     "platform name to embed in generated filenames "
                     "(default: %s)" % get_platform()),
                    ('keep-temp', 'k',
                     "keep the pseudo-installation tree around after " +
                     "creating the distribution archive"),
                    ('target-version=', None,
                     "require a specific python version" +
                     " on the target system"),
                    ('no-target-compile', 'c',
                     "do not compile .py to .pyc on the target system"),
                    ('no-target-optimize', 'o',
                     "do not compile .py to .pyo (optimized)"
                     "on the target system"),
                    ('dist-dir=', 'd',
                     "directory to put final built distributions in"),
                    ('skip-build', None,
                     "skip rebuilding everything (for testing/debugging)"),
                    ('install-script=', None,
                     "basename of installation script to be run after"
                     "installation or before deinstallation"),
                    ('pre-install-script=', None,
                     "Fully qualified filename of a script to be run before "
                     "any files are installed.  This script need not be in the "
                     "distribution"),
                   ]

您必须查看源代码中这些选项的实现,以了解如何使用它们。您会注意到其中一些没有实现或仅部分实现。

例如,该data选项可用于让安装程序在桌面或程序菜单中添加快捷方式,如使用 cx-freeze 创建向桌面此处添加快捷方式的 msi 中所述。


推荐阅读