diff options
Diffstat (limited to 'Source/cmTarget.h')
-rw-r--r-- | Source/cmTarget.h | 350 |
1 files changed, 350 insertions, 0 deletions
diff --git a/Source/cmTarget.h b/Source/cmTarget.h new file mode 100644 index 0000000..209a729 --- /dev/null +++ b/Source/cmTarget.h @@ -0,0 +1,350 @@ +/*============================================================================ + CMake - Cross Platform Makefile Generator + Copyright 2000-2009 Kitware, Inc., Insight Software Consortium + + Distributed under the OSI-approved BSD License (the "License"); + see accompanying file Copyright.txt for details. + + This software is distributed WITHOUT ANY WARRANTY; without even the + implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + See the License for more information. +============================================================================*/ +#ifndef cmTarget_h +#define cmTarget_h + +#include "cmStandardIncludes.h" + +#include "cmCustomCommand.h" +#include "cmListFileCache.h" +#include "cmPolicies.h" +#include "cmPropertyMap.h" + +#include <cm_auto_ptr.hxx> +#if defined(CMAKE_BUILD_WITH_CMAKE) +#ifdef CMake_HAVE_CXX_UNORDERED_MAP +#include <unordered_map> +#else +#include <cmsys/hash_map.hxx> +#endif +#endif + +class cmake; +class cmMakefile; +class cmSourceFile; +class cmGlobalGenerator; +class cmListFileBacktrace; +class cmTarget; +class cmGeneratorTarget; +class cmTargetTraceDependencies; + +class cmTargetInternals; +class cmTargetInternalPointer +{ +public: + cmTargetInternalPointer(); + cmTargetInternalPointer(cmTargetInternalPointer const& r); + ~cmTargetInternalPointer(); + cmTargetInternalPointer& operator=(cmTargetInternalPointer const& r); + cmTargetInternals* operator->() const { return this->Pointer; } + cmTargetInternals* Get() const { return this->Pointer; } +private: + cmTargetInternals* Pointer; +}; + +/** \class cmTarget + * \brief Represent a library or executable target loaded from a makefile. + * + * cmTarget represents a target loaded from + * a makefile. + */ +class cmTarget +{ +public: + cmTarget(); + enum CustomCommandType + { + PRE_BUILD, + PRE_LINK, + POST_BUILD + }; + + /** + * Return the type of target. + */ + cmState::TargetType GetType() const { return this->TargetTypeValue; } + + /** + * Set the target type + */ + void SetType(cmState::TargetType f, const std::string& name); + + void MarkAsImported(bool global = false); + + ///! Set/Get the name of the target + const std::string& GetName() const { return this->Name; } + + ///! Set the cmMakefile that owns this target + void SetMakefile(cmMakefile* mf); + cmMakefile* GetMakefile() const { return this->Makefile; } + +#define DECLARE_TARGET_POLICY(POLICY) \ + cmPolicies::PolicyStatus GetPolicyStatus##POLICY() const \ + { \ + return this->PolicyMap.Get(cmPolicies::POLICY); \ + } + + CM_FOR_EACH_TARGET_POLICY(DECLARE_TARGET_POLICY) + +#undef DECLARE_TARGET_POLICY + + /** + * Get the list of the custom commands for this target + */ + std::vector<cmCustomCommand> const& GetPreBuildCommands() const + { + return this->PreBuildCommands; + } + std::vector<cmCustomCommand> const& GetPreLinkCommands() const + { + return this->PreLinkCommands; + } + std::vector<cmCustomCommand> const& GetPostBuildCommands() const + { + return this->PostBuildCommands; + } + void AddPreBuildCommand(cmCustomCommand const& cmd) + { + this->PreBuildCommands.push_back(cmd); + } + void AddPreLinkCommand(cmCustomCommand const& cmd) + { + this->PreLinkCommands.push_back(cmd); + } + void AddPostBuildCommand(cmCustomCommand const& cmd) + { + this->PostBuildCommands.push_back(cmd); + } + + /** + * Add sources to the target. + */ + void AddSources(std::vector<std::string> const& srcs); + void AddTracedSources(std::vector<std::string> const& srcs); + cmSourceFile* AddSourceCMP0049(const std::string& src); + cmSourceFile* AddSource(const std::string& src); + + //* how we identify a library, by name and type + typedef std::pair<std::string, cmTargetLinkLibraryType> LibraryID; + + typedef std::vector<LibraryID> LinkLibraryVectorType; + const LinkLibraryVectorType& GetOriginalLinkLibraries() const + { + return this->OriginalLinkLibraries; + } + + /** + * Clear the dependency information recorded for this target, if any. + */ + void ClearDependencyInformation(cmMakefile& mf, const std::string& target); + + void AddLinkLibrary(cmMakefile& mf, const std::string& target, + const std::string& lib, cmTargetLinkLibraryType llt); + enum TLLSignature + { + KeywordTLLSignature, + PlainTLLSignature + }; + bool PushTLLCommandTrace(TLLSignature signature, + cmListFileContext const& lfc); + void GetTllSignatureTraces(std::ostream& s, TLLSignature sig) const; + + void MergeLinkLibraries(cmMakefile& mf, const std::string& selfname, + const LinkLibraryVectorType& libs); + + const std::vector<std::string>& GetLinkDirectories() const; + + void AddLinkDirectory(const std::string& d); + + /** + * Set the path where this target should be installed. This is relative to + * INSTALL_PREFIX + */ + std::string GetInstallPath() const { return this->InstallPath; } + void SetInstallPath(const char* name) { this->InstallPath = name; } + + /** + * Set the path where this target (if it has a runtime part) should be + * installed. This is relative to INSTALL_PREFIX + */ + std::string GetRuntimeInstallPath() const + { + return this->RuntimeInstallPath; + } + void SetRuntimeInstallPath(const char* name) + { + this->RuntimeInstallPath = name; + } + + /** + * Get/Set whether there is an install rule for this target. + */ + bool GetHaveInstallRule() const { return this->HaveInstallRule; } + void SetHaveInstallRule(bool h) { this->HaveInstallRule = h; } + + /** Add a utility on which this project depends. A utility is an executable + * name as would be specified to the ADD_EXECUTABLE or UTILITY_SOURCE + * commands. It is not a full path nor does it have an extension. + */ + void AddUtility(const std::string& u, cmMakefile* makefile = CM_NULLPTR); + ///! Get the utilities used by this target + std::set<std::string> const& GetUtilities() const { return this->Utilities; } + cmListFileBacktrace const* GetUtilityBacktrace(const std::string& u) const; + + ///! Set/Get a property of this target file + void SetProperty(const std::string& prop, const char* value); + void AppendProperty(const std::string& prop, const char* value, + bool asString = false); + const char* GetProperty(const std::string& prop) const; + const char* GetProperty(const std::string& prop, cmMakefile* context) const; + bool GetPropertyAsBool(const std::string& prop) const; + void CheckProperty(const std::string& prop, cmMakefile* context) const; + + bool IsImported() const { return this->IsImportedTarget; } + bool IsImportedGloballyVisible() const + { + return this->ImportedGloballyVisible; + } + + // Get the properties + cmPropertyMap& GetProperties() const { return this->Properties; } + + bool GetMappedConfig(std::string const& desired_config, const char** loc, + const char** imp, std::string& suffix) const; + + /** Return whether this target is an executable with symbol exports + enabled. */ + bool IsExecutableWithExports() const; + + /** Return whether this target is a shared library Framework on + Apple. */ + bool IsFrameworkOnApple() const; + + /** Return whether this target is an executable Bundle on Apple. */ + bool IsAppBundleOnApple() const; + + /** Get a backtrace from the creation of the target. */ + cmListFileBacktrace const& GetBacktrace() const; + + void InsertInclude(std::string const& entry, cmListFileBacktrace const& bt, + bool before = false); + void InsertCompileOption(std::string const& entry, + cmListFileBacktrace const& bt, bool before = false); + void InsertCompileDefinition(std::string const& entry, + cmListFileBacktrace const& bt); + + void AppendBuildInterfaceIncludes(); + + std::string GetDebugGeneratorExpressions(const std::string& value, + cmTargetLinkLibraryType llt) const; + + void AddSystemIncludeDirectories(const std::set<std::string>& incs); + std::set<std::string> const& GetSystemIncludeDirectories() const + { + return this->SystemIncludeDirectories; + } + + cmStringRange GetIncludeDirectoriesEntries() const; + cmBacktraceRange GetIncludeDirectoriesBacktraces() const; + + cmStringRange GetCompileOptionsEntries() const; + cmBacktraceRange GetCompileOptionsBacktraces() const; + + cmStringRange GetCompileFeaturesEntries() const; + cmBacktraceRange GetCompileFeaturesBacktraces() const; + + cmStringRange GetCompileDefinitionsEntries() const; + cmBacktraceRange GetCompileDefinitionsBacktraces() const; + + cmStringRange GetSourceEntries() const; + cmBacktraceRange GetSourceBacktraces() const; + cmStringRange GetLinkImplementationEntries() const; + cmBacktraceRange GetLinkImplementationBacktraces() const; + + struct StrictTargetComparison + { + bool operator()(cmTarget const* t1, cmTarget const* t2) const; + }; + +private: + bool HandleLocationPropertyPolicy(cmMakefile* context) const; + + const char* GetSuffixVariableInternal(bool implib) const; + const char* GetPrefixVariableInternal(bool implib) const; + + // Use a makefile variable to set a default for the given property. + // If the variable is not defined use the given default instead. + void SetPropertyDefault(const std::string& property, + const char* default_value); + + std::string ImportedGetFullPath(const std::string& config, + bool implib) const; + +private: + mutable cmPropertyMap Properties; + std::set<std::string> SystemIncludeDirectories; + std::set<std::string> LinkDirectoriesEmmitted; + std::set<std::string> Utilities; + std::map<std::string, cmListFileBacktrace> UtilityBacktraces; + cmPolicies::PolicyMap PolicyMap; + std::string Name; + std::string InstallPath; + std::string RuntimeInstallPath; + std::vector<std::string> LinkDirectories; + std::vector<cmCustomCommand> PreBuildCommands; + std::vector<cmCustomCommand> PreLinkCommands; + std::vector<cmCustomCommand> PostBuildCommands; + std::vector<std::pair<TLLSignature, cmListFileContext> > TLLCommands; + LinkLibraryVectorType PrevLinkedLibraries; + LinkLibraryVectorType OriginalLinkLibraries; + cmMakefile* Makefile; + cmTargetInternalPointer Internal; + cmState::TargetType TargetTypeValue; + bool HaveInstallRule; + bool RecordDependencies; + bool DLLPlatform; + bool IsAndroid; + bool IsImportedTarget; + bool ImportedGloballyVisible; + bool BuildInterfaceIncludesAppended; + + std::string ProcessSourceItemCMP0049(const std::string& s); + + /** Return whether or not the target has a DLL import library. */ + bool HasImportLibrary() const; + + // Internal representation details. + friend class cmTargetInternals; + friend class cmGeneratorTarget; + friend class cmTargetTraceDependencies; + + cmListFileBacktrace Backtrace; +}; + +#ifdef CMAKE_BUILD_WITH_CMAKE +#ifdef CMake_HAVE_CXX_UNORDERED_MAP +typedef std::unordered_map<std::string, cmTarget> cmTargets; +#else +typedef cmsys::hash_map<std::string, cmTarget> cmTargets; +#endif +#else +typedef std::map<std::string, cmTarget> cmTargets; +#endif + +class cmTargetSet : public std::set<std::string> +{ +}; +class cmTargetManifest : public std::map<std::string, cmTargetSet> +{ +}; + +#endif |