最近我在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
虽然这种方法简单,但它可能会在后续操作中引发其他问题,因为xcrun
和xcodebuild
不是完全相同的命令。
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的位置,大多数情况下可以解决这些问题。如果问题依然存在,可以尝试直接注释相关检查步骤。