python - 使用 cx_Freeze 创建 MSI 时可用的 bdist_msi 选项

Question

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

我在与此主题相关的其他 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 installer docs提到了一些分散在各处的选项。cx_Freeze docs记录了两个选项(包括 upgrade_code)，并提到它们可与 standard set of options 一起使用。 。我在哪里可以找到上述标准选项集列表？

Answer 1

您可以查看 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 选项可用于让安装程序在桌面上或程序菜单中添加快捷方式，如 Use cx-freeze to create an msi that adds a shortcut to the desktop 中所述。和 here 。