/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of Qt Creator. ** ** Commercial License Usage ** Licensees holding valid commercial Qt licenses may use this file in ** accordance with the commercial license agreement provided with the ** Software or, alternatively, in accordance with the terms contained in ** a written agreement between you and The Qt Company. For licensing terms ** and conditions see https://www.qt.io/terms-conditions. For further ** information use the contact form at https://www.qt.io/contact-us. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU ** General Public License version 3 as published by the Free Software ** Foundation with exceptions as appearing in the file LICENSE.GPL3-EXCEPT ** included in the packaging of this file. Please review the following ** information to ensure the GNU General Public License requirements will ** be met: https://www.gnu.org/licenses/gpl-3.0.html. ** ****************************************************************************/ #include "cmaketool.h" #include "cmaketoolmanager.h" #include #include #include #include #include #include #include #include #include #include #include using namespace Utils; namespace CMakeProjectManager { const char CMAKE_INFORMATION_ID[] = "Id"; const char CMAKE_INFORMATION_COMMAND[] = "Binary"; const char CMAKE_INFORMATION_DISPLAYNAME[] = "DisplayName"; const char CMAKE_INFORMATION_AUTORUN[] = "AutoRun"; const char CMAKE_INFORMATION_QCH_FILE_PATH[] = "QchFile"; const char CMAKE_INFORMATION_AUTO_CREATE_BUILD_DIRECTORY[] = "AutoCreateBuildDirectory"; const char CMAKE_INFORMATION_AUTODETECTED[] = "AutoDetected"; const char CMAKE_INFORMATION_READERTYPE[] = "ReaderType"; bool CMakeTool::Generator::matches(const QString &n, const QString &ex) const { return n == name && (ex.isEmpty() || extraGenerators.contains(ex)); } namespace Internal { const char READER_TYPE_FILEAPI[] = "fileapi"; static Utils::optional readerTypeFromString(const QString &input) { // Do not try to be clever here, just use whatever is in the string! if (input == READER_TYPE_FILEAPI) return CMakeTool::FileApi; return {}; } static QString readerTypeToString(const CMakeTool::ReaderType &type) { switch (type) { case CMakeTool::FileApi: return QString(READER_TYPE_FILEAPI); default: return QString(); } } // -------------------------------------------------------------------- // CMakeIntrospectionData: // -------------------------------------------------------------------- class FileApi { public: QString kind; std::pair version; }; class IntrospectionData { public: bool m_didAttemptToRun = false; bool m_didRun = true; QList m_generators; QMap m_functionArgs; QVector m_fileApis; QStringList m_variables; QStringList m_functions; CMakeTool::Version m_version; }; } // namespace Internal /////////////////////////// // CMakeTool /////////////////////////// CMakeTool::CMakeTool(Detection d, const Id &id) : m_id(id) , m_isAutoDetected(d == AutoDetection) , m_introspection(std::make_unique()) { QTC_ASSERT(m_id.isValid(), m_id = Id::fromString(QUuid::createUuid().toString())); } CMakeTool::CMakeTool(const QVariantMap &map, bool fromSdk) : CMakeTool(fromSdk ? CMakeTool::AutoDetection : CMakeTool::ManualDetection, Id::fromSetting(map.value(CMAKE_INFORMATION_ID))) { m_displayName = map.value(CMAKE_INFORMATION_DISPLAYNAME).toString(); m_isAutoRun = map.value(CMAKE_INFORMATION_AUTORUN, true).toBool(); m_autoCreateBuildDirectory = map.value(CMAKE_INFORMATION_AUTO_CREATE_BUILD_DIRECTORY, false).toBool(); m_readerType = Internal::readerTypeFromString( map.value(CMAKE_INFORMATION_READERTYPE).toString()); //loading a CMakeTool from SDK is always autodetection if (!fromSdk) m_isAutoDetected = map.value(CMAKE_INFORMATION_AUTODETECTED, false).toBool(); setFilePath(FilePath::fromString(map.value(CMAKE_INFORMATION_COMMAND).toString())); m_qchFilePath = FilePath::fromVariant(map.value(CMAKE_INFORMATION_QCH_FILE_PATH)); if (m_qchFilePath.isEmpty()) m_qchFilePath = searchQchFile(m_executable); } CMakeTool::~CMakeTool() = default; Id CMakeTool::createId() { return Id::fromString(QUuid::createUuid().toString()); } void CMakeTool::setFilePath(const FilePath &executable) { if (m_executable == executable) return; m_introspection = std::make_unique(); m_executable = executable; CMakeToolManager::notifyAboutUpdate(this); } FilePath CMakeTool::filePath() const { return m_executable; } void CMakeTool::setAutorun(bool autoRun) { if (m_isAutoRun == autoRun) return; m_isAutoRun = autoRun; CMakeToolManager::notifyAboutUpdate(this); } void CMakeTool::setAutoCreateBuildDirectory(bool autoBuildDir) { if (m_autoCreateBuildDirectory == autoBuildDir) return; m_autoCreateBuildDirectory = autoBuildDir; CMakeToolManager::notifyAboutUpdate(this); } bool CMakeTool::isValid() const { if (!m_id.isValid() || !m_introspection) return false; if (!m_introspection->m_didAttemptToRun) readInformation(); return m_introspection->m_didRun && !m_introspection->m_fileApis.isEmpty(); } void CMakeTool::runCMake(SynchronousProcess &cmake, const QStringList &args, int timeoutS) const { cmake.setTimeoutS(timeoutS); cmake.setDisableUnixTerminal(); Environment env = Environment::systemEnvironment(); env.setupEnglishOutput(); cmake.setEnvironment(env); cmake.setTimeOutMessageBoxEnabled(false); cmake.setCommand({cmakeExecutable(), args}); cmake.runBlocking(); } QVariantMap CMakeTool::toMap() const { QVariantMap data; data.insert(CMAKE_INFORMATION_DISPLAYNAME, m_displayName); data.insert(CMAKE_INFORMATION_ID, m_id.toSetting()); data.insert(CMAKE_INFORMATION_COMMAND, m_executable.toString()); data.insert(CMAKE_INFORMATION_QCH_FILE_PATH, m_qchFilePath.toString()); data.insert(CMAKE_INFORMATION_AUTORUN, m_isAutoRun); data.insert(CMAKE_INFORMATION_AUTO_CREATE_BUILD_DIRECTORY, m_autoCreateBuildDirectory); if (m_readerType) data.insert(CMAKE_INFORMATION_READERTYPE, Internal::readerTypeToString(m_readerType.value())); data.insert(CMAKE_INFORMATION_AUTODETECTED, m_isAutoDetected); return data; } FilePath CMakeTool::cmakeExecutable() const { return cmakeExecutable(m_executable); } void CMakeTool::setQchFilePath(const FilePath &path) { m_qchFilePath = path; } FilePath CMakeTool::qchFilePath() const { return m_qchFilePath; } FilePath CMakeTool::cmakeExecutable(const FilePath &path) { if (HostOsInfo::isMacHost()) { const QString executableString = path.toString(); const int appIndex = executableString.lastIndexOf(".app"); const int appCutIndex = appIndex + 4; const bool endsWithApp = appIndex >= 0 && appCutIndex >= executableString.size(); const bool containsApp = appIndex >= 0 && !endsWithApp && executableString.at(appCutIndex) == '/'; if (endsWithApp || containsApp) { const FilePath toTest = FilePath::fromString(executableString.left(appCutIndex)) .pathAppended("Contents/bin/cmake"); if (toTest.exists()) return toTest.canonicalPath(); } } const FilePath resolvedPath = path.canonicalPath(); // Evil hack to make snap-packages of CMake work. See QTCREATORBUG-23376 if (HostOsInfo::isLinuxHost() && resolvedPath.fileName() == "snap") return path; return resolvedPath; } bool CMakeTool::isAutoRun() const { return m_isAutoRun; } bool CMakeTool::autoCreateBuildDirectory() const { return m_autoCreateBuildDirectory; } QList CMakeTool::supportedGenerators() const { return isValid() ? m_introspection->m_generators : QList(); } TextEditor::Keywords CMakeTool::keywords() { if (!isValid()) return {}; if (m_introspection->m_functions.isEmpty() && m_introspection->m_didRun) { SynchronousProcess proc; runCMake(proc, {"--help-command-list"}, 5); if (proc.result() == QtcProcess::Finished) m_introspection->m_functions = proc.stdOut().split('\n'); runCMake(proc, {"--help-commands"}, 5); if (proc.result() == QtcProcess::Finished) parseFunctionDetailsOutput(proc.stdOut()); runCMake(proc, {"--help-property-list"}, 5); if (proc.result() == QtcProcess::Finished) m_introspection->m_variables = parseVariableOutput(proc.stdOut()); runCMake(proc, {"--help-variable-list"}, 5); if (proc.result() == QtcProcess::Finished) { m_introspection->m_variables.append(parseVariableOutput(proc.stdOut())); m_introspection->m_variables = Utils::filteredUnique(m_introspection->m_variables); Utils::sort(m_introspection->m_variables); } } return TextEditor::Keywords(m_introspection->m_variables, m_introspection->m_functions, m_introspection->m_functionArgs); } bool CMakeTool::hasFileApi() const { return isValid() ? !m_introspection->m_fileApis.isEmpty() : false; } CMakeTool::Version CMakeTool::version() const { return m_introspection ? m_introspection->m_version : CMakeTool::Version(); } bool CMakeTool::isAutoDetected() const { return m_isAutoDetected; } QString CMakeTool::displayName() const { return m_displayName; } void CMakeTool::setDisplayName(const QString &displayName) { m_displayName = displayName; CMakeToolManager::notifyAboutUpdate(this); } void CMakeTool::setPathMapper(const CMakeTool::PathMapper &pathMapper) { m_pathMapper = pathMapper; } CMakeTool::PathMapper CMakeTool::pathMapper() const { if (m_pathMapper) return m_pathMapper; return [](const FilePath &fn) { return fn; }; } Utils::optional CMakeTool::readerType() const { if (m_readerType) return m_readerType; // Allow overriding the auto-detected value via .user files // Find best possible reader type: if (hasFileApi()) return FileApi; return {}; } FilePath CMakeTool::searchQchFile(const FilePath &executable) { if (executable.isEmpty()) return {}; FilePath prefixDir = executable.parentDir().parentDir(); QDir docDir{prefixDir.pathAppended("doc/cmake").toString()}; if (!docDir.exists()) docDir.setPath(prefixDir.pathAppended("share/doc/cmake").toString()); if (!docDir.exists()) return {}; const QStringList files = docDir.entryList(QStringList("*.qch")); for (const QString &docFile : files) { if (docFile.startsWith("cmake", Qt::CaseInsensitive)) { return FilePath::fromString(docDir.absoluteFilePath(docFile)); } } return {}; } void CMakeTool::readInformation() const { QTC_ASSERT(m_introspection, return ); if (!m_introspection->m_didRun && m_introspection->m_didAttemptToRun) return; m_introspection->m_didAttemptToRun = true; fetchFromCapabilities(); } static QStringList parseDefinition(const QString &definition) { QStringList result; QString word; bool ignoreWord = false; QVector braceStack; foreach (const QChar &c, definition) { if (c == '[' || c == '<' || c == '(') { braceStack.append(c); ignoreWord = false; } else if (c == ']' || c == '>' || c == ')') { if (braceStack.isEmpty() || braceStack.takeLast() == '<') ignoreWord = true; } if (c == ' ' || c == '[' || c == '<' || c == '(' || c == ']' || c == '>' || c == ')') { if (!ignoreWord && !word.isEmpty()) { if (result.isEmpty() || Utils::allOf(word, [](const QChar &c) { return c.isUpper() || c == '_'; })) result.append(word); } word.clear(); ignoreWord = false; } else { word.append(c); } } return result; } void CMakeTool::parseFunctionDetailsOutput(const QString &output) { const QSet functionSet = Utils::toSet(m_introspection->m_functions); bool expectDefinition = false; QString currentDefinition; const QStringList lines = output.split('\n'); for (int i = 0; i < lines.count(); ++i) { const QString line = lines.at(i); if (line == "::") { expectDefinition = true; continue; } if (expectDefinition) { if (!line.startsWith(' ') && !line.isEmpty()) { expectDefinition = false; QStringList words = parseDefinition(currentDefinition); if (!words.isEmpty()) { const QString command = words.takeFirst(); if (functionSet.contains(command)) { QStringList tmp = words + m_introspection->m_functionArgs[command]; Utils::sort(tmp); m_introspection->m_functionArgs[command] = Utils::filteredUnique(tmp); } } if (!words.isEmpty() && functionSet.contains(words.at(0))) m_introspection->m_functionArgs[words.at(0)]; currentDefinition.clear(); } else { currentDefinition.append(line.trimmed() + ' '); } } } } QStringList CMakeTool::parseVariableOutput(const QString &output) { const QStringList variableList = output.split('\n'); QStringList result; foreach (const QString &v, variableList) { if (v.startsWith("CMAKE_COMPILER_IS_GNU")) { // This key takes a compiler name :-/ result << "CMAKE_COMPILER_IS_GNUCC" << "CMAKE_COMPILER_IS_GNUCXX"; } else if (v.contains("")) { const QString tmp = QString(v).replace("", "%1"); result << tmp.arg("DEBUG") << tmp.arg("RELEASE") << tmp.arg("MINSIZEREL") << tmp.arg("RELWITHDEBINFO"); } else if (v.contains("")) { const QString tmp = QString(v).replace("", "%1"); result << tmp.arg("C") << tmp.arg("CXX"); } else if (!v.contains('<') && !v.contains('[')) { result << v; } } return result; } void CMakeTool::fetchFromCapabilities() const { SynchronousProcess cmake; runCMake(cmake, {"-E", "capabilities"}); if (cmake.result() == QtcProcess::Finished) { m_introspection->m_didRun = true; parseFromCapabilities(cmake.stdOut()); } else { m_introspection->m_didRun = false; } } static int getVersion(const QVariantMap &obj, const QString value) { bool ok; int result = obj.value(value).toInt(&ok); if (!ok) return -1; return result; } void CMakeTool::parseFromCapabilities(const QString &input) const { auto doc = QJsonDocument::fromJson(input.toUtf8()); if (!doc.isObject()) return; const QVariantMap data = doc.object().toVariantMap(); const QVariantList generatorList = data.value("generators").toList(); for (const QVariant &v : generatorList) { const QVariantMap gen = v.toMap(); m_introspection->m_generators.append(Generator(gen.value("name").toString(), gen.value("extraGenerators").toStringList(), gen.value("platformSupport").toBool(), gen.value("toolsetSupport").toBool())); } { const QVariantMap fileApis = data.value("fileApi").toMap(); const QVariantList requests = fileApis.value("requests").toList(); for (const QVariant &r : requests) { const QVariantMap object = r.toMap(); const QString kind = object.value("kind").toString(); const QVariantList versionList = object.value("version").toList(); std::pair highestVersion = std::make_pair(-1, -1); for (const QVariant &v : versionList) { const QVariantMap versionObject = v.toMap(); const std::pair version = std::make_pair(getVersion(versionObject, "major"), getVersion(versionObject, "minor")); if (version.first > highestVersion.first || (version.first == highestVersion.first && version.second > highestVersion.second)) highestVersion = version; } if (!kind.isNull() && highestVersion.first != -1 && highestVersion.second != -1) m_introspection->m_fileApis.append({kind, highestVersion}); } } const QVariantMap versionInfo = data.value("version").toMap(); m_introspection->m_version.major = versionInfo.value("major").toInt(); m_introspection->m_version.minor = versionInfo.value("minor").toInt(); m_introspection->m_version.patch = versionInfo.value("patch").toInt(); m_introspection->m_version.fullVersion = versionInfo.value("string").toByteArray(); // Fix up fileapi support for cmake 3.14: if (m_introspection->m_version.major == 3 && m_introspection->m_version.minor == 14) { m_introspection->m_fileApis.append({QString("codemodel"), std::make_pair(2, 0)}); m_introspection->m_fileApis.append({QString("cache"), std::make_pair(2, 0)}); m_introspection->m_fileApis.append({QString("cmakefiles"), std::make_pair(1, 0)}); } } } // namespace CMakeProjectManager