如何构建可嵌入的 Python

Question

我想知道如何为 Windows 构建可嵌入的 Python。找不到该特定包的任何信息或构建配置。

我问的原因是我可以为 Mac 和 Linux 使用相同的变体。

Answer 1

最近，我不得不为 64 位 Python 3.5.6 构建一个可嵌入的 zip（因为官方下载页面没有为大于 3.5.4 的 Python 提供它们），这里是步骤。

先决条件（一次性安装）

安装

1. 混帐
2. 乌龟SVN
3. Visual Studio C++ 构建工具 2015（构建最新的 Python 版本时可能需要 2017 版）¹

4. 如果您还没有Sphinx安装，请安装它并添加sphinx-build到PATH²：

   > python -m pip install --user sphinx
   > set PATH=%PATH%;C:\Users\jenkins\AppData\Roaming\Python\Python35\Scripts
   

5. 如果你还没有blurb安装，安装它，加入blurb到PATH如果有必要（如果你已经做了前面的步骤，你已经有了正确的PATH）：

   > python -m pip install --user blurb
   > set PATH=%PATH%;C:\Users\jenkins\AppData\Roaming\Python\Python35\Scripts
   

配置构建环境

1. 克隆 CPython 存储库。在这里，我只克隆了我需要的标签：

   > git clone --depth 1 --branch v3.5.6 https://github.com/python/cpython
   

2. 在 repo 目录中，生成NEWS文件^{3, 4}：

   > blurb merge -f Misc\NEWS
   

建造

现在您可以触发构建：

> Tools\msi\buildrelease.bat -x64 --skip-nuget --test testout

如果您的目标是 32 位架构，请替换-x64为-x32。--skip-nuget将省略构建 MSI 安装程序。--test testout将触发安装程序测试；如果你愿意，你可以跳过它们。

构建完成后，检查构建工件PCbuild\amd64\en-us\python-3.5.6-embed-amd64.zip。这是您的可嵌入拉链。

第一次构建成功后，只要文档构建工件保留在 repo 中，您就可以在未来的构建中跳过 doc 构建以进一步加速：

> Tools\msi\buildrelease.bat -x64 --skip-doc --skip-nuget --test testout

¹确保在 VC++ Build Tools 安装程序中选择“自定义”并选中所有选项；否则，您可能会遇到诸如此类的构建错误The code execution cannot proceed because ucrtbased.dll was not found。我绝不是 Windows 专家，只是安装了所有可能的东西来消除错误。

²查看buildrelease.bat帮助，您似乎可以跳过带有--skip-doc标志的文档构建，但是在使用它时，出现错误

"C:\Users\jenkins\projects\cpython\Tools\msi\bundle\releaselocal.wixproj" 
(Rebuild target) (1) ->
  "C:\Users\jenkins\projects\cpython\Tools\msi\doc\doc.wixproj" (Rebuild target) (7) ->
(Link target) ->
  C:\Users\jenkins\projects\cpython\Tools\msi\doc\doc_files.wxs(8): error 
LGHT0103: The system cannot find the file 'python356.chm'. [C:\Users\jenkins\projects\cpython\Tools\msi\doc\doc.wixproj]

并且构建因错误而中止。如果您在没有初始 doc 构建的情况下设法绕过此问题（因此 doc 文件在构建目录中可用），您可以跳过Sphinx安装。

³否则，我会收到构建错误

"C:\Users\jenkins\projects\cpython\Tools\msi\bundle\releaselocal.wixproj" (Rebuild target) (1) ->
"C:\Users\jenkins\projects\cpython\Tools\msi\exe\exe.wixproj" (Rebuild target) (8) ->
  C:\Users\jenkins\projects\cpython\Tools\msi\exe\exe_files.wxs(9): error 
LGHT0103: The system cannot find the file '!(bindpath.src)Misc\NEWS'. [C:\Users\jenkins\projects\cpython\Tools\msi\exe\exe.wixproj]

⁴您可以用适当的make调用替换命令，但我懒得破译Doc\Makefile. 毕竟，无论如何，消息不会落在可嵌入的 zip 中；这只是为了让buildrelease.bat快乐。