File size: 4,625 Bytes
76b9762
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
import httpx
from packaging import version
from typing import Optional, Tuple

from app.config.config import settings
from app.log.logger import get_update_logger

logger = get_update_logger()

VERSION_FILE_PATH = "VERSION"

async def check_for_updates() -> Tuple[bool, Optional[str], Optional[str]]:
    """
    通过比较当前版本与最新的 GitHub release 来检查应用程序更新。

    Returns:
        Tuple[bool, Optional[str], Optional[str]]: 一个元组,包含:
            - bool: 如果有可用更新则为 True,否则为 False。
            - Optional[str]: 如果有可用更新,则为最新的版本字符串,否则为 None。
            - Optional[str]: 如果检查失败,则为错误消息,否则为 None。
    """
    try:
        with open(VERSION_FILE_PATH, 'r', encoding='utf-8') as f:
            current_v = f.read().strip()
        if not current_v:
            logger.error(f"VERSION file ('{VERSION_FILE_PATH}') is empty.")
            return False, None, f"VERSION file ('{VERSION_FILE_PATH}') is empty."
    except FileNotFoundError:
        logger.error(f"VERSION file not found at '{VERSION_FILE_PATH}'. Make sure it exists in the project root.")
        return False, None, f"VERSION file not found at '{VERSION_FILE_PATH}'."
    except IOError as e:
        logger.error(f"Error reading VERSION file ('{VERSION_FILE_PATH}'): {e}")
        return False, None, f"Error reading VERSION file ('{VERSION_FILE_PATH}')."

    logger.info(f"当前应用程序版本 (from {VERSION_FILE_PATH}): {current_v}")

    if not settings.GITHUB_REPO_OWNER or not settings.GITHUB_REPO_NAME or \
       settings.GITHUB_REPO_OWNER == "your_owner" or settings.GITHUB_REPO_NAME == "your_repo":
        logger.warning("GitHub repository owner/name not configured in settings. Skipping update check.")
        return False, None, "Update check skipped: Repository not configured in settings."

    github_api_url = f"https://api.github.com/repos/{settings.GITHUB_REPO_OWNER}/{settings.GITHUB_REPO_NAME}/releases/latest"
    logger.debug(f"Checking for updates at URL: {github_api_url}")

    try:
        async with httpx.AsyncClient(timeout=10.0) as client:
            headers = {
                "Accept": "application/vnd.github.v3+json",
                "User-Agent": f"{settings.GITHUB_REPO_NAME}-UpdateChecker/1.0"
            }
            response = await client.get(github_api_url, headers=headers)
            response.raise_for_status()

            latest_release = response.json()
            latest_v_str = latest_release.get("tag_name")

            if not latest_v_str:
                logger.warning("在最新的 GitHub release 响应中找不到 'tag_name'。")
                return False, None, "无法从 GitHub 解析最新版本。"

            if latest_v_str.startswith('v'):
                latest_v_str = latest_v_str[1:]

            logger.info(f"在 GitHub 上找到的最新版本: {latest_v_str}")

            # 比较版本
            current_version = version.parse(current_v)
            latest_version = version.parse(latest_v_str)

            if latest_version > current_version:
                logger.info(f"有可用更新: {current_v} -> {latest_v_str}")
                return True, latest_v_str, None
            else:
                logger.info("应用程序已是最新版本。")
                return False, None, None

    except httpx.HTTPStatusError as e:
        logger.error(f"检查更新时发生 HTTP 错误: {e.response.status_code} - {e.response.text}")
        # 避免向用户显示详细的错误文本
        error_msg = f"获取更新信息失败 (HTTP {e.response.status_code})。"
        if e.response.status_code == 404:
            error_msg += " 请检查仓库名称是否正确或仓库是否有发布版本。"
        elif e.response.status_code == 403:
             error_msg += " API 速率限制或权限问题。"
        return False, None, error_msg
    except httpx.RequestError as e:
        logger.error(f"检查更新时发生网络错误: {e}")
        return False, None, "更新检查期间发生网络错误。"
    except version.InvalidVersion:
        latest_v_str_for_log = latest_v_str if 'latest_v_str' in locals() else 'N/A'
        logger.error(f"发现无效的版本格式。当前 (from {VERSION_FILE_PATH}): '{current_v}', 最新: '{latest_v_str_for_log}'")
        return False, None, "遇到无效的版本格式。"
    except Exception as e:
        logger.error(f"更新检查期间发生意外错误: {e}", exc_info=True)
        return False, None, "发生意外错误。"