更新 / Updates

概述

Windows Store 版本由 Microsoft Store 自动管理更新。下方应用内与手动更新说明适用于 macOS。

macOS 应用内更新流程

可在 TeX64 内直接更新。这是最简单也是推荐的方式。

1. 打开设置并选择「账户」页面
2. 在更新区域查看当前版本和最新版本
3. 点击「检查更新」按钮以检查新版本
4. 若有新版本可用，会显示「应用更新」按钮。标题栏中也可能显示相同的一键 Update 按钮。
5. 点击「应用更新」下载并验证更新包
6. 下载准备完成后，TeX64 会启动对应操作系统的安装程序。请按照屏幕提示完成安装
7. 如有需要，安装后重新打开 TeX64，并在 设置 > 账户 中确认版本

macOS 手动更新

若应用内更新无法工作，或您希望手动控制，可直接从下载页面下载并安装。

1. 访问 /download 页面
2. 根据您的 Mac 架构选择最新构建（Apple Silicon / Intel Mac）
3. 下载 macOS DMG
4. 打开 DMG，将 TeX64.app 拖入「应用程序」
5. 当被询问是否替换旧版本时，选择「替换」
6. 完全重启 TeX64
7. 在 设置 > 账户 中确认版本

直接下载链接

可使用以下链接直接下载。请选择您的架构与文件格式：

• Apple Silicon — DMG（推荐）：
  /download/latest
• Apple Silicon — ZIP：
  /download/latest?kind=zip
• Intel（x64）— DMG：
  /download/latest?arch=x64
• Intel（x64）— ZIP：
  /download/latest?arch=x64&kind=zip

Manifest API

可在构建系统或自定义脚本中自动获取更新信息。Manifest API 可通过以下端点访问：

此端点会返回最新版本、下载 URL、SHA256 校验和、强制更新标志、发行说明 URL 等。可用于 CI/CD 流水线或自定义更新脚本。

API 参数

Manifest API 支持按平台、架构与渠道筛选：

• 平台：macOS（darwin）
• 架构：arm64（Apple Silicon）或 x64（Intel）
• 渠道：stable 或 beta

API 响应

API 返回包含以下信息的响应：

• latestVersion：最新版本号
• required：是否为强制更新
• notesUrl：发行说明 URL
• artifactUrl：下载 URL
• artifactSha256：用于完整性校验的 SHA256
• signature：数字签名（可选）

更新之后

更新完成后，请按以下步骤确认是否正常：

1. 安装程序完成后，如 TeX64 未运行，请重新打开
2. 打开 设置 > 账户，确认当前/最新版本号
3. 打开 设置 > 环境，确认 lualatex、latexmk、synctex 等正常工作
4. 使用示例项目构建以验证一切正常

支持的版本

TeX64 支持以下环境：

• macOS：12.x（Monterey）及更高
• 架构：Apple Silicon（arm64）与 Intel（x64）
• 文件格式：DMG（推荐）与 ZIP

Manifest API（/api/v2/updates/manifest）遵循相同的版本要求。

若更新失败

若更新失败，请尝试以下排查步骤：

1. /download 手动下载最新 DMG
2. 完全退出 TeX64（必要时可用 Option+Command+Esc 强制退出）
3. 从「应用程序」文件夹删除旧的 TeX64.app
4. 打开 DMG 并将新的 TeX64.app 拷贝到「应用程序」
5. 启动 TeX64 并验证可用
6. 在 设置 > 环境 中再次执行环境检查

常见问题

网络连接

下载更新需要稳定的网络连接。若连接不稳定，请尝试从 /download 手动下载。

磁盘空间

请确保有足够的可用空间用于下载与安装。建议至少保留 500 MB 可用空间。

安全软件

请检查杀毒或防火墙软件是否拦截了下载或安装。必要时临时禁用后再试。

Gatekeeper

若 macOS Gatekeeper 拦截 TeX64 运行，请 Control+点击并选择「打开」，或在系统设置「安全与隐私」中允许。