Python打包之嵌入式打包神器PyStand

在使用Python开发项目时，如果项目依赖了如torch这样的大型第三方库，打包后的体积可能会变得非常庞大（超过1GB）。传统的打包工具，如Nuitka或PyInstaller，可能会面临打包成功率低、耗时长、打包后体积巨大的问题。

为了解决这一问题，龙哥试了几种打包方法，各有好处。本文将探讨一种嵌入式打包的方法，即只分发解释器和核心代码，而第三方依赖则在用户第一次使用程序时现场安装。

解决思路

通过嵌入式打包，我们可以显著减少分发包的大小。用户在第一次运行程序时，程序会自动安装所需的第三方依赖。这种方法不仅减少了分发包的体积，也避免了传统打包方式可能出现的漏包问题。

示例代码

本文使用的软件版本为Python 3.10.9。如果你对嵌入式打包不太了解，可以先阅读相关的文章。以下是一个简单的示例项目结构和代码。

项目结构

app.py入口文件

python">from app.main import main
if __name__=="__main__":main()

打包准备

准备项目依赖：在项目环境中运行pip freeze > requirements.txt来导出依赖文件。
准备嵌入式解释器：可以直接从python官方网站下载。
准备PyStand壳：从GitHub下载PyStand。
准备get-pip.py：用于下载pip工具，可以从bootstrap.pypa.io/get-pip.py获取。

开始打包

将代码复制到PyStand同级目录的app文件夹中，并将main.py的内容复制到PyStand的pystand.int文件中，文件重命名_pystand_static.int。
在runtime文件夹内新建download.py文件，用于在首次运行时安装依赖。

python">import os
import sys
from pathlib import Pathprint("第一次启动，缺少环境依赖，开始安装依赖，请保持网络畅通")
python_path = Path(sys.exec_prefix).joinpath("python.exe")
get_pip_script = Path(sys.exec_prefix).joinpath("get-pip.py")
command = f"{python_path} {get_pip_script}"  # 安装pip工具
os.system(command)
requirements_path = Path(sys.exec_prefix).joinpath("requirements.txt")  # 安装其他依赖
# 安装依赖，这是阿里源
command = str(python_path) + " -m pip install --no-warn-script-location -i https://mirrors.aliyun.com/pypi/simple/ -r" + f"{requirements_path}"
status_code = os.system(command)
# 然后退出程序，提醒用户重启
if status_code != 0:input("依赖安装失败")
else:input("依赖安装完成，请重新打开程序，按回车键退出")
sys.exit()

修改pystand.int文件，捕获ModuleNotFoundError错误，并调用runtime文件夹中的Python解释器运行download.py脚本。

python">
import os
import systry:from app.main import main
except ModuleNotFoundError:from pathlib import Pathpython_path = Path(sys.exec_prefix).joinpath("python.exe")download_script = Path(sys.exec_prefix).joinpath("download.py")command = f"{python_path} {download_script}"os.system(command)sys.exit()if __name__=="__main__":main()