127 lines
4.8 KiB
Python
127 lines
4.8 KiB
Python
"""用 PyInstaller 打包成单文件 exe。
|
||
|
||
用法::
|
||
|
||
uv run python packaging/build_pyinstaller.py # 单文件（默认）
|
||
uv run python packaging/build_pyinstaller.py --onedir # 目录模式，启动更快
|
||
uv run python packaging/build_pyinstaller.py --console # 带控制台，排查启动问题
|
||
uv run python packaging/build_pyinstaller.py --no-selftest # 跳过构建后自检
|
||
|
||
产物：``dist/pyinstaller/``
|
||
|
||
构建前会先做两件事（任一失败即中止）：
|
||
|
||
1. **私钥守卫**：源码树里若存在私钥 / ``*.lic`` / ``licenses.db`` 就停下 ——
|
||
这些东西绝不能进分发包；
|
||
2. **生成 exe 图标**：由主题里的盾牌 SVG 渲染多尺寸 ``.ico``，无需美术素材。
|
||
|
||
构建后自动跑 ``<exe> --selftest`` 两轮（offscreen + 系统原生平台插件），
|
||
验证冻结产物里的 Qt 插件、图标渲染、Ed25519 签发与验签链路都还在。
|
||
"""
|
||
from __future__ import annotations
|
||
|
||
import argparse
|
||
import os
|
||
import shutil
|
||
import sys
|
||
import time
|
||
from pathlib import Path
|
||
|
||
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
||
import _common as common # noqa: E402
|
||
|
||
|
||
def parse_args() -> argparse.Namespace:
|
||
parser = argparse.ArgumentParser(description="用 PyInstaller 打包 chongming 授权工具")
|
||
mode = parser.add_mutually_exclusive_group()
|
||
mode.add_argument("--onefile", action="store_true", default=True,
|
||
help="打成单个 exe（默认；分发最省事）")
|
||
mode.add_argument("--onedir", action="store_true",
|
||
help="打成目录（启动更快，适合固定办公机）")
|
||
parser.add_argument("--console", action="store_true",
|
||
help="保留控制台窗口（默认无控制台；排查启动失败时有用）")
|
||
parser.add_argument("--clean", action="store_true", help="构建前清掉旧的 dist/build")
|
||
parser.add_argument("--no-selftest", action="store_true", help="跳过构建后的产物自检")
|
||
parser.add_argument("--allow-sensitive-files", action="store_true",
|
||
help="源码树里有私钥/.lic/台账库时仍继续构建（默认中止）")
|
||
return parser.parse_args()
|
||
|
||
|
||
def main() -> int:
|
||
args = parse_args()
|
||
common.require("PyInstaller", "pyinstaller")
|
||
|
||
onefile = not args.onedir
|
||
dist_dir = common.DIST / "pyinstaller"
|
||
build_dir = common.PACKAGING / "build" / "pyinstaller"
|
||
|
||
print("=" * 60)
|
||
print(f"PyInstaller 打包（{'单文件' if onefile else '目录模式'}）")
|
||
print("=" * 60)
|
||
|
||
# 1) 安全闸门：私钥/授权文件/台账库一个都不能出现在产物链路里
|
||
common.guard_no_secrets(allow=args.allow_sensitive_files)
|
||
|
||
# 2) 图标
|
||
icon = common.build_app_icon()
|
||
|
||
if args.clean:
|
||
for path in (dist_dir, build_dir):
|
||
if path.exists():
|
||
shutil.rmtree(path)
|
||
print(f"已清理 {path.relative_to(common.ROOT)}")
|
||
|
||
# 3) 调用 PyInstaller（选项通过环境变量传给 spec）
|
||
env = dict(os.environ)
|
||
env.update({
|
||
"CLG_NAME": common.APP_NAME,
|
||
"CLG_ONEFILE": "1" if onefile else "0",
|
||
"CLG_CONSOLE": "1" if args.console else "0",
|
||
"CLG_ICON": str(icon) if icon else "",
|
||
})
|
||
# PATH 里若有"与 Python 同名的 DLL"，PyInstaller 会误收集它们（见 _common 的说明）
|
||
env.update(common.build_env_overrides(env))
|
||
|
||
command = [
|
||
sys.executable, "-m", "PyInstaller",
|
||
"--noconfirm",
|
||
"--distpath", str(dist_dir),
|
||
"--workpath", str(build_dir),
|
||
str(common.PACKAGING / "pyinstaller.spec"),
|
||
]
|
||
log_path = common.PACKAGING / "build" / "pyinstaller-build.log"
|
||
print("\n$ " + " ".join(command))
|
||
print(f"构建日志：{log_path.relative_to(common.ROOT)}\n")
|
||
|
||
started = time.monotonic()
|
||
code, log_text = common.run_build(command, log_path, env)
|
||
elapsed = time.monotonic() - started
|
||
if code != 0:
|
||
print(f"❌ PyInstaller 构建失败（退出码 {code}）\n")
|
||
print(common.log_tail(log_text, 30))
|
||
print(f"\n完整日志：{log_path.relative_to(common.ROOT)}")
|
||
return code
|
||
|
||
# 4) 找到产物并验证
|
||
artifact = common.find_artifact(dist_dir)
|
||
if artifact is None:
|
||
print(f"\n❌ 构建结束但没在 {dist_dir} 里找到 exe")
|
||
return 1
|
||
|
||
stray = common.guard_artifact_no_secrets(artifact.parent)
|
||
if stray:
|
||
print(f"\n❌ 产物目录里出现敏感文件，请检查后再分发：{stray}")
|
||
return 1
|
||
|
||
if not args.no_selftest:
|
||
if not common.verify_artifact(artifact, "PyInstaller 产物"):
|
||
print("\n❌ 产物自检未通过 —— 先别分发，见上方输出")
|
||
return 1
|
||
|
||
common.report_success("PyInstaller", artifact, elapsed)
|
||
return 0
|
||
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(main())
|