告别手动升级！MAA黑科技OTA更新全解析

2026-02-05 05:21:06作者：薛曦旖Francesca

你是否还在为游戏助手升级反复下载安装包？MAA（MaaAssistantArknights）的OTA（Over-the-Air）在线更新机制彻底解决了这一痛点。本文将从技术实现到用户操作，全方位解析MAA如何通过自动化脚本与智能检测，实现「无感升级」体验。

OTA更新原理与流程

MAA的OTA更新采用差量升级技术，通过对比本地版本与服务器版本的差异，仅下载变更文件，大幅节省流量与时间。核心流程分为四个阶段：

graph TD
    A[版本检测] --> B[差量包生成]
    B --> C[文件下载]
    C --> D[校验安装]
    D --> E[重启生效]

版本检测机制

客户端启动时会自动检查version.json文件（如tools/ResourceUpdater/version.sh所示），通过比对last_updated字段判断是否需要更新。该文件由CI/CD流程自动维护，确保版本信息实时同步。

差量包生成核心

OTA升级包由tools/OTAPacker/工具链生成，其中：

makeota.sh负责比对两个版本目录差异，生成待更新文件列表
zipota.sh处理ZIP包间的差量计算，通过CRC校验筛选变更文件
ziplist.sh解析ZIP文件元信息，为差量计算提供数据支持

关键代码片段（tools/OTAPacker/zipota.sh）：

# 计算文件CRC与路径的映射关系
zipinfo -O utf8 -v $1 \
  | sed -n -e '/^Central directory entry/,+3p' -e '/32-bit CRC value (hex):/p' \
  | grep '^  ' | sed -e 's/^  //g' \
  | sed -z 's/\n32-bit CRC value (hex):\s*/\t/g' \
  | awk '{last = $NF; $NF=""; print last,$0}'

用户操作指南

普通用户无需了解技术细节，通过以下步骤即可享受OTA升级：

自动触发：启动MAA后，程序会在后台完成检测（docs/zh-cn/manual/newbie.md第49行提到的"热更新"机制）
手动检查：在设置界面点击「检查更新」，触发强制检测
更新过程：进度条显示下载进度，完成后提示重启
版本回退：若更新异常，可通过OTA_rollback目录恢复上一版本

注意：首次安装用户需通过完整安装包初始化，后续更新才能使用OTA功能

技术实现细节

文件变更检测

tools/ResourceUpdater/version.sh通过Git命令监控资源文件变更：

all_modified_files=$(git diff --name-only HEAD 2>/dev/null)
# 排除任务配置文件，仅跟踪核心资源变更
modified_files=$(echo "$all_modified_files" | grep -v '^resource\(/global/[^/]*/resource\)\?/tasks/')