向Rev Driver Hub推送代码时报Vuforia相关文件缺失错误如何解决

触发场景：完成Driver Hub与Control Hub同步后，推送teleops代码时Driver Hub弹出以下报错，同时伴随OpenRC应用崩溃、代码无法上传问题，重装SDK无法修复：

1. 缺失文件：内部存储的First/vision文件夹中缺少部分Vuforia / TensorFlow数据集文件，请按照readme中的设置说明检查是否已正确复制对应文件。
2. 未找到libVuforiaReal.so，请将其复制到内部存储的First/vision文件夹中。

修复步骤 #

1. 处理libVuforiaReal.so缺失问题 #

• 排查时注意区分文件名，报错要求的是libVuforiaReal.so而非libVuforia.so，该文件不属于SDK源码目录，属于Vuforia运行时动态库，不会被打包进本地代码
• 从官方FTC SDK压缩包的/doc/lib/目录提取libVuforiaReal.so文件，或从同版本正常运行的Driver Hub中导出该文件
• 手动将文件复制到Driver Hub内部存储的/First/vision/路径下，复制完成后重启Driver Hub

2. 补全Vuforia/TensorFlow数据集文件 #

• 下载对应赛季的官方Vuforia标定数据包和TensorFlow模型包，解压后所有文件直接放入/First/vision/目录，不得修改文件命名或子路径
• 若使用自定义视觉数据集，需按照SDK根目录下README_VISION.md的说明修改视觉模块的路径配置，避免默认路径匹配失败

3. 验证与兼容检查 #

• 重启OpenRC应用，进入设置页的视觉模块配置项，确认Vuforia与TensorFlow状态均显示为已加载
• 推送代码前确认本地SDK的视觉依赖版本与Driver Hub上安装的OpenRC版本完全一致，避免版本不兼容触发二次崩溃
• 若仍存在报错，先清除OpenRC应用的缓存数据，再重复上述操作，仅重装SDK无法解决问题的核心原因是Driver Hub本地存储的依赖缺失未被修复

内容的提问来源于stack exchange，提问作者Beastmodexol