PlayCover项目解决Wuthering Waves游戏文件重命名错误问题

问题背景

在PlayCover项目运行Wuthering Waves游戏时，用户遇到了"Failed to get patch list: File Rename Error"的错误提示。这个问题主要出现在游戏文件下载阶段，导致游戏无法正常安装和运行。该问题在macOS Sonoma 14.4.1系统、M1芯片的MacBook Air上尤为常见。

问题分析

经过技术团队分析，这个问题源于Unreal Engine在macOS环境下处理文件路径的特殊机制。具体表现为：

1. Unreal Engine在iOS和macOS平台使用不同的路径转换逻辑
2. 在macOS环境下，文件读取路径和写入路径被错误地拼接，导致路径解析失败
3. 游戏尝试访问的路径实际上变成了一个无效的嵌套路径结构

解决方案

技术团队提供了两种解决方案，一种是临时性的手动修复方案，另一种是更永久的PlayTools补丁方案。

手动修复方案

1. 首先启动游戏，进入用户协议界面后退出游戏
2. 在终端执行以下命令：

rm -r /Users/$USER/Library/Containers/com.kurogame.wutheringwaves.global/Data/Library/Users/$USER/Library/Containers/com.kurogame.wutheringwaves.global/Data && ln -sf /Users/$USER/Library/Containers/com.kurogame.wutheringwaves.global/Data /Users/$USER/Library/Containers/com.kurogame.wutheringwaves.global/Data/Library/Users/$USER/Library/Containers/com.kurogame.wutheringwaves.global/Data

这个命令的作用是：

• 删除错误的嵌套目录结构
• 创建一个符号链接(symlink)来正确指向游戏数据目录

自动化脚本方案

对于需要多次下载的情况，技术团队还提供了一个更智能的bash脚本方案：

#!/usr/bin/env sh

BASEDIR="/Users/$USER/Library/Containers/com.kurogame.wutheringwaves.global/Data/Library/Client/Saved/Resources/1.0.0"
CACHEDIR="/Users/$USER/Downloads/wuwaScript"
APP_NAME="com.kurogame.wutheringwaves.global"

LATESTMV=""

mkdir -p "$CACHEDIR"

check_if_complete() {
  file=$1
  filesize=$(stat -f%z "$file")
  sleep 1
  new_filesize=$(stat -f%z "$file")
  echo "old:" "$filesize" "new:" "$new_filesize"
  if [ "$filesize" -eq "$new_filesize" ]; then
    return 0
  else
  if [ "$LATESTMV" = "${file%.download}" ]; then
        sleep 1
        osascript -e "tell application \"$APP_NAME\" to quit with force"
        rm "${file}"
        cp "$CACHEDIR/$(basename "${LATESTMV}")" "$LATESTMV"
        echo "✅ This Download section is completed. You can reopen you game again!"
  fi
    return 1
  fi
}

while true; do
  for file in $(find "$BASEDIR" -name "*.download"); do
    if check_if_complete "$file"; then
      if [ "$LATESTMV" = "${file%.download}" ]; then
        sleep 1
        osascript -e "tell application \"$APP_NAME\" to quit with force"
        rm "${file}"
        cp "$CACHEDIR/$(basename "${LATESTMV}")" "$LATESTMV"
        echo "✅ This Download section is completed. You can reopen you game again!"
      else
        echo "$file => ${file%.download}"
        mv "$file" "${file%.download}"
        cp "${file%.download}" "$CACHEDIR"
        LATESTMV="${file%.download}"
      fi
    fi
  done
  sleep 1
done

这个脚本会自动监测下载进度，在适当的时候处理文件重命名问题，并能在下载完成后自动退出游戏以便用户重新启动。

技术原理

该问题的根本原因是Unreal Engine在macOS平台下的路径转换函数ConvertToIOSPath存在特殊行为。在iOS平台这个函数工作正常，但在macOS平台会导致路径被错误拼接：

原始路径：../../Content/Some_Content

读取路径被转换为： /Users/<User>/Library/Containers/<App>/<Documents or Library>//Users/<User>/Library/Containers/<App>/<Documents or Library>/<Some Path>/Content/Some_Content

写入路径被转换为： /Users/<User>/Library/Containers/<App>/<Documents or Library (不同路径)>//Users/<User>/Library/Containers/<App>/<Documents or Library (相同路径)>/<Some Path>/Content/Some_Content

注意事项

1. 对于中国区版本的游戏，需要将命令中的com.kurogame.wutheringwaves.global替换为com.kurogame.mingchao
2. 执行命令前确保游戏已经至少启动过一次
3. 如果遇到"no such file or directory"错误，请检查是否使用了正确的游戏包名
4. 使用脚本方案时，下载完成后记得清理~/Downloads目录中的缓存文件

总结

PlayCover团队通过深入分析Unreal Engine在macOS平台的文件路径处理机制，找到了这个问题的根源并提供了有效的解决方案。无论是简单的命令行修复还是更智能的脚本方案，都能帮助用户顺利运行Wuthering Waves游戏。这个问题的解决也展示了PlayCover团队对iOS/macOS平台兼容性问题的深刻理解和技术实力。