/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying file Copyright.txt or https://cmake.org/licensing for details. */ #include "cmTarget.h" #include #include #include #include #include #include #include #include #include #include #include #include "cmsys/RegularExpression.hxx" #include "cmAlgorithms.h" #include "cmCustomCommand.h" #include "cmGeneratorExpression.h" #include "cmGeneratorTarget.h" #include "cmGlobalGenerator.h" #include "cmListFileCache.h" #include "cmMakefile.h" #include "cmMessageType.h" #include "cmMessenger.h" #include "cmProperty.h" #include "cmPropertyMap.h" #include "cmRange.h" #include "cmSourceFile.h" #include "cmSourceFileLocation.h" #include "cmSourceFileLocationKind.h" #include "cmState.h" #include "cmStateDirectory.h" #include "cmStateSnapshot.h" #include "cmSystemTools.h" #include "cmTargetPropertyComputer.h" #include "cmake.h" template <> const std::string& cmTargetPropertyComputer::ComputeLocationForBuild( cmTarget const* tgt) { static std::string loc; if (tgt->IsImported()) { loc = tgt->ImportedGetFullPath("", cmStateEnums::RuntimeBinaryArtifact); return loc; } cmGlobalGenerator* gg = tgt->GetGlobalGenerator(); if (!gg->GetConfigureDoneCMP0026()) { gg->CreateGenerationObjects(); } cmGeneratorTarget* gt = gg->FindGeneratorTarget(tgt->GetName()); loc = gt->GetLocationForBuild(); return loc; } template <> const std::string& cmTargetPropertyComputer::ComputeLocation( cmTarget const* tgt, const std::string& config) { static std::string loc; if (tgt->IsImported()) { loc = tgt->ImportedGetFullPath(config, cmStateEnums::RuntimeBinaryArtifact); return loc; } cmGlobalGenerator* gg = tgt->GetGlobalGenerator(); if (!gg->GetConfigureDoneCMP0026()) { gg->CreateGenerationObjects(); } cmGeneratorTarget* gt = gg->FindGeneratorTarget(tgt->GetName()); loc = gt->GetFullPath(config, cmStateEnums::RuntimeBinaryArtifact); return loc; } template <> cmProp cmTargetPropertyComputer::GetSources( cmTarget const* tgt, cmMessenger* messenger, cmListFileBacktrace const& context) { cmStringRange entries = tgt->GetSourceEntries(); if (entries.empty()) { return nullptr; } std::ostringstream ss; const char* sep = ""; for (std::string const& entry : entries) { std::vector files = cmExpandedList(entry); for (std::string const& file : files) { if (cmHasLiteralPrefix(file, "$') { std::string objLibName = file.substr(17, file.size() - 18); if (cmGeneratorExpression::Find(objLibName) != std::string::npos) { ss << sep; sep = ";"; ss << file; continue; } bool addContent = false; bool noMessage = true; std::ostringstream e; MessageType messageType = MessageType::AUTHOR_WARNING; switch (context.GetBottom().GetPolicy(cmPolicies::CMP0051)) { case cmPolicies::WARN: e << cmPolicies::GetPolicyWarning(cmPolicies::CMP0051) << "\n"; noMessage = false; case cmPolicies::OLD: break; case cmPolicies::REQUIRED_ALWAYS: case cmPolicies::REQUIRED_IF_USED: case cmPolicies::NEW: addContent = true; } if (!noMessage) { e << "Target \"" << tgt->GetName() << "\" contains $ generator expression in its " "sources list. This content was not previously part of the " "SOURCES property when that property was read at configure " "time. Code reading that property needs to be adapted to " "ignore the generator expression using the string(GENEX_STRIP) " "command."; messenger->IssueMessage(messageType, e.str(), context); } if (addContent) { ss << sep; sep = ";"; ss << file; } } else if (cmGeneratorExpression::Find(file) == std::string::npos) { ss << sep; sep = ";"; ss << file; } else { cmSourceFile* sf = tgt->GetMakefile()->GetOrCreateSource(file); // Construct what is known about this source file location. cmSourceFileLocation const& location = sf->GetLocation(); std::string sname = location.GetDirectory(); if (!sname.empty()) { sname += "/"; } sname += location.GetName(); ss << sep; sep = ";"; // Append this list entry. ss << sname; } } } static std::string srcs; srcs = ss.str(); return &srcs; } class cmTargetInternals { public: cmStateEnums::TargetType TargetType; cmMakefile* Makefile; cmPolicies::PolicyMap PolicyMap; std::string Name; std::string InstallPath; std::string RuntimeInstallPath; cmPropertyMap Properties; bool IsGeneratorProvided; bool HaveInstallRule; bool IsDLLPlatform; bool IsAIX; bool IsAndroid; bool IsImportedTarget; bool ImportedGloballyVisible; bool BuildInterfaceIncludesAppended; bool PerConfig; std::set>> Utilities; std::vector PreBuildCommands; std::vector PreLinkCommands; std::vector PostBuildCommands; std::vector InstallGenerators; std::set SystemIncludeDirectories; cmTarget::LinkLibraryVectorType OriginalLinkLibraries; std::map> LanguageStandardProperties; std::vector IncludeDirectoriesEntries; std::vector IncludeDirectoriesBacktraces; std::vector CompileOptionsEntries; std::vector CompileOptionsBacktraces; std::vector CompileFeaturesEntries; std::vector CompileFeaturesBacktraces; std::vector CompileDefinitionsEntries; std::vector CompileDefinitionsBacktraces; std::vector PrecompileHeadersEntries; std::vector PrecompileHeadersBacktraces; std::vector SourceEntries; std::vector SourceBacktraces; std::vector LinkOptionsEntries; std::vector LinkOptionsBacktraces; std::vector LinkDirectoriesEntries; std::vector LinkDirectoriesBacktraces; std::vector LinkImplementationPropertyEntries; std::vector LinkImplementationPropertyBacktraces; std::vector> TLLCommands; cmListFileBacktrace Backtrace; public: bool CheckImportedLibName(std::string const& prop, std::string const& value) const; std::string ProcessSourceItemCMP0049(const std::string& s) const; }; namespace { #define SETUP_COMMON_LANGUAGE_PROPERTIES(lang) \ initProp(#lang "_COMPILER_LAUNCHER"); \ initProp(#lang "_STANDARD"); \ initProp(#lang "_STANDARD_REQUIRED"); \ initProp(#lang "_EXTENSIONS"); \ initProp(#lang "_VISIBILITY_PRESET") } cmTarget::cmTarget(std::string const& name, cmStateEnums::TargetType type, Visibility vis, cmMakefile* mf, PerConfig perConfig) : impl(cm::make_unique()) { assert(mf); impl->TargetType = type; impl->Makefile = mf; impl->Name = name; impl->IsGeneratorProvided = false; impl->HaveInstallRule = false; impl->IsDLLPlatform = false; impl->IsAIX = false; impl->IsAndroid = false; impl->IsImportedTarget = (vis == VisibilityImported || vis == VisibilityImportedGlobally); impl->ImportedGloballyVisible = vis == VisibilityImportedGlobally; impl->BuildInterfaceIncludesAppended = false; impl->PerConfig = (perConfig == PerConfig::Yes); // Check whether this is a DLL platform. impl->IsDLLPlatform = !impl->Makefile->GetSafeDefinition("CMAKE_IMPORT_LIBRARY_SUFFIX").empty(); // Check whether we are targeting AIX. { std::string const& systemName = impl->Makefile->GetSafeDefinition("CMAKE_SYSTEM_NAME"); impl->IsAIX = (systemName == "AIX" || systemName == "OS400"); } // Check whether we are targeting an Android platform. impl->IsAndroid = (impl->Makefile->GetSafeDefinition("CMAKE_SYSTEM_NAME") == "Android"); std::string defKey; defKey.reserve(128); defKey += "CMAKE_"; auto initProp = [this, mf, &defKey](const std::string& property) { // Replace everything after "CMAKE_" defKey.replace(defKey.begin() + 6, defKey.end(), property); if (cmProp value = mf->GetDefinition(defKey)) { this->SetProperty(property, *value); } }; auto initPropValue = [this, mf, &defKey](const std::string& property, const char* default_value) { // Replace everything after "CMAKE_" defKey.replace(defKey.begin() + 6, defKey.end(), property); if (cmProp value = mf->GetDefinition(defKey)) { this->SetProperty(property, *value); } else if (default_value) { this->SetProperty(property, default_value); } }; // Setup default property values. if (this->CanCompileSources()) { SETUP_COMMON_LANGUAGE_PROPERTIES(C); SETUP_COMMON_LANGUAGE_PROPERTIES(OBJC); SETUP_COMMON_LANGUAGE_PROPERTIES(CXX); SETUP_COMMON_LANGUAGE_PROPERTIES(OBJCXX); SETUP_COMMON_LANGUAGE_PROPERTIES(CUDA); initProp("ANDROID_API"); initProp("ANDROID_API_MIN"); initProp("ANDROID_ARCH"); initProp("ANDROID_STL_TYPE"); initProp("ANDROID_SKIP_ANT_STEP"); initProp("ANDROID_PROCESS_MAX"); initProp("ANDROID_PROGUARD"); initProp("ANDROID_PROGUARD_CONFIG_PATH"); initProp("ANDROID_SECURE_PROPS_PATH"); initProp("ANDROID_NATIVE_LIB_DIRECTORIES"); initProp("ANDROID_NATIVE_LIB_DEPENDENCIES"); initProp("ANDROID_JAVA_SOURCE_DIR"); initProp("ANDROID_JAR_DIRECTORIES"); initProp("ANDROID_JAR_DEPENDENCIES"); initProp("ANDROID_ASSETS_DIRECTORIES"); initProp("ANDROID_ANT_ADDITIONAL_OPTIONS"); initProp("BUILD_RPATH"); initProp("BUILD_RPATH_USE_ORIGIN"); initProp("INSTALL_NAME_DIR"); initProp("INSTALL_REMOVE_ENVIRONMENT_RPATH"); initPropValue("INSTALL_RPATH", ""); initPropValue("INSTALL_RPATH_USE_LINK_PATH", "OFF"); initProp("INTERPROCEDURAL_OPTIMIZATION"); initPropValue("SKIP_BUILD_RPATH", "OFF"); initPropValue("BUILD_WITH_INSTALL_RPATH", "OFF"); initProp("ARCHIVE_OUTPUT_DIRECTORY"); initProp("LIBRARY_OUTPUT_DIRECTORY"); initProp("RUNTIME_OUTPUT_DIRECTORY"); initProp("PDB_OUTPUT_DIRECTORY"); initProp("COMPILE_PDB_OUTPUT_DIRECTORY"); initProp("FRAMEWORK"); initProp("FRAMEWORK_MULTI_CONFIG_POSTFIX"); initProp("Fortran_FORMAT"); initProp("Fortran_MODULE_DIRECTORY"); initProp("Fortran_COMPILER_LAUNCHER"); initProp("Fortran_PREPROCESS"); initProp("Fortran_VISIBILITY_PRESET"); initProp("GNUtoMS"); initProp("OSX_ARCHITECTURES"); initProp("IOS_INSTALL_COMBINED"); initProp("AUTOMOC"); initProp("AUTOUIC"); initProp("AUTORCC"); initProp("AUTOGEN_ORIGIN_DEPENDS"); initProp("AUTOGEN_PARALLEL"); initProp("AUTOMOC_COMPILER_PREDEFINES"); initProp("AUTOMOC_DEPEND_FILTERS"); initProp("AUTOMOC_MACRO_NAMES"); initProp("AUTOMOC_MOC_OPTIONS"); initProp("AUTOUIC_OPTIONS"); initProp("AUTOMOC_PATH_PREFIX"); initProp("AUTOUIC_SEARCH_PATHS"); initProp("AUTORCC_OPTIONS"); initProp("LINK_DEPENDS_NO_SHARED"); initProp("LINK_INTERFACE_LIBRARIES"); initProp("MSVC_RUNTIME_LIBRARY"); initProp("WIN32_EXECUTABLE"); initProp("MACOSX_BUNDLE"); initProp("MACOSX_RPATH"); initProp("NO_SYSTEM_FROM_IMPORTED"); initProp("BUILD_WITH_INSTALL_NAME_DIR"); initProp("C_CLANG_TIDY"); initProp("C_CPPLINT"); initProp("C_CPPCHECK"); initProp("C_INCLUDE_WHAT_YOU_USE"); initProp("LINK_WHAT_YOU_USE"); initProp("CXX_CLANG_TIDY"); initProp("CXX_CPPLINT"); initProp("CXX_CPPCHECK"); initProp("CXX_INCLUDE_WHAT_YOU_USE"); initProp("CUDA_SEPARABLE_COMPILATION"); initProp("CUDA_RESOLVE_DEVICE_SYMBOLS"); initProp("CUDA_RUNTIME_LIBRARY"); initProp("CUDA_ARCHITECTURES"); initProp("VISIBILITY_INLINES_HIDDEN"); initProp("JOB_POOL_COMPILE"); initProp("JOB_POOL_LINK"); initProp("JOB_POOL_PRECOMPILE_HEADER"); initProp("ISPC_COMPILER_LAUNCHER"); initProp("ISPC_HEADER_DIRECTORY"); initProp("ISPC_INSTRUCTION_SETS"); initProp("LINK_SEARCH_START_STATIC"); initProp("LINK_SEARCH_END_STATIC"); initProp("Swift_LANGUAGE_VERSION"); initProp("Swift_MODULE_DIRECTORY"); initProp("VS_JUST_MY_CODE_DEBUGGING"); initProp("DISABLE_PRECOMPILE_HEADERS"); initProp("UNITY_BUILD"); initProp("OPTIMIZE_DEPENDENCIES"); initPropValue("UNITY_BUILD_BATCH_SIZE", "8"); initPropValue("UNITY_BUILD_MODE", "BATCH"); initPropValue("PCH_WARN_INVALID", "ON"); initPropValue("PCH_INSTANTIATE_TEMPLATES", "ON"); #ifdef __APPLE__ if (this->GetGlobalGenerator()->IsXcode()) { initProp("XCODE_SCHEME_ADDRESS_SANITIZER"); initProp("XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN"); initProp("XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING"); initProp("XCODE_SCHEME_THREAD_SANITIZER"); initProp("XCODE_SCHEME_THREAD_SANITIZER_STOP"); initProp("XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER"); initProp("XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP"); initProp("XCODE_SCHEME_WORKING_DIRECTORY"); initProp("XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER"); initProp("XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP"); initProp("XCODE_SCHEME_MALLOC_SCRIBBLE"); initProp("XCODE_SCHEME_MALLOC_GUARD_EDGES"); initProp("XCODE_SCHEME_GUARD_MALLOC"); initProp("XCODE_SCHEME_ZOMBIE_OBJECTS"); initProp("XCODE_SCHEME_MALLOC_STACK"); initProp("XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE"); initProp("XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS"); initProp("XCODE_SCHEME_ENVIRONMENT"); initPropValue("XCODE_LINK_BUILD_PHASE_MODE", "NONE"); } #endif } initProp("FOLDER"); if (this->GetGlobalGenerator()->IsXcode()) { initProp("XCODE_GENERATE_SCHEME"); } // Setup per-configuration property default values. if (this->GetType() != cmStateEnums::UTILITY && this->GetType() != cmStateEnums::GLOBAL_TARGET) { static const auto configProps = { /* clang-format needs this comment to break after the opening brace */ "ARCHIVE_OUTPUT_DIRECTORY_", "LIBRARY_OUTPUT_DIRECTORY_", "RUNTIME_OUTPUT_DIRECTORY_", "PDB_OUTPUT_DIRECTORY_", "COMPILE_PDB_OUTPUT_DIRECTORY_", "MAP_IMPORTED_CONFIG_", "INTERPROCEDURAL_OPTIMIZATION_" }; // Collect the set of configuration types. std::vector configNames = mf->GetGeneratorConfigs(cmMakefile::ExcludeEmptyConfig); for (std::string const& configName : configNames) { std::string configUpper = cmSystemTools::UpperCase(configName); for (auto const& prop : configProps) { // Interface libraries have no output locations, so honor only // the configuration map. if (impl->TargetType == cmStateEnums::INTERFACE_LIBRARY && strcmp(prop, "MAP_IMPORTED_CONFIG_") != 0) { continue; } std::string property = cmStrCat(prop, configUpper); initProp(property); } // Initialize per-configuration name postfix property from the // variable only for non-executable targets. This preserves // compatibility with previous CMake versions in which executables // did not support this variable. Projects may still specify the // property directly. if (impl->TargetType != cmStateEnums::EXECUTABLE && impl->TargetType != cmStateEnums::INTERFACE_LIBRARY) { std::string property = cmStrCat(cmSystemTools::UpperCase(configName), "_POSTFIX"); initProp(property); } if (impl->TargetType == cmStateEnums::SHARED_LIBRARY || impl->TargetType == cmStateEnums::STATIC_LIBRARY) { std::string property = cmStrCat("FRAMEWORK_MULTI_CONFIG_POSTFIX_", cmSystemTools::UpperCase(configName)); initProp(property); } } } // Save the backtrace of target construction. impl->Backtrace = impl->Makefile->GetBacktrace(); if (!this->IsImported()) { // Initialize the INCLUDE_DIRECTORIES property based on the current value // of the same directory property: cm::append(impl->IncludeDirectoriesEntries, impl->Makefile->GetIncludeDirectoriesEntries()); cm::append(impl->IncludeDirectoriesBacktraces, impl->Makefile->GetIncludeDirectoriesBacktraces()); { auto const& sysInc = impl->Makefile->GetSystemIncludeDirectories(); impl->SystemIncludeDirectories.insert(sysInc.begin(), sysInc.end()); } cm::append(impl->CompileOptionsEntries, impl->Makefile->GetCompileOptionsEntries()); cm::append(impl->CompileOptionsBacktraces, impl->Makefile->GetCompileOptionsBacktraces()); cm::append(impl->LinkOptionsEntries, impl->Makefile->GetLinkOptionsEntries()); cm::append(impl->LinkOptionsBacktraces, impl->Makefile->GetLinkOptionsBacktraces()); cm::append(impl->LinkDirectoriesEntries, impl->Makefile->GetLinkDirectoriesEntries()); cm::append(impl->LinkDirectoriesBacktraces, impl->Makefile->GetLinkDirectoriesBacktraces()); } if (impl->TargetType == cmStateEnums::EXECUTABLE) { initProp("ANDROID_GUI"); initProp("CROSSCOMPILING_EMULATOR"); initProp("ENABLE_EXPORTS"); } if (impl->TargetType == cmStateEnums::SHARED_LIBRARY || impl->TargetType == cmStateEnums::MODULE_LIBRARY) { this->SetProperty("POSITION_INDEPENDENT_CODE", "True"); } else if (this->CanCompileSources()) { initProp("POSITION_INDEPENDENT_CODE"); } if (impl->TargetType == cmStateEnums::SHARED_LIBRARY || impl->TargetType == cmStateEnums::EXECUTABLE) { initProp("AIX_EXPORT_ALL_SYMBOLS"); initProp("WINDOWS_EXPORT_ALL_SYMBOLS"); } // Record current policies for later use. impl->Makefile->RecordPolicies(impl->PolicyMap); if (impl->TargetType == cmStateEnums::INTERFACE_LIBRARY) { // This policy is checked in a few conditions. The properties relevant // to the policy are always ignored for cmStateEnums::INTERFACE_LIBRARY // targets, // so ensure that the conditions don't lead to nonsense. impl->PolicyMap.Set(cmPolicies::CMP0022, cmPolicies::NEW); } if (impl->TargetType <= cmStateEnums::GLOBAL_TARGET) { initProp("DOTNET_TARGET_FRAMEWORK"); initProp("DOTNET_TARGET_FRAMEWORK_VERSION"); } // check for "CMAKE_VS_GLOBALS" variable and set up target properties // if any cmProp globals = mf->GetDefinition("CMAKE_VS_GLOBALS"); if (globals) { const std::string genName = mf->GetGlobalGenerator()->GetName(); if (cmHasLiteralPrefix(genName, "Visual Studio")) { std::vector props = cmExpandedList(*globals); const std::string vsGlobal = "VS_GLOBAL_"; for (const std::string& i : props) { // split NAME=VALUE const std::string::size_type assignment = i.find('='); if (assignment != std::string::npos) { const std::string propName = vsGlobal + i.substr(0, assignment); const std::string propValue = i.substr(assignment + 1); initPropValue(propName, propValue.c_str()); } } } } } cmTarget::cmTarget(cmTarget&&) noexcept = default; cmTarget::~cmTarget() = default; cmTarget& cmTarget::operator=(cmTarget&&) noexcept = default; cmStateEnums::TargetType cmTarget::GetType() const { return impl->TargetType; } cmMakefile* cmTarget::GetMakefile() const { return impl->Makefile; } cmPolicies::PolicyMap const& cmTarget::GetPolicyMap() const { return impl->PolicyMap; } const std::string& cmTarget::GetName() const { return impl->Name; } cmPolicies::PolicyStatus cmTarget::GetPolicyStatus( cmPolicies::PolicyID policy) const { return impl->PolicyMap.Get(policy); } cmGlobalGenerator* cmTarget::GetGlobalGenerator() const { return impl->Makefile->GetGlobalGenerator(); } BTs const* cmTarget::GetLanguageStandardProperty( const std::string& propertyName) const { auto entry = impl->LanguageStandardProperties.find(propertyName); if (entry != impl->LanguageStandardProperties.end()) { return &entry->second; } return nullptr; } void cmTarget::SetLanguageStandardProperty(std::string const& lang, std::string const& value, const std::string& feature) { cmListFileBacktrace featureBacktrace; for (size_t i = 0; i < impl->CompileFeaturesEntries.size(); i++) { if (impl->CompileFeaturesEntries[i] == feature) { if (i < impl->CompileFeaturesBacktraces.size()) { featureBacktrace = impl->CompileFeaturesBacktraces[i]; } break; } } BTs& languageStandardProperty = impl->LanguageStandardProperties[cmStrCat(lang, "_STANDARD")]; if (languageStandardProperty.Value != value) { languageStandardProperty.Value = value; languageStandardProperty.Backtraces.clear(); } languageStandardProperty.Backtraces.emplace_back(featureBacktrace); } void cmTarget::AddUtility(std::string const& name, bool cross, cmMakefile* mf) { impl->Utilities.insert(BT>( { name, cross }, mf ? mf->GetBacktrace() : cmListFileBacktrace())); } std::set>> const& cmTarget::GetUtilities() const { return impl->Utilities; } cmListFileBacktrace const& cmTarget::GetBacktrace() const { return impl->Backtrace; } bool cmTarget::IsExecutableWithExports() const { return (this->GetType() == cmStateEnums::EXECUTABLE && this->GetPropertyAsBool("ENABLE_EXPORTS")); } bool cmTarget::IsFrameworkOnApple() const { return ((this->GetType() == cmStateEnums::SHARED_LIBRARY || this->GetType() == cmStateEnums::STATIC_LIBRARY) && impl->Makefile->IsOn("APPLE") && this->GetPropertyAsBool("FRAMEWORK")); } bool cmTarget::IsAppBundleOnApple() const { return (this->GetType() == cmStateEnums::EXECUTABLE && impl->Makefile->IsOn("APPLE") && this->GetPropertyAsBool("MACOSX_BUNDLE")); } bool cmTarget::IsAndroidGuiExecutable() const { return (this->GetType() == cmStateEnums::EXECUTABLE && impl->IsAndroid && this->GetPropertyAsBool("ANDROID_GUI")); } std::vector const& cmTarget::GetPreBuildCommands() const { return impl->PreBuildCommands; } void cmTarget::AddPreBuildCommand(cmCustomCommand const& cmd) { impl->PreBuildCommands.push_back(cmd); } void cmTarget::AddPreBuildCommand(cmCustomCommand&& cmd) { impl->PreBuildCommands.push_back(std::move(cmd)); } std::vector const& cmTarget::GetPreLinkCommands() const { return impl->PreLinkCommands; } void cmTarget::AddPreLinkCommand(cmCustomCommand const& cmd) { impl->PreLinkCommands.push_back(cmd); } void cmTarget::AddPreLinkCommand(cmCustomCommand&& cmd) { impl->PreLinkCommands.push_back(std::move(cmd)); } std::vector const& cmTarget::GetPostBuildCommands() const { return impl->PostBuildCommands; } void cmTarget::AddPostBuildCommand(cmCustomCommand const& cmd) { impl->PostBuildCommands.push_back(cmd); } void cmTarget::AddPostBuildCommand(cmCustomCommand&& cmd) { impl->PostBuildCommands.push_back(std::move(cmd)); } void cmTarget::AddTracedSources(std::vector const& srcs) { if (!srcs.empty()) { cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->SourceEntries.push_back(cmJoin(srcs, ";")); impl->SourceBacktraces.push_back(lfbt); } } void cmTarget::AddSources(std::vector const& srcs) { std::string srcFiles; const char* sep = ""; for (auto filename : srcs) { if (!cmGeneratorExpression::StartsWithGeneratorExpression(filename)) { if (!filename.empty()) { filename = impl->ProcessSourceItemCMP0049(filename); if (filename.empty()) { return; } } impl->Makefile->GetOrCreateSource(filename); } srcFiles += sep; srcFiles += filename; sep = ";"; } if (!srcFiles.empty()) { cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->SourceEntries.push_back(std::move(srcFiles)); impl->SourceBacktraces.push_back(lfbt); } } std::string cmTargetInternals::ProcessSourceItemCMP0049( const std::string& s) const { std::string src = s; // For backwards compatibility replace variables in source names. // This should eventually be removed. this->Makefile->ExpandVariablesInString(src); if (src != s) { std::ostringstream e; bool noMessage = false; MessageType messageType = MessageType::AUTHOR_WARNING; switch (this->Makefile->GetPolicyStatus(cmPolicies::CMP0049)) { case cmPolicies::WARN: e << cmPolicies::GetPolicyWarning(cmPolicies::CMP0049) << "\n"; break; case cmPolicies::OLD: noMessage = true; break; case cmPolicies::REQUIRED_ALWAYS: case cmPolicies::REQUIRED_IF_USED: case cmPolicies::NEW: messageType = MessageType::FATAL_ERROR; } if (!noMessage) { e << "Legacy variable expansion in source file \"" << s << "\" expanded to \"" << src << "\" in target \"" << this->Name << "\". This behavior will be removed in a " "future version of CMake."; this->Makefile->IssueMessage(messageType, e.str()); if (messageType == MessageType::FATAL_ERROR) { return ""; } } } return src; } std::string cmTarget::GetSourceCMP0049(const std::string& s) { return impl->ProcessSourceItemCMP0049(s); } struct CreateLocation { cmMakefile const* Makefile; CreateLocation(cmMakefile const* mf) : Makefile(mf) { } cmSourceFileLocation operator()(const std::string& filename) const { return cmSourceFileLocation(this->Makefile, filename); } }; struct LocationMatcher { const cmSourceFileLocation& Needle; LocationMatcher(const cmSourceFileLocation& needle) : Needle(needle) { } bool operator()(cmSourceFileLocation& loc) { return loc.Matches(this->Needle); } }; struct TargetPropertyEntryFinder { private: const cmSourceFileLocation& Needle; public: TargetPropertyEntryFinder(const cmSourceFileLocation& needle) : Needle(needle) { } bool operator()(std::string const& entry) { std::vector files = cmExpandedList(entry); std::vector locations; locations.reserve(files.size()); std::transform(files.begin(), files.end(), std::back_inserter(locations), CreateLocation(this->Needle.GetMakefile())); return std::find_if(locations.begin(), locations.end(), LocationMatcher(this->Needle)) != locations.end(); } }; cmSourceFile* cmTarget::AddSource(const std::string& src, bool before) { cmSourceFileLocation sfl(impl->Makefile, src, cmSourceFileLocationKind::Known); if (std::find_if(impl->SourceEntries.begin(), impl->SourceEntries.end(), TargetPropertyEntryFinder(sfl)) == impl->SourceEntries.end()) { cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->SourceEntries.insert( before ? impl->SourceEntries.begin() : impl->SourceEntries.end(), src); impl->SourceBacktraces.insert(before ? impl->SourceBacktraces.begin() : impl->SourceBacktraces.end(), lfbt); } if (cmGeneratorExpression::Find(src) != std::string::npos) { return nullptr; } return impl->Makefile->GetOrCreateSource(src, false, cmSourceFileLocationKind::Known); } void cmTarget::ClearDependencyInformation(cmMakefile& mf) const { std::string depname = cmStrCat(this->GetName(), "_LIB_DEPENDS"); mf.RemoveCacheDefinition(depname); } std::string cmTarget::GetDebugGeneratorExpressions( const std::string& value, cmTargetLinkLibraryType llt) const { if (llt == GENERAL_LibraryType) { return value; } // Get the list of configurations considered to be DEBUG. std::vector debugConfigs = impl->Makefile->GetCMakeInstance()->GetDebugConfigs(); std::string configString = "$"; if (debugConfigs.size() > 1) { for (std::string const& conf : cmMakeRange(debugConfigs).advance(1)) { configString += ",$"; } configString = "$"; } if (llt == OPTIMIZED_LibraryType) { configString = "$"; } return "$<" + configString + ":" + value + ">"; } static std::string targetNameGenex(const std::string& lib) { return "$"; } bool cmTarget::PushTLLCommandTrace(TLLSignature signature, cmListFileContext const& lfc) { bool ret = true; if (!impl->TLLCommands.empty()) { if (impl->TLLCommands.back().first != signature) { ret = false; } } if (impl->TLLCommands.empty() || impl->TLLCommands.back().second != lfc) { impl->TLLCommands.emplace_back(signature, lfc); } return ret; } void cmTarget::GetTllSignatureTraces(std::ostream& s, TLLSignature sig) const { const char* sigString = (sig == cmTarget::KeywordTLLSignature ? "keyword" : "plain"); s << "The uses of the " << sigString << " signature are here:\n"; cmStateDirectory cmDir = impl->Makefile->GetStateSnapshot().GetDirectory(); for (auto const& cmd : impl->TLLCommands) { if (cmd.first == sig) { cmListFileContext lfc = cmd.second; lfc.FilePath = cmDir.ConvertToRelPathIfNotContained( impl->Makefile->GetState()->GetSourceDirectory(), lfc.FilePath); s << " * " << lfc << '\n'; } } } std::string const& cmTarget::GetInstallPath() const { return impl->InstallPath; } void cmTarget::SetInstallPath(std::string const& name) { impl->InstallPath = name; } std::string const& cmTarget::GetRuntimeInstallPath() const { return impl->RuntimeInstallPath; } void cmTarget::SetRuntimeInstallPath(std::string const& name) { impl->RuntimeInstallPath = name; } bool cmTarget::GetHaveInstallRule() const { return impl->HaveInstallRule; } void cmTarget::SetHaveInstallRule(bool hir) { impl->HaveInstallRule = hir; } void cmTarget::AddInstallGenerator(cmInstallTargetGenerator* g) { impl->InstallGenerators.emplace_back(g); } std::vector const& cmTarget::GetInstallGenerators() const { return impl->InstallGenerators; } bool cmTarget::GetIsGeneratorProvided() const { return impl->IsGeneratorProvided; } void cmTarget::SetIsGeneratorProvided(bool igp) { impl->IsGeneratorProvided = igp; } cmTarget::LinkLibraryVectorType const& cmTarget::GetOriginalLinkLibraries() const { return impl->OriginalLinkLibraries; } void cmTarget::AddLinkLibrary(cmMakefile& mf, std::string const& lib, cmTargetLinkLibraryType llt) { cmTarget* tgt = mf.FindTargetToUse(lib); { const bool isNonImportedTarget = tgt && !tgt->IsImported(); const std::string libName = (isNonImportedTarget && llt != GENERAL_LibraryType) ? targetNameGenex(lib) : lib; this->AppendProperty("LINK_LIBRARIES", this->GetDebugGeneratorExpressions(libName, llt)); } if (cmGeneratorExpression::Find(lib) != std::string::npos || (tgt && (tgt->GetType() == cmStateEnums::INTERFACE_LIBRARY || tgt->GetType() == cmStateEnums::OBJECT_LIBRARY)) || (impl->Name == lib)) { return; } impl->OriginalLinkLibraries.emplace_back(lib, llt); // Add the explicit dependency information for libraries. This is // simply a set of libraries separated by ";". There should always // be a trailing ";". These library names are not canonical, in that // they may be "-framework x", "-ly", "/path/libz.a", etc. // We shouldn't remove duplicates here because external libraries // may be purposefully duplicated to handle recursive dependencies, // and we removing one instance will break the link line. Duplicates // will be appropriately eliminated at emit time. if (impl->TargetType >= cmStateEnums::STATIC_LIBRARY && impl->TargetType <= cmStateEnums::MODULE_LIBRARY && (this->GetPolicyStatusCMP0073() == cmPolicies::OLD || this->GetPolicyStatusCMP0073() == cmPolicies::WARN)) { std::string targetEntry = cmStrCat(impl->Name, "_LIB_DEPENDS"); std::string dependencies; cmProp old_val = mf.GetDefinition(targetEntry); if (old_val) { dependencies += *old_val; } switch (llt) { case GENERAL_LibraryType: dependencies += "general"; break; case DEBUG_LibraryType: dependencies += "debug"; break; case OPTIMIZED_LibraryType: dependencies += "optimized"; break; } dependencies += ";"; dependencies += lib; dependencies += ";"; mf.AddCacheDefinition(targetEntry, dependencies, "Dependencies for the target", cmStateEnums::STATIC); } } void cmTarget::AddSystemIncludeDirectories(const std::set& incs) { impl->SystemIncludeDirectories.insert(incs.begin(), incs.end()); } std::set const& cmTarget::GetSystemIncludeDirectories() const { return impl->SystemIncludeDirectories; } cmStringRange cmTarget::GetIncludeDirectoriesEntries() const { return cmMakeRange(impl->IncludeDirectoriesEntries); } cmBacktraceRange cmTarget::GetIncludeDirectoriesBacktraces() const { return cmMakeRange(impl->IncludeDirectoriesBacktraces); } cmStringRange cmTarget::GetCompileOptionsEntries() const { return cmMakeRange(impl->CompileOptionsEntries); } cmBacktraceRange cmTarget::GetCompileOptionsBacktraces() const { return cmMakeRange(impl->CompileOptionsBacktraces); } cmStringRange cmTarget::GetCompileFeaturesEntries() const { return cmMakeRange(impl->CompileFeaturesEntries); } cmBacktraceRange cmTarget::GetCompileFeaturesBacktraces() const { return cmMakeRange(impl->CompileFeaturesBacktraces); } cmStringRange cmTarget::GetCompileDefinitionsEntries() const { return cmMakeRange(impl->CompileDefinitionsEntries); } cmBacktraceRange cmTarget::GetCompileDefinitionsBacktraces() const { return cmMakeRange(impl->CompileDefinitionsBacktraces); } cmStringRange cmTarget::GetPrecompileHeadersEntries() const { return cmMakeRange(impl->PrecompileHeadersEntries); } cmBacktraceRange cmTarget::GetPrecompileHeadersBacktraces() const { return cmMakeRange(impl->PrecompileHeadersBacktraces); } cmStringRange cmTarget::GetSourceEntries() const { return cmMakeRange(impl->SourceEntries); } cmBacktraceRange cmTarget::GetSourceBacktraces() const { return cmMakeRange(impl->SourceBacktraces); } cmStringRange cmTarget::GetLinkOptionsEntries() const { return cmMakeRange(impl->LinkOptionsEntries); } cmBacktraceRange cmTarget::GetLinkOptionsBacktraces() const { return cmMakeRange(impl->LinkOptionsBacktraces); } cmStringRange cmTarget::GetLinkDirectoriesEntries() const { return cmMakeRange(impl->LinkDirectoriesEntries); } cmBacktraceRange cmTarget::GetLinkDirectoriesBacktraces() const { return cmMakeRange(impl->LinkDirectoriesBacktraces); } cmStringRange cmTarget::GetLinkImplementationEntries() const { return cmMakeRange(impl->LinkImplementationPropertyEntries); } cmBacktraceRange cmTarget::GetLinkImplementationBacktraces() const { return cmMakeRange(impl->LinkImplementationPropertyBacktraces); } void cmTarget::SetProperty(const std::string& prop, const char* value) { #define MAKE_STATIC_PROP(PROP) static const std::string prop##PROP = #PROP MAKE_STATIC_PROP(C_STANDARD); MAKE_STATIC_PROP(CXX_STANDARD); MAKE_STATIC_PROP(CUDA_STANDARD); MAKE_STATIC_PROP(OBJC_STANDARD); MAKE_STATIC_PROP(OBJCXX_STANDARD); MAKE_STATIC_PROP(COMPILE_DEFINITIONS); MAKE_STATIC_PROP(COMPILE_FEATURES); MAKE_STATIC_PROP(COMPILE_OPTIONS); MAKE_STATIC_PROP(PRECOMPILE_HEADERS); MAKE_STATIC_PROP(PRECOMPILE_HEADERS_REUSE_FROM); MAKE_STATIC_PROP(CUDA_PTX_COMPILATION); MAKE_STATIC_PROP(EXPORT_NAME); MAKE_STATIC_PROP(IMPORTED_GLOBAL); MAKE_STATIC_PROP(INCLUDE_DIRECTORIES); MAKE_STATIC_PROP(LINK_OPTIONS); MAKE_STATIC_PROP(LINK_DIRECTORIES); MAKE_STATIC_PROP(LINK_LIBRARIES); MAKE_STATIC_PROP(MANUALLY_ADDED_DEPENDENCIES); MAKE_STATIC_PROP(NAME); MAKE_STATIC_PROP(SOURCES); MAKE_STATIC_PROP(TYPE); #undef MAKE_STATIC_PROP if (prop == propMANUALLY_ADDED_DEPENDENCIES) { impl->Makefile->IssueMessage( MessageType::FATAL_ERROR, "MANUALLY_ADDED_DEPENDENCIES property is read-only\n"); return; } if (prop == propNAME) { impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, "NAME property is read-only\n"); return; } if (prop == propTYPE) { impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, "TYPE property is read-only\n"); return; } if (prop == propEXPORT_NAME && this->IsImported()) { std::ostringstream e; e << "EXPORT_NAME property can't be set on imported targets (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } if (prop == propSOURCES && this->IsImported()) { std::ostringstream e; e << "SOURCES property can't be set on imported targets (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } if (prop == propIMPORTED_GLOBAL && !this->IsImported()) { std::ostringstream e; e << "IMPORTED_GLOBAL property can't be set on non-imported targets (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } if (prop == propINCLUDE_DIRECTORIES) { impl->IncludeDirectoriesEntries.clear(); impl->IncludeDirectoriesBacktraces.clear(); if (value) { impl->IncludeDirectoriesEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->IncludeDirectoriesBacktraces.push_back(lfbt); } } else if (prop == propCOMPILE_OPTIONS) { impl->CompileOptionsEntries.clear(); impl->CompileOptionsBacktraces.clear(); if (value) { impl->CompileOptionsEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->CompileOptionsBacktraces.push_back(lfbt); } } else if (prop == propCOMPILE_FEATURES) { impl->CompileFeaturesEntries.clear(); impl->CompileFeaturesBacktraces.clear(); if (value) { impl->CompileFeaturesEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->CompileFeaturesBacktraces.push_back(lfbt); } } else if (prop == propCOMPILE_DEFINITIONS) { impl->CompileDefinitionsEntries.clear(); impl->CompileDefinitionsBacktraces.clear(); if (value) { impl->CompileDefinitionsEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->CompileDefinitionsBacktraces.push_back(lfbt); } } else if (prop == propLINK_OPTIONS) { impl->LinkOptionsEntries.clear(); impl->LinkOptionsBacktraces.clear(); if (value) { impl->LinkOptionsEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->LinkOptionsBacktraces.push_back(lfbt); } } else if (prop == propLINK_DIRECTORIES) { impl->LinkDirectoriesEntries.clear(); impl->LinkDirectoriesBacktraces.clear(); if (value) { impl->LinkDirectoriesEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->LinkDirectoriesBacktraces.push_back(lfbt); } } else if (prop == propPRECOMPILE_HEADERS) { impl->PrecompileHeadersEntries.clear(); impl->PrecompileHeadersBacktraces.clear(); if (value) { impl->PrecompileHeadersEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->PrecompileHeadersBacktraces.push_back(lfbt); } } else if (prop == propLINK_LIBRARIES) { impl->LinkImplementationPropertyEntries.clear(); impl->LinkImplementationPropertyBacktraces.clear(); if (value) { cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->LinkImplementationPropertyEntries.emplace_back(value); impl->LinkImplementationPropertyBacktraces.push_back(lfbt); } } else if (prop == propSOURCES) { impl->SourceEntries.clear(); impl->SourceBacktraces.clear(); if (value) { cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->SourceEntries.emplace_back(value); impl->SourceBacktraces.push_back(lfbt); } } else if (prop == propIMPORTED_GLOBAL) { if (!cmIsOn(value)) { std::ostringstream e; e << "IMPORTED_GLOBAL property can't be set to FALSE on targets (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } /* no need to change anything if value does not change */ if (!impl->ImportedGloballyVisible) { impl->ImportedGloballyVisible = true; this->GetGlobalGenerator()->IndexTarget(this); } } else if (cmHasLiteralPrefix(prop, "IMPORTED_LIBNAME") && !impl->CheckImportedLibName(prop, value ? value : "")) { /* error was reported by check method */ } else if (prop == propCUDA_PTX_COMPILATION && this->GetType() != cmStateEnums::OBJECT_LIBRARY) { std::ostringstream e; e << "CUDA_PTX_COMPILATION property can only be applied to OBJECT " "targets (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } else if (prop == propPRECOMPILE_HEADERS_REUSE_FROM) { if (this->GetProperty("PRECOMPILE_HEADERS")) { std::ostringstream e; e << "PRECOMPILE_HEADERS property is already set on target (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } auto reusedTarget = impl->Makefile->GetCMakeInstance()->GetGlobalGenerator()->FindTarget( value); if (!reusedTarget) { const std::string e( "PRECOMPILE_HEADERS_REUSE_FROM set with non existing target"); impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e); return; } std::string reusedFrom = reusedTarget->GetSafeProperty(prop); if (reusedFrom.empty()) { reusedFrom = value; } impl->Properties.SetProperty(prop, reusedFrom.c_str()); reusedTarget->SetProperty("COMPILE_PDB_NAME", reusedFrom); reusedTarget->SetProperty("COMPILE_PDB_OUTPUT_DIRECTORY", cmStrCat(reusedFrom, ".dir/")); cmProp tmp = reusedTarget->GetProperty("COMPILE_PDB_NAME"); this->SetProperty("COMPILE_PDB_NAME", cmToCStr(tmp)); this->AddUtility(reusedFrom, false, impl->Makefile); } else if (prop == propC_STANDARD || prop == propCXX_STANDARD || prop == propCUDA_STANDARD || prop == propOBJC_STANDARD || prop == propOBJCXX_STANDARD) { if (value) { impl->LanguageStandardProperties[prop] = BTs(value, impl->Makefile->GetBacktrace()); } else { impl->LanguageStandardProperties.erase(prop); } } else { impl->Properties.SetProperty(prop, value); } } void cmTarget::AppendProperty(const std::string& prop, const std::string& value, bool asString) { if (prop == "NAME") { impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, "NAME property is read-only\n"); return; } if (prop == "EXPORT_NAME" && this->IsImported()) { std::ostringstream e; e << "EXPORT_NAME property can't be set on imported targets (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } if (prop == "SOURCES" && this->IsImported()) { std::ostringstream e; e << "SOURCES property can't be set on imported targets (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } if (prop == "IMPORTED_GLOBAL") { std::ostringstream e; e << "IMPORTED_GLOBAL property can't be appended, only set on imported " "targets (\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } if (prop == "INCLUDE_DIRECTORIES") { if (!value.empty()) { impl->IncludeDirectoriesEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->IncludeDirectoriesBacktraces.push_back(lfbt); } } else if (prop == "COMPILE_OPTIONS") { if (!value.empty()) { impl->CompileOptionsEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->CompileOptionsBacktraces.push_back(lfbt); } } else if (prop == "COMPILE_FEATURES") { if (!value.empty()) { impl->CompileFeaturesEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->CompileFeaturesBacktraces.push_back(lfbt); } } else if (prop == "COMPILE_DEFINITIONS") { if (!value.empty()) { impl->CompileDefinitionsEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->CompileDefinitionsBacktraces.push_back(lfbt); } } else if (prop == "LINK_OPTIONS") { if (!value.empty()) { impl->LinkOptionsEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->LinkOptionsBacktraces.push_back(lfbt); } } else if (prop == "LINK_DIRECTORIES") { if (!value.empty()) { impl->LinkDirectoriesEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->LinkDirectoriesBacktraces.push_back(lfbt); } } else if (prop == "PRECOMPILE_HEADERS") { if (this->GetProperty("PRECOMPILE_HEADERS_REUSE_FROM")) { std::ostringstream e; e << "PRECOMPILE_HEADERS_REUSE_FROM property is already set on target " "(\"" << impl->Name << "\")\n"; impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, e.str()); return; } if (!value.empty()) { impl->PrecompileHeadersEntries.emplace_back(value); cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->PrecompileHeadersBacktraces.push_back(lfbt); } } else if (prop == "LINK_LIBRARIES") { if (!value.empty()) { cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->LinkImplementationPropertyEntries.emplace_back(value); impl->LinkImplementationPropertyBacktraces.push_back(lfbt); } } else if (prop == "SOURCES") { cmListFileBacktrace lfbt = impl->Makefile->GetBacktrace(); impl->SourceEntries.emplace_back(value); impl->SourceBacktraces.push_back(lfbt); } else if (cmHasLiteralPrefix(prop, "IMPORTED_LIBNAME")) { impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, prop + " property may not be APPENDed."); } else if (prop == "C_STANDARD" || prop == "CXX_STANDARD" || prop == "CUDA_STANDARD" || prop == "OBJC_STANDARD" || prop == "OBJCXX_STANDARD") { impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, prop + " property may not be appended."); } else { impl->Properties.AppendProperty(prop, value, asString); } } void cmTarget::AppendBuildInterfaceIncludes() { if (this->GetType() != cmStateEnums::SHARED_LIBRARY && this->GetType() != cmStateEnums::STATIC_LIBRARY && this->GetType() != cmStateEnums::MODULE_LIBRARY && this->GetType() != cmStateEnums::INTERFACE_LIBRARY && !this->IsExecutableWithExports()) { return; } if (impl->BuildInterfaceIncludesAppended) { return; } impl->BuildInterfaceIncludesAppended = true; if (impl->Makefile->IsOn("CMAKE_INCLUDE_CURRENT_DIR_IN_INTERFACE")) { std::string dirs = impl->Makefile->GetCurrentBinaryDirectory(); if (!dirs.empty()) { dirs += ';'; } dirs += impl->Makefile->GetCurrentSourceDirectory(); if (!dirs.empty()) { this->AppendProperty("INTERFACE_INCLUDE_DIRECTORIES", ("$")); } } } void cmTarget::InsertInclude(std::string const& entry, cmListFileBacktrace const& bt, bool before) { auto position = before ? impl->IncludeDirectoriesEntries.begin() : impl->IncludeDirectoriesEntries.end(); auto btPosition = before ? impl->IncludeDirectoriesBacktraces.begin() : impl->IncludeDirectoriesBacktraces.end(); impl->IncludeDirectoriesEntries.insert(position, entry); impl->IncludeDirectoriesBacktraces.insert(btPosition, bt); } void cmTarget::InsertCompileOption(std::string const& entry, cmListFileBacktrace const& bt, bool before) { auto position = before ? impl->CompileOptionsEntries.begin() : impl->CompileOptionsEntries.end(); auto btPosition = before ? impl->CompileOptionsBacktraces.begin() : impl->CompileOptionsBacktraces.end(); impl->CompileOptionsEntries.insert(position, entry); impl->CompileOptionsBacktraces.insert(btPosition, bt); } void cmTarget::InsertCompileDefinition(std::string const& entry, cmListFileBacktrace const& bt) { impl->CompileDefinitionsEntries.push_back(entry); impl->CompileDefinitionsBacktraces.push_back(bt); } void cmTarget::InsertLinkOption(std::string const& entry, cmListFileBacktrace const& bt, bool before) { auto position = before ? impl->LinkOptionsEntries.begin() : impl->LinkOptionsEntries.end(); auto btPosition = before ? impl->LinkOptionsBacktraces.begin() : impl->LinkOptionsBacktraces.end(); impl->LinkOptionsEntries.insert(position, entry); impl->LinkOptionsBacktraces.insert(btPosition, bt); } void cmTarget::InsertLinkDirectory(std::string const& entry, cmListFileBacktrace const& bt, bool before) { auto position = before ? impl->LinkDirectoriesEntries.begin() : impl->LinkDirectoriesEntries.end(); auto btPosition = before ? impl->LinkDirectoriesBacktraces.begin() : impl->LinkDirectoriesBacktraces.end(); impl->LinkDirectoriesEntries.insert(position, entry); impl->LinkDirectoriesBacktraces.insert(btPosition, bt); } void cmTarget::InsertPrecompileHeader(std::string const& entry, cmListFileBacktrace const& bt) { impl->PrecompileHeadersEntries.push_back(entry); impl->PrecompileHeadersBacktraces.push_back(bt); } static void cmTargetCheckLINK_INTERFACE_LIBRARIES(const std::string& prop, const std::string& value, cmMakefile* context, bool imported) { // Look for link-type keywords in the value. static cmsys::RegularExpression keys("(^|;)(debug|optimized|general)(;|$)"); if (!keys.find(value)) { return; } // Support imported and non-imported versions of the property. const char* base = (imported ? "IMPORTED_LINK_INTERFACE_LIBRARIES" : "LINK_INTERFACE_LIBRARIES"); // Report an error. std::ostringstream e; e << "Property " << prop << " may not contain link-type keyword \"" << keys.match(2) << "\". " << "The " << base << " property has a per-configuration " << "version called " << base << "_ which may be " << "used to specify per-configuration rules."; if (!imported) { e << " " << "Alternatively, an IMPORTED library may be created, configured " << "with a per-configuration location, and then named in the " << "property value. " << "See the add_library command's IMPORTED mode for details." << "\n" << "If you have a list of libraries that already contains the " << "keyword, use the target_link_libraries command with its " << "LINK_INTERFACE_LIBRARIES mode to set the property. " << "The command automatically recognizes link-type keywords and sets " << "the LINK_INTERFACE_LIBRARIES and LINK_INTERFACE_LIBRARIES_DEBUG " << "properties accordingly."; } context->IssueMessage(MessageType::FATAL_ERROR, e.str()); } static void cmTargetCheckINTERFACE_LINK_LIBRARIES(const std::string& value, cmMakefile* context) { // Look for link-type keywords in the value. static cmsys::RegularExpression keys("(^|;)(debug|optimized|general)(;|$)"); if (!keys.find(value)) { return; } // Report an error. std::ostringstream e; e << "Property INTERFACE_LINK_LIBRARIES may not contain link-type " "keyword \"" << keys.match(2) << "\". The INTERFACE_LINK_LIBRARIES " "property may contain configuration-sensitive generator-expressions " "which may be used to specify per-configuration rules."; context->IssueMessage(MessageType::FATAL_ERROR, e.str()); } static void cmTargetCheckIMPORTED_GLOBAL(const cmTarget* target, cmMakefile* context) { const auto& targets = context->GetOwnedImportedTargets(); auto it = std::find_if(targets.begin(), targets.end(), [&](const std::unique_ptr& importTarget) -> bool { return target == importTarget.get(); }); if (it == targets.end()) { std::ostringstream e; e << "Attempt to promote imported target \"" << target->GetName() << "\" to global scope (by setting IMPORTED_GLOBAL) " "which is not built in this directory."; context->IssueMessage(MessageType::FATAL_ERROR, e.str()); } } void cmTarget::CheckProperty(const std::string& prop, cmMakefile* context) const { // Certain properties need checking. if (cmHasLiteralPrefix(prop, "LINK_INTERFACE_LIBRARIES")) { if (cmProp value = this->GetProperty(prop)) { cmTargetCheckLINK_INTERFACE_LIBRARIES(prop, *value, context, false); } } if (cmHasLiteralPrefix(prop, "IMPORTED_LINK_INTERFACE_LIBRARIES")) { if (cmProp value = this->GetProperty(prop)) { cmTargetCheckLINK_INTERFACE_LIBRARIES(prop, *value, context, true); } } if (prop == "INTERFACE_LINK_LIBRARIES") { if (cmProp value = this->GetProperty(prop)) { cmTargetCheckINTERFACE_LINK_LIBRARIES(*value, context); } } if (prop == "IMPORTED_GLOBAL") { if (this->IsImported()) { cmTargetCheckIMPORTED_GLOBAL(this, context); } } } cmProp cmTarget::GetComputedProperty(const std::string& prop, cmMessenger* messenger, cmListFileBacktrace const& context) const { return cmTargetPropertyComputer::GetProperty(this, prop, messenger, context); } cmProp cmTarget::GetProperty(const std::string& prop) const { #define MAKE_STATIC_PROP(PROP) static const std::string prop##PROP = #PROP MAKE_STATIC_PROP(C_STANDARD); MAKE_STATIC_PROP(CXX_STANDARD); MAKE_STATIC_PROP(CUDA_STANDARD); MAKE_STATIC_PROP(OBJC_STANDARD); MAKE_STATIC_PROP(OBJCXX_STANDARD); MAKE_STATIC_PROP(LINK_LIBRARIES); MAKE_STATIC_PROP(TYPE); MAKE_STATIC_PROP(INCLUDE_DIRECTORIES); MAKE_STATIC_PROP(COMPILE_FEATURES); MAKE_STATIC_PROP(COMPILE_OPTIONS); MAKE_STATIC_PROP(COMPILE_DEFINITIONS); MAKE_STATIC_PROP(LINK_OPTIONS); MAKE_STATIC_PROP(LINK_DIRECTORIES); MAKE_STATIC_PROP(PRECOMPILE_HEADERS); MAKE_STATIC_PROP(IMPORTED); MAKE_STATIC_PROP(IMPORTED_GLOBAL); MAKE_STATIC_PROP(MANUALLY_ADDED_DEPENDENCIES); MAKE_STATIC_PROP(NAME); MAKE_STATIC_PROP(BINARY_DIR); MAKE_STATIC_PROP(SOURCE_DIR); MAKE_STATIC_PROP(SOURCES); MAKE_STATIC_PROP(FALSE); MAKE_STATIC_PROP(TRUE); #undef MAKE_STATIC_PROP static std::unordered_set const specialProps{ propC_STANDARD, propCXX_STANDARD, propCUDA_STANDARD, propOBJC_STANDARD, propOBJCXX_STANDARD, propLINK_LIBRARIES, propTYPE, propINCLUDE_DIRECTORIES, propCOMPILE_FEATURES, propCOMPILE_OPTIONS, propCOMPILE_DEFINITIONS, propPRECOMPILE_HEADERS, propLINK_OPTIONS, propLINK_DIRECTORIES, propIMPORTED, propIMPORTED_GLOBAL, propMANUALLY_ADDED_DEPENDENCIES, propNAME, propBINARY_DIR, propSOURCE_DIR, propSOURCES }; if (specialProps.count(prop)) { if (prop == propC_STANDARD || prop == propCXX_STANDARD || prop == propCUDA_STANDARD || prop == propOBJC_STANDARD || prop == propOBJCXX_STANDARD) { auto propertyIter = impl->LanguageStandardProperties.find(prop); if (propertyIter == impl->LanguageStandardProperties.end()) { return nullptr; } return &(propertyIter->second.Value); } if (prop == propLINK_LIBRARIES) { if (impl->LinkImplementationPropertyEntries.empty()) { return nullptr; } static std::string output; output = cmJoin(impl->LinkImplementationPropertyEntries, ";"); return &output; } // the type property returns what type the target is if (prop == propTYPE) { return &cmState::GetTargetTypeName(this->GetType()); } if (prop == propINCLUDE_DIRECTORIES) { if (impl->IncludeDirectoriesEntries.empty()) { return nullptr; } static std::string output; output = cmJoin(impl->IncludeDirectoriesEntries, ";"); return &output; } if (prop == propCOMPILE_FEATURES) { if (impl->CompileFeaturesEntries.empty()) { return nullptr; } static std::string output; output = cmJoin(impl->CompileFeaturesEntries, ";"); return &output; } if (prop == propCOMPILE_OPTIONS) { if (impl->CompileOptionsEntries.empty()) { return nullptr; } static std::string output; output = cmJoin(impl->CompileOptionsEntries, ";"); return &output; } if (prop == propCOMPILE_DEFINITIONS) { if (impl->CompileDefinitionsEntries.empty()) { return nullptr; } static std::string output; output = cmJoin(impl->CompileDefinitionsEntries, ";"); return &output; } if (prop == propLINK_OPTIONS) { if (impl->LinkOptionsEntries.empty()) { return nullptr; } static std::string output; output = cmJoin(impl->LinkOptionsEntries, ";"); return &output; } if (prop == propLINK_DIRECTORIES) { if (impl->LinkDirectoriesEntries.empty()) { return nullptr; } static std::string output; output = cmJoin(impl->LinkDirectoriesEntries, ";"); return &output; } if (prop == propMANUALLY_ADDED_DEPENDENCIES) { if (impl->Utilities.empty()) { return nullptr; } static std::string output; static std::vector utilities; utilities.resize(impl->Utilities.size()); std::transform( impl->Utilities.cbegin(), impl->Utilities.cend(), utilities.begin(), [](const BT>& item) -> std::string { return item.Value.first; }); output = cmJoin(utilities, ";"); return &output; } if (prop == propPRECOMPILE_HEADERS) { if (impl->PrecompileHeadersEntries.empty()) { return nullptr; } static std::string output; output = cmJoin(impl->PrecompileHeadersEntries, ";"); return &output; } if (prop == propIMPORTED) { return this->IsImported() ? &propTRUE : &propFALSE; } if (prop == propIMPORTED_GLOBAL) { return this->IsImportedGloballyVisible() ? &propTRUE : &propFALSE; } if (prop == propNAME) { return &this->GetName(); } if (prop == propBINARY_DIR) { return &impl->Makefile->GetStateSnapshot() .GetDirectory() .GetCurrentBinary(); } if (prop == propSOURCE_DIR) { return &impl->Makefile->GetStateSnapshot() .GetDirectory() .GetCurrentSource(); } } cmProp retVal = impl->Properties.GetPropertyValue(prop); if (!retVal) { const bool chain = impl->Makefile->GetState()->IsPropertyChained(prop, cmProperty::TARGET); if (chain) { return impl->Makefile->GetStateSnapshot().GetDirectory().GetProperty( prop, chain); } return nullptr; } return retVal; } std::string const& cmTarget::GetSafeProperty(std::string const& prop) const { cmProp ret = this->GetProperty(prop); if (ret) { return *ret; } static std::string const s_empty; return s_empty; } bool cmTarget::GetPropertyAsBool(const std::string& prop) const { return cmIsOn(this->GetProperty(prop)); } cmPropertyMap const& cmTarget::GetProperties() const { return impl->Properties; } bool cmTarget::IsDLLPlatform() const { return impl->IsDLLPlatform; } bool cmTarget::IsAIX() const { return impl->IsAIX; } bool cmTarget::IsImported() const { return impl->IsImportedTarget; } bool cmTarget::IsImportedGloballyVisible() const { return impl->ImportedGloballyVisible; } bool cmTarget::IsPerConfig() const { return impl->PerConfig; } bool cmTarget::CanCompileSources() const { if (this->IsImported()) { return false; } switch (this->GetType()) { case cmStateEnums::EXECUTABLE: case cmStateEnums::STATIC_LIBRARY: case cmStateEnums::SHARED_LIBRARY: case cmStateEnums::MODULE_LIBRARY: case cmStateEnums::OBJECT_LIBRARY: return true; case cmStateEnums::UTILITY: case cmStateEnums::INTERFACE_LIBRARY: case cmStateEnums::GLOBAL_TARGET: case cmStateEnums::UNKNOWN_LIBRARY: break; } return false; } const char* cmTarget::GetSuffixVariableInternal( cmStateEnums::ArtifactType artifact) const { switch (this->GetType()) { case cmStateEnums::STATIC_LIBRARY: return "CMAKE_STATIC_LIBRARY_SUFFIX"; case cmStateEnums::SHARED_LIBRARY: switch (artifact) { case cmStateEnums::RuntimeBinaryArtifact: return "CMAKE_SHARED_LIBRARY_SUFFIX"; case cmStateEnums::ImportLibraryArtifact: return "CMAKE_IMPORT_LIBRARY_SUFFIX"; } break; case cmStateEnums::MODULE_LIBRARY: switch (artifact) { case cmStateEnums::RuntimeBinaryArtifact: return "CMAKE_SHARED_MODULE_SUFFIX"; case cmStateEnums::ImportLibraryArtifact: return "CMAKE_IMPORT_LIBRARY_SUFFIX"; } break; case cmStateEnums::EXECUTABLE: switch (artifact) { case cmStateEnums::RuntimeBinaryArtifact: // Android GUI application packages store the native // binary as a shared library. return (this->IsAndroidGuiExecutable() ? "CMAKE_SHARED_LIBRARY_SUFFIX" : "CMAKE_EXECUTABLE_SUFFIX"); case cmStateEnums::ImportLibraryArtifact: return (impl->IsAIX ? "CMAKE_AIX_IMPORT_FILE_SUFFIX" : "CMAKE_IMPORT_LIBRARY_SUFFIX"); } break; default: break; } return ""; } const char* cmTarget::GetPrefixVariableInternal( cmStateEnums::ArtifactType artifact) const { switch (this->GetType()) { case cmStateEnums::STATIC_LIBRARY: return "CMAKE_STATIC_LIBRARY_PREFIX"; case cmStateEnums::SHARED_LIBRARY: switch (artifact) { case cmStateEnums::RuntimeBinaryArtifact: return "CMAKE_SHARED_LIBRARY_PREFIX"; case cmStateEnums::ImportLibraryArtifact: return "CMAKE_IMPORT_LIBRARY_PREFIX"; } break; case cmStateEnums::MODULE_LIBRARY: switch (artifact) { case cmStateEnums::RuntimeBinaryArtifact: return "CMAKE_SHARED_MODULE_PREFIX"; case cmStateEnums::ImportLibraryArtifact: return "CMAKE_IMPORT_LIBRARY_PREFIX"; } break; case cmStateEnums::EXECUTABLE: switch (artifact) { case cmStateEnums::RuntimeBinaryArtifact: // Android GUI application packages store the native // binary as a shared library. return (this->IsAndroidGuiExecutable() ? "CMAKE_SHARED_LIBRARY_PREFIX" : ""); case cmStateEnums::ImportLibraryArtifact: return (impl->IsAIX ? "CMAKE_AIX_IMPORT_FILE_PREFIX" : "CMAKE_IMPORT_LIBRARY_PREFIX"); } break; default: break; } return ""; } std::string cmTarget::ImportedGetFullPath( const std::string& config, cmStateEnums::ArtifactType artifact) const { assert(this->IsImported()); // Lookup/compute/cache the import information for this // configuration. std::string desired_config = config; if (config.empty()) { desired_config = "NOCONFIG"; } std::string result; cmProp loc = nullptr; cmProp imp = nullptr; std::string suffix; if (this->GetType() != cmStateEnums::INTERFACE_LIBRARY && this->GetMappedConfig(desired_config, loc, imp, suffix)) { switch (artifact) { case cmStateEnums::RuntimeBinaryArtifact: if (loc) { result = *loc; } else { std::string impProp = cmStrCat("IMPORTED_LOCATION", suffix); if (cmProp config_location = this->GetProperty(impProp)) { result = *config_location; } else if (cmProp location = this->GetProperty("IMPORTED_LOCATION")) { result = *location; } } break; case cmStateEnums::ImportLibraryArtifact: if (imp) { result = *imp; } else if (this->GetType() == cmStateEnums::SHARED_LIBRARY || this->IsExecutableWithExports()) { std::string impProp = cmStrCat("IMPORTED_IMPLIB", suffix); if (cmProp config_implib = this->GetProperty(impProp)) { result = *config_implib; } else if (cmProp implib = this->GetProperty("IMPORTED_IMPLIB")) { result = *implib; } } break; } } if (result.empty()) { auto message = [&]() -> std::string { std::string unset; std::string configuration; if (artifact == cmStateEnums::RuntimeBinaryArtifact) { unset = "IMPORTED_LOCATION"; } else if (artifact == cmStateEnums::ImportLibraryArtifact) { unset = "IMPORTED_IMPLIB"; } if (!config.empty()) { configuration = cmStrCat(" configuration \"", config, "\""); } return cmStrCat(unset, " not set for imported target \"", this->GetName(), "\"", configuration, "."); }; switch (this->GetPolicyStatus(cmPolicies::CMP0111)) { case cmPolicies::WARN: impl->Makefile->IssueMessage( MessageType::AUTHOR_WARNING, cmPolicies::GetPolicyWarning(cmPolicies::CMP0111) + "\n" + message()); CM_FALLTHROUGH; case cmPolicies::OLD: break; default: impl->Makefile->IssueMessage(MessageType::FATAL_ERROR, message()); } result = cmStrCat(this->GetName(), "-NOTFOUND"); } return result; } bool cmTargetInternals::CheckImportedLibName(std::string const& prop, std::string const& value) const { if (this->TargetType != cmStateEnums::INTERFACE_LIBRARY || !this->IsImportedTarget) { this->Makefile->IssueMessage( MessageType::FATAL_ERROR, prop + " property may be set only on imported INTERFACE library targets."); return false; } if (!value.empty()) { if (value[0] == '-') { this->Makefile->IssueMessage(MessageType::FATAL_ERROR, prop + " property value\n " + value + "\nmay not start with '-'."); return false; } std::string::size_type bad = value.find_first_of(":/\\;"); if (bad != std::string::npos) { this->Makefile->IssueMessage(MessageType::FATAL_ERROR, prop + " property value\n " + value + "\nmay not contain '" + value.substr(bad, 1) + "'."); return false; } } return true; } bool cmTarget::GetMappedConfig(std::string const& desired_config, cmProp& loc, cmProp& imp, std::string& suffix) const { std::string config_upper; if (!desired_config.empty()) { config_upper = cmSystemTools::UpperCase(desired_config); } std::string locPropBase; if (this->GetType() == cmStateEnums::INTERFACE_LIBRARY) { locPropBase = "IMPORTED_LIBNAME"; } else if (this->GetType() == cmStateEnums::OBJECT_LIBRARY) { locPropBase = "IMPORTED_OBJECTS"; } else { locPropBase = "IMPORTED_LOCATION"; } // Track the configuration-specific property suffix. suffix = cmStrCat('_', config_upper); std::vector mappedConfigs; { std::string mapProp = cmStrCat("MAP_IMPORTED_CONFIG_", config_upper); if (cmProp mapValue = this->GetProperty(mapProp)) { cmExpandList(*mapValue, mappedConfigs, true); } } // If we needed to find one of the mapped configurations but did not // On a DLL platform there may be only IMPORTED_IMPLIB for a shared // library or an executable with exports. bool allowImp = (this->IsDLLPlatform() && (this->GetType() == cmStateEnums::SHARED_LIBRARY || this->IsExecutableWithExports())) || (this->IsAIX() && this->IsExecutableWithExports()); // If a mapping was found, check its configurations. for (auto mci = mappedConfigs.begin(); !loc && !imp && mci != mappedConfigs.end(); ++mci) { // Look for this configuration. if (mci->empty()) { // An empty string in the mapping has a special meaning: // look up the config-less properties. loc = this->GetProperty(locPropBase); if (allowImp) { imp = this->GetProperty("IMPORTED_IMPLIB"); } // If it was found, set the suffix. if (loc || imp) { suffix.clear(); } } else { std::string mcUpper = cmSystemTools::UpperCase(*mci); std::string locProp = cmStrCat(locPropBase, '_', mcUpper); loc = this->GetProperty(locProp); if (allowImp) { std::string impProp = cmStrCat("IMPORTED_IMPLIB_", mcUpper); imp = this->GetProperty(impProp); } // If it was found, use it for all properties below. if (loc || imp) { suffix = cmStrCat('_', mcUpper); } } } // If we needed to find one of the mapped configurations but did not // then the target location is not found. The project does not want // any other configuration. if (!mappedConfigs.empty() && !loc && !imp) { // Interface libraries are always available because their // library name is optional so it is okay to leave loc empty. return this->GetType() == cmStateEnums::INTERFACE_LIBRARY; } // If we have not yet found it then there are no mapped // configurations. Look for an exact-match. if (!loc && !imp) { std::string locProp = cmStrCat(locPropBase, suffix); loc = this->GetProperty(locProp); if (allowImp) { std::string impProp = cmStrCat("IMPORTED_IMPLIB", suffix); imp = this->GetProperty(impProp); } } // If we have not yet found it then there are no mapped // configurations and no exact match. if (!loc && !imp) { // The suffix computed above is not useful. suffix.clear(); // Look for a configuration-less location. This may be set by // manually-written code. loc = this->GetProperty(locPropBase); if (allowImp) { imp = this->GetProperty("IMPORTED_IMPLIB"); } } // If we have not yet found it then the project is willing to try // any available configuration. if (!loc && !imp) { std::vector availableConfigs; if (cmProp iconfigs = this->GetProperty("IMPORTED_CONFIGURATIONS")) { cmExpandList(*iconfigs, availableConfigs); } for (auto aci = availableConfigs.begin(); !loc && !imp && aci != availableConfigs.end(); ++aci) { suffix = cmStrCat('_', cmSystemTools::UpperCase(*aci)); std::string locProp = cmStrCat(locPropBase, suffix); loc = this->GetProperty(locProp); if (allowImp) { std::string impProp = cmStrCat("IMPORTED_IMPLIB", suffix); imp = this->GetProperty(impProp); } } } // If we have not yet found it then the target location is not available. if (!loc && !imp) { // Interface libraries are always available because their // library name is optional so it is okay to leave loc empty. return this->GetType() == cmStateEnums::INTERFACE_LIBRARY; } return true; }