如何将 Python 项目打包成 exe，另带卸载功能!

off999 2024-09-16 00:53 60 浏览 0 评论

前言

虽然我是做 web 的，但是对 Python 的众多开源项目一直都很关注。像之前的 stable diffusion 的 AI 绘画，和 so-vits-svc 音色替换等源码的部署文档都很完善了。尽管如此，对于刚入门的和本地环境搭建各种踩坑的同学，又急于一试就显得不太友好了。针对这一现象，网上早有了各种大佬做了一键部署的解决方案，不用安装 Python 环境，不用下载各种依赖包，点一下 exe 就可以用了。

那他们是怎么做的呢，到这里应该已经很多人会说用 pyinstaller。是的这个确实可以解决整体环境打包，但是有时候一些图标和依赖文件要放在一起才能正常使用，类似于绿色桌面工具。那有没有方法对这个进一步封装，就是点击 exe 后需要安装，然后安装后才是项目的文件，还可以卸载，答案就是用 Inno Setup Compiler。那么，接下来我就用一个 GUI 的小 demo 完成 exe 打包和进一步安装打包。

环境

Python 3.8

Tkinter (自带)

pyinstaller 6.3.0

Inno Setup Compiler

基本流程

用 conda 单独创建一虚拟环境，比如写一个 tkinter 应用，对了为了好看，我们可以设置以下 icon，尺寸 32x32，大图标 64x64 准备一下即可。然后用 pyinstaller 将应用达成文件包 (含 exe)，最后用 Inno Setup Compiler 达成安装包，里面就是各种文件关联，图标和信息的设置了。

开始操作

环境创建

# 1. 创建环境
conda create -n tools_env python=3.8
	
# 2. 进入环境
conda activate tools_env
	
# 3. 安装 pyinstaller
pip install pyinstaller -i https://pypi.tuna.tsinghua.edu.cn/simple

编码示例

import tkinter as tk
from tkinter import ttk
from tkinter import messagebox
from ToolTip import ToolTip
import os
import time


class Application(tk.Tk):

    def __init__(self):
        super().__init__()
        self.title("gz号：ZERO开发")
        self.iconbitmap('logo.ico')
        self.geometry("600x370")  # 设置固定的窗口大小
        self.resizable(False, False)  # 禁止调整窗口大小
        self.style = ttk.Style(self)
        self.main_color = self.cget("bg")

        self.style.configure("TEntry",
                             padding=6,
                             relief="flat",
                             background="#0078d7",
                             foreground="black",
                             font=("Arial", 12, "bold"))

        self.style.configure("TLabel",
                             font=("Arial", 12, "bold"))

        self.style.configure("TButton",
                             padding=6,
                             font=("Arial", 12))

        self.create_widgets()

    def create_widgets(self):
        self.path_label = ttk.Label(self, text='绝对路径:')
        self.path_label.grid(row=0, sticky=tk.W, pady=30, padx=20)

        self.path = tk.StringVar()
        self.path_entry = ttk.Entry(self, width=60, textvariable=self.path)
        self.path_entry.grid(row=0, column=1, sticky=tk.E, pady=5)
        ToolTip(self.path_entry, "电脑里的目录路径，如 D:\\3code\\6pytorch\pytorch_ai_demo")

        self.rename_label = ttk.Label(self, text='修改名称:')
        self.rename_label.grid(row=1, sticky=tk.W, pady=5, padx=20)

        self.rename = tk.StringVar()
        self.rename_entry = ttk.Entry(self, width=60, textvariable=self.rename)
        self.rename_entry.grid(row=1, column=1, sticky=tk.E, pady=5)

        self.msg_text = tk.Text(self, height=2, width=60, wrap='none')  # 添加一个列表框来显示文件名
        self.msg_text.grid(row=2, column=1, sticky=tk.W, pady=15)
        self.msg_text.configure(bd=0, relief="solid", bg=self.main_color)
        # self.msg_text.insert(tk.END, "这是要显示的文本。")

        ttk.Button(self, text='确认修改', command=self.start_program).grid(row=3, column=1, sticky=tk.W, pady=20, padx=120)
        ttk.Button(self, text='关于作者', command=self.about).grid(row=4, column=1, sticky=tk.W, padx=120)

    def start_program(self):
        print("绝对路径：{}, 重命名：{}". format(self.path.get(), self.rename.get()))

        path = self.path.get()
        rename = self.rename.get()

        if path == "" or rename == "":
            messagebox.showwarning("警告", "输入框不能为空！")
            return

        if os.path.isdir(path) == False:
            messagebox.showwarning("警告", "绝对路径不正确！")
            return

        i = 0
        # '该文件夹下所有的文件（包括文件夹）'
        FileList = os.listdir(path)

        # '遍历所有文件'
        for files in FileList:
            oldDirPath = os.path.join(path, files)

            self.msg_text.delete(1.0, tk.END)
            self.msg_text.insert(tk.END, oldDirPath)

            # '如果是文件夹则递归调用'
            if os.path.isdir(oldDirPath):
                self.start_program(oldDirPath)

            # '文件名'
            fileName = os.path.splitext(files)[0]
            # '文件扩展名'
            fileType = os.path.splitext(files)[1]
            fileType = fileType.lower()

            newDirPath = os.path.join(path, rename + "_" + str(i) + fileType)

            # '重命名'
            os.rename(oldDirPath, newDirPath)
            i += 1

        messagebox.showinfo("信息", "操作完成！")

    def about(self):
        messagebox.showinfo("关于", "gz号：ZERO开发\r\n\r\n工具：批量修改文件1.0")

    def quit_program(self):
        self.destroy()


if __name__ == "__main__":
    app = Application()
    app.mainloop()

开始打包

pyinstaller -F -w Application.py -–icon=logo.ico

这里我们希望打包是自己的图标就带上 icon，而且打开时不要出现黑色闪框就带上 w，当然后面打开 exe 要把 icon 放到与他同一级的目录中，尺寸上面已经说了，下面是参数说明。

参数说明：	
-–icon=图标路径
-F 打包成一个exe文件
-w 使用窗口，无控制台
-c 使用控制台，无窗口
-D 创建一个目录，里面包含exe以及其他一些依赖性文件

还有一个问题是，如果是修改了代码，需要反复多次打包，可以把项目前一次打包生成的生成的 spec 后缀文件删除即可。打包成功后，控制面包会显示 Building EXE from EXE-00.toc completed successfully，然后根目录的 dist 就是打包后的文件包，里面需要的文件图片等都在里面，后面用 Inno Setup Compiler 也就是对这个文件夹打包。

Inno Setup Compiler 操作

新建脚本，填写信息

选择主程序和需要的文件

设置名称和 icon

选择导出位置 (前面还有协议等设置)

运行脚本开始生成

安装打开，安装目录里有自带卸载程序

python程序打包