Python+PyQt5开发一个Windows EXE程序在线更新工具

 更新时间:2026年01月04日 09:33:03   作者:weixin_46244623  
这篇文章主要为大家详细介绍了Python+PyQt5开发一个Windows EXE程序在线更新工具,可以自动检测新版本并完成在线升级,感兴趣的小伙伴可以了解下

一、前言

在使用 PyQt5 + PyInstaller 开发 Windows 桌面工具时,一个非常现实的问题是:

程序如何自动检测新版本,并完成在线升级?

本文基于一个真实可用、已落地的更新方案,实现了:

  • 远程版本号检测
  • 语义化版本对比
  • 更新提示弹窗
  • 子线程下载更新包
  • 实时下载进度条
  • ZIP 解压
  • EXE 自动替换
  • 旧版本自动备份
  • 更新完成后安全退出

非常适合 工具类 / 内部系统 / 单机 EXE 程序

二、运行效果说明

整体更新流程如下:

  • 点击「获取最新版本」
  • 请求远程 version.txt
  • 发现新版本 → 弹窗提示
  • 用户确认 → 下载 update.zip
  • 显示下载进度条
  • 解压更新文件
  • 备份旧 EXE
  • 替换新 EXE
  • 提示升级完成并退出程序

三、环境与依赖说明

Python 版本

Python 3.8+

pip 依赖安装

pip install PyQt5
pip install requests
pip install packaging

(如需打包 EXE)

pip install pyinstaller

四、服务器端准备

版本号文件(version.txt)

1.2.0

更新包(update.zip)

update.zip
├── update.exe
├── logo.png(可选)

五、完整代码

SoftVesion.py
def current_version():
    """
    Returns the version of the package
    """
    return "1.1.0"
def latest_version():
    """
    Returns the latest version of the package
    """
    return "1.1.0"
def upgrade_date():
    """
    Returns the time of the upgrade
    """
    return "2024年1月19日"
def current_title():
    """
    Returns the title of the package
    """
    return "Excel常用小工具"
def remote_version_url():
    """
    Returns the url of the latest version
    """
    return "http://82.157.62.197:97/version.txt"
def update_url():
    """
    Returns the url of the version info
    """
    return "http://192.168.31.219:8080/update.zip"

UpdateApp.py

import os
import zipfile
import requests
from packaging import version
from PyQt5.QtCore import QThread, pyqtSignal, Qt
from PyQt5.QtWidgets import QApplication,QDialog, QVBoxLayout,QMainWindow, QPushButton, QMessageBox, QProgressDialog,QLabel,QAction,QDesktopWidget
import shutil
from .SoftVesion import current_version,latest_version,remote_version_url,update_url,current_title
from PyQt5.QtGui import QStandardItemModel, QStandardItem,QIcon
import sys
import time
import subprocess
class DownloadThread(QThread):
    progressChanged = pyqtSignal(int)
    downloadFinished = pyqtSignal()
    unableToFetchUpdateLink = pyqtSignal()

    def __init__(self, url, save_path):
        super().__init__()
        self.url = url
        self.save_path = save_path

    def run(self):
        try:
            response = requests.get(self.url, stream=True)
            if response.status_code == 200:
                total_size = int(response.headers.get('content-length', 0))

                downloaded_size = 0
                with open(self.save_path, 'wb') as file:
                    for data in response.iter_content(chunk_size=8192):
                        file.write(data)
                        downloaded_size += len(data)
                        progress = int((downloaded_size / total_size) * 100)
                        self.progressChanged.emit(progress)

                self.downloadFinished.emit()
            else:
                print("Error fetching update link:")
                self.unableToFetchUpdateLink.emit()
        except Exception as e:
            print("Error fetching update link:", e)
            self.unableToFetchUpdateLink.emit()

class UpdateApp(QDialog):
    def __init__(self,parent=None):
        super().__init__(parent)
        self.current_version = current_version()  # 当前应用程序版本号
        self.latest_version = latest_version()
        self.progress_dialog = None
        self.download_thread = None
        self.remote_version_url= remote_version_url()
        self.update_url = update_url()
        self.init_ui()
        #self.show_update_notification()
    def move_to_center(self, widget):
        # 将 widget 移动到屏幕中央
        desktop_center = QDesktopWidget().availableGeometry().center()
        widget_frame = widget.frameGeometry()
        widget_frame.moveCenter(desktop_center)
        widget.move(widget_frame.topLeft())
    def init_ui(self):
        self.setFixedSize(300, 200)
        self.setWindowTitle("检查更新")
        icon = QIcon("icon.png")
        self.setWindowIcon(icon)

        self.version_label = QLabel("当前版本号: " + self.current_version, self)
        self.version_label.setAlignment(Qt.AlignCenter) 
        self.version_label.setGeometry(100, 10, 110, 20)

        self.update_button = QPushButton("获取最新版本", self)
        self.update_button.setGeometry(100, 60, 110, 40)
        self.update_button.clicked.connect(self.show_update_notification)

        if self.download_thread:
            self.download_thread.unableToFetchUpdateLink.connect(self.show_unable_to_fetch_update_link)

    def show_unable_to_fetch_update_link(self):
        QMessageBox.critical(self, "无法获取更新链接", "无法获取更新链接,请检查网络连接。")

    def update_app(self):
        try:
            remote_version = self.get_remote_version()
            if version.parse(remote_version) > version.parse(self.current_version):
                if self.has_network_connection():
                    self.perform_upgrade()
                else:
                    QMessageBox.information(self, "无法获取版本号", "无法获取远程版本号,请检查网络连接。")
            else:
                QMessageBox.information(self, "无需升级", "当前应用程序已经是最新版本。")
        except:
            QMessageBox.information(self, "无法获取版本号", "无法获取远程版本号,请检查网络连接。")

    def get_remote_version(self):
        try:
            response = requests.get(self.remote_version_url)
            if response.status_code == 200:
                return response.text.strip()
            return self.latest_version
        except:
            return self.latest_version

    def perform_upgrade(self):
        update_url = self.update_url
        temp_zip_path = "temp_update.zip"

        self.download_thread = DownloadThread(update_url, temp_zip_path)
        self.download_thread.progressChanged.connect(self.update_progress_bar)
        self.download_thread.downloadFinished.connect(self.handle_download_finished)

        self.progress_dialog = QProgressDialog("正在下载更新...", None, 0, 100, self)
        self.progress_dialog.setWindowModality(Qt.WindowModal)
        self.progress_dialog.setAutoClose(False)
        self.progress_dialog.setAutoReset(False)
        self.progress_dialog.setWindowTitle("下载进度")
        self.move_to_center(self.progress_dialog)
        self.progress_dialog.canceled.connect(self.download_thread.quit)

        self.download_thread.start()

    def update_progress_bar(self, progress):
        self.progress_dialog.setValue(progress)

    def handle_download_finished(self):
        self.progress_dialog.hide()
        if os.path.exists("temp_update.zip"):
            self.process_download("temp_update.zip")
            os.remove("temp_update.zip")
        sys.exit()

    def has_network_connection(self):
        try:
            requests.get(remote_version_url(), timeout=5)
            return True
        except:
            return False

    def show_update_notification(self):
        try:
            remote_version = self.get_remote_version()
            if version.parse(remote_version) > version.parse(self.current_version):
                reply = QMessageBox.question(
                    self, "版本更新提示",
                    f"有新版本可用:{remote_version}\n您当前的版本:{self.current_version}\n是否要更新?",
                    QMessageBox.Yes | QMessageBox.No
                )
                if reply == QMessageBox.Yes:
                    self.update_app()
            else:
                QMessageBox.information(self, "版本更新提示", "您当前的版本是最新版本。")
        except:
            pass

if __name__ == "__main__":
    app = QApplication([])
    window = UpdateApp()
    window.show()
    app.exec_()

六、关键设计说明

使用 QThread 防止界面卡死

使用 packaging.version 进行版本比较

ZIP 更新包支持扩展文件

EXE 覆盖前自动备份

更新完成后安全退出

七、适用场景

PyQt5 工具软件

内部办公系统

单机 EXE 程序

不依赖第三方更新框架

八、总结

本文提供的是一个 可直接落地、真实可用 的 PyQt5 自动更新方案,无需复杂服务器逻辑,维护成本极低。

到此这篇关于Python+PyQt5开发一个Windows EXE程序在线更新工具的文章就介绍到这了,更多相关Python EXE程序更新内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python OpenCV 彩色与灰度图像的转换实现

    Python OpenCV 彩色与灰度图像的转换实现

    为了加快处理速度在图像处理算法中,往往需要把彩色图像转换为灰度图像,本文主要介绍了Python OpenCV 彩色与灰度图像的转换实现,感兴趣的可以了解一下
    2021-06-06
  • Django logging配置及使用详解

    Django logging配置及使用详解

    这篇文章主要介绍了Django logging配置及使用详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-07-07
  • 使用TensorFlow创建生成式对抗网络GAN案例

    使用TensorFlow创建生成式对抗网络GAN案例

    这篇文章主要为大家介绍了使用TensorFlow创建生成式对抗网络GAN案例,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-03-03
  • 如何在Python中进行异常处理

    如何在Python中进行异常处理

    这篇文章主要介绍了如何在Python中进行异常处理,Python中使用用异常对象(exception object)表示异常情况,当程序运行遇到错误后,就会触发发异常,下文关于异常处理的相关内容,需要的小伙伴可以参考一下
    2022-03-03
  • python如何将图片转换素描画

    python如何将图片转换素描画

    这篇文章主要介绍了python如何将图片转换素描画,帮助大家更好的用python处理图片,感兴趣的朋友可以了解下
    2020-09-09
  • Python热重载调试新利器问题解决

    Python热重载调试新利器问题解决

    Reloading是一个Python工具库,它让我们可以在每次迭代之前从源代码中重新加载(或函数)而不丢失任何当前已执行过程,这篇文章主要介绍了Python热重载调试新利器,需要的朋友可以参考下
    2024-06-06
  • Python全栈之单项循环

    Python全栈之单项循环

    这篇文章主要为大家介绍了Python单项循环,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2021-11-11
  • pytorch 梯度NAN异常值的解决方案

    pytorch 梯度NAN异常值的解决方案

    这篇文章主要介绍了pytorch 梯度NAN异常值的解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-06-06
  • Python查找算法之分块查找算法的实现

    Python查找算法之分块查找算法的实现

    这篇文章主要介绍了Python查找算法之分块查找算法的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-04-04
  • 解决Pycharm双击图标启动不了的问题(JetBrains全家桶通用)

    解决Pycharm双击图标启动不了的问题(JetBrains全家桶通用)

    这篇文章主要介绍了Pycharm双击图标启动不了(JetBrains全家桶通用),本文给大家分享问题及解决方法,需要的朋友可以参考下
    2020-08-08

最新评论