最近我在macOS上首次安装了Qt 5.5,并使用Qt Creator开发。然而每次启动或打开项目时,都会遇到以下错误提示:

Project ERROR: Xcode not set up properly. You may need to confirm the license agreement by running /usr/bin/xcodebuild.

然后当我在终端执行 /usr/bin/xcodebuild 时,会得到如下错误信息:

xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance

经过调研和尝试,找到了几种解决方案,这里整理一下供大家参考。

解决方案

1. 配置xcode-select

当你安装了完整的Xcode之后(而不仅仅是命令行工具),你需要指向正确的开发者目录并接受许可协议:

sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license

接受许可协议后再次尝试打开Qt Creator项目,看是否解决了问题。

2. 修改Qt配置文件(适用于Xcode 8及以上版本)

如果你正在使用Xcode 8及以上版本,需要修改Qt的配置文件,让它查找xcodebuild而不是xcrun

打开文件 Qt_install_folder/5.7/clang_64/mkspecs/features/mac/default_pre.prf,然后将:

isEmpty($$list($$system("/usr/bin/xcrun -find xcrun 2>/dev/null")))

替换为:

isEmpty($$list($$system("/usr/bin/xcrun -find xcodebuild 2>/dev/null")))

3. 创建符号链接(不推荐)

另一种方式是为xcodebuild创建一个符号链接xcrun,这样你就不需要更改任何配置文件:

cd /Applications/Xcode.app/Contents/Developer/usr/bin/
sudo ln -s xcodebuild xcrun

虽然这种方法简单,但它可能会在后续操作中引发其他问题,因为xcrunxcodebuild不是完全相同的命令。

4. 安装完整版本的Xcode并重置Command Line Tools

有些情况下,你可能需要重置Command Line Tools的位置:

xcode-select --reset

完成上述操作后,尝试重新启动Qt Creator并加载你的项目。

5. 直接注释掉xcrun检查

如果以上方法仍然无效,可以直接注释掉配置文件中的xcrun检查行:

打开文件 Qt_install_folder/5.7/clang_64/mkspecs/features/mac/default_pre.prf 并注释如下内容:

# Make sure Xcode is set up properly
#isEmpty($$list($$system("/usr/bin/xcrun -find xcrun 2>/dev/null"))): \
    #error("Xcode not set up properly. You may need to confirm the license agreement by running /usr/bin/xcodebuild.")

这种方法是最后的手段,仅在其他所有方法均无效时使用。

以上就是解决“Project ERROR: Xcode not set up properly”错误的几种方法。希望对你有所帮助!如果你有其他更好的解决方法,欢迎在评论区分享。

总结

在macOS上使用Qt Creator开发时,可能会由于Xcode配置问题遇到各种错误。通过配置xcode-select,修改Qt配置文件或者重置Command Line Tools的位置,大多数情况下可以解决这些问题。如果问题依然存在,可以尝试直接注释相关检查步骤。

06-25 10:39