ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

解决RiderLink插件构建失败的Win64平台识别问题

解决RiderLink插件构建失败的Win64平台识别问题

1. 问题现象与初步诊断

当你在Rider 2024.3.4中尝试为Unreal Engine 5.7构建RiderLink插件时,遇到了"Failed to build RiderLink plugin"错误。控制台输出的关键错误信息是:

Platform Win64 is not a valid platform to build. Check that the SDK is installed properly and that you have the necessary platform support files (DataDrivenPlatformInfo.ini, SDK.json, etc).

这个错误表明构建系统无法识别Win64平台,通常与以下因素有关:

  • .NET SDK版本不匹配(UE5.7需要.NET 8)
  • Visual Studio工具链配置错误
  • 平台支持文件缺失或损坏
  • 缓存文件冲突

2. 环境准备与工具链验证

2.1 确认Visual Studio组件

首先需要确保安装了正确的Visual Studio组件:

  1. 打开Visual Studio Installer
  2. 确认已勾选以下工作负载:
    • "使用C++的游戏开发"
    • ".NET桌面开发"
  3. 在单个组件中检查:
    • MSVC v143 - VS 2022 C++ x64/x86构建工具(最新版本)
    • Windows 10/11 SDK(版本需匹配UE5.7要求)
    • C++分析工具

提示:UE5.7特别依赖MSVC 14.38工具集,如果使用其他版本可能导致兼容性问题。

2.2 验证.NET环境

在PowerShell中运行以下命令检查.NET版本:

dotnet --list-sdks

UE5.7需要.NET 8.0.x,如果未安装,可以通过以下方式获取:

  1. 从微软官网下载.NET 8 SDK
  2. 或通过Visual Studio Installer安装

如果系统安装了多个.NET版本,需要确保Rider使用的是正确的版本。在Rider中:

  1. 打开File > Settings > Build, Execution, Deployment > Toolset
  2. 将".NET CLI executable path"指向:
    [UE5安装路径]\Engine\Binaries\ThirdParty\DotNet\8.0.300\win-x64\dotnet.exe

3. 完整解决方案步骤

3.1 清理冲突文件

执行以下清理操作(操作前关闭Rider和Unreal Editor):

  1. 删除Engine目录下的插件缓存:
    [UE5安装路径]\Engine\Plugins\Marketplace\Developer\RiderLink
  2. 删除项目目录中的相关文件夹:
    [项目路径]\Plugins\Developer\RiderLink [项目路径]\Saved [项目路径]\Intermediate [项目路径]\DerivedDataCache [项目路径]\Binaries
  3. 清除Rider缓存:
    %LOCALAPPDATA%\JetBrains\Rider2024.3\log

3.2 重新生成项目文件

  1. 右键点击.uproject文件
  2. 选择"Generate Visual Studio project files"
  3. 等待生成完成

3.3 配置RiderLink安装位置

在Rider中进行以下设置:

  1. 打开File > Settings > Languages & Frameworks > Unreal Engine
  2. 勾选"Install RiderLink in Game"(而非Engine)
  3. 点击"Install RiderLink"按钮

3.4 验证MSBuild路径

在Rider中:

  1. 打开File > Settings > Build, Execution, Deployment > Toolset
  2. 确保使用的是Visual Studio自带的MSBuild:
    C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe
    而非带"amd64"后缀的版本

4. 高级排查与已知问题解决方案

4.1 VisualStudioTools插件冲突

如果安装了VisualStudioTools插件,可能会与RiderLink产生冲突。解决方案:

  1. 完全移除VisualStudioTools插件
  2. 或将其移动到Engine/Plugins/Marketplace目录

4.2 UBT.dll补丁方案

对于某些特定错误(如ArgumentNullException),社区提供的临时解决方案是:

  1. 下载修改后的UBT.dll
  2. 替换原始文件:
    [UE5安装路径]\Engine\Binaries\DotNET\UnrealBuildTool\UnrealBuildTool.dll

注意:此方案存在风险,建议先备份原始文件

4.3 日志分析技巧

当问题仍然存在时,检查以下日志文件:

  1. Rider日志:
    %LOCALAPPDATA%\JetBrains\Rider2024.3\log\idea.log
  2. Unreal Build Tool日志:
    %USERPROFILE%\AppData\Roaming\Unreal Engine\AutomationTool\Logs\[UE5路径]\UBA-UnrealEditor-Win64-Development.txt

关键查找内容:

  • "error"或"fail"关键字
  • .NET版本提示
  • 平台验证失败信息

5. 预防措施与最佳实践

  1. 版本一致性:保持UE、Rider、Visual Studio大版本同步更新
  2. 隔离环境:为不同UE版本创建独立的Windows用户或虚拟机
  3. 备份策略:在修改关键配置前备份:
    • Engine/Plugins目录
    • Rider配置(通过File > Export Settings)
  4. 增量测试:新建空白C++项目测试插件安装,确认正常后再迁移到主项目

我在实际项目中发现,90%的RiderLink安装问题都源于环境配置不一致或缓存冲突。遵循上述步骤通常可以解决问题,但每个项目环境可能有细微差异,建议:

  1. 先尝试最简单的"安装到Game"方案
  2. 如果失败,再逐步执行完整清理流程
  3. 对于复杂项目,考虑创建干净的UE安装进行测试

最后提醒:JetBrains官方已知晓部分兼容性问题(跟踪编号RIDER-100275),建议定期检查插件更新以获取官方修复。

返回列表