更新 / Updates

概述

TeX64 同时支持应用内更新与手动下载。您可以随时使用偏好的方式更新到最新版本。

应用内更新流程

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

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

手动更新

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

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+点击并选择「打开」，或在系统设置「安全与隐私」中允许。