diff options
Diffstat (limited to 'Source/cmTarget.h')
| -rw-r--r-- | Source/cmTarget.h | 283 |
1 files changed, 158 insertions, 125 deletions
diff --git a/Source/cmTarget.h b/Source/cmTarget.h index 27b74ca..e026c59 100644 --- a/Source/cmTarget.h +++ b/Source/cmTarget.h @@ -25,7 +25,9 @@ F(CMP0008) \ F(CMP0020) \ F(CMP0021) \ - F(CMP0022) + F(CMP0022) \ + F(CMP0041) \ + F(CMP0042) class cmake; class cmMakefile; @@ -34,11 +36,14 @@ class cmGlobalGenerator; class cmComputeLinkInformation; class cmListFileBacktrace; class cmTarget; +class cmGeneratorTarget; +class cmTargetTraceDependencies; struct cmTargetLinkInformationMap: - public std::map<std::pair<cmTarget*, std::string>, cmComputeLinkInformation*> + public std::map<std::pair<cmTarget const* , std::string>, + cmComputeLinkInformation*> { - typedef std::map<std::pair<cmTarget*, std::string>, + typedef std::map<std::pair<cmTarget const* , std::string>, cmComputeLinkInformation*> derived; cmTargetLinkInformationMap() {} cmTargetLinkInformationMap(cmTargetLinkInformationMap const& r); @@ -72,6 +77,7 @@ public: enum TargetType { EXECUTABLE, STATIC_LIBRARY, SHARED_LIBRARY, MODULE_LIBRARY, OBJECT_LIBRARY, UTILITY, GLOBAL_TARGET, + INTERFACE_LIBRARY, UNKNOWN_LIBRARY}; static const char* GetTargetTypeName(TargetType targetType); enum CustomCommandType { PRE_BUILD, PRE_LINK, POST_BUILD }; @@ -93,7 +99,7 @@ public: ///! Set/Get the name of the target const char* GetName() const {return this->Name.c_str();} - const char* GetExportName(); + const char* GetExportName() const; ///! Set the cmMakefile that owns this target void SetMakefile(cmMakefile *mf); @@ -110,26 +116,29 @@ public: /** * Get the list of the custom commands for this target */ - std::vector<cmCustomCommand> &GetPreBuildCommands() + std::vector<cmCustomCommand> const &GetPreBuildCommands() const {return this->PreBuildCommands;} - std::vector<cmCustomCommand> &GetPreLinkCommands() + std::vector<cmCustomCommand> const &GetPreLinkCommands() const {return this->PreLinkCommands;} - std::vector<cmCustomCommand> &GetPostBuildCommands() + 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);} /** * Get the list of the source files used by this target */ - std::vector<cmSourceFile*> const& GetSourceFiles(); + std::vector<cmSourceFile*> const& GetSourceFiles() const; void AddSourceFile(cmSourceFile* sf); std::vector<std::string> const& GetObjectLibraries() const { return this->ObjectLibraries; } - /** Get sources that must be built before the given source. */ - std::vector<cmSourceFile*> const* GetSourceDepends(cmSourceFile* sf); - /** * Flags for a given source file as used in this target. Typically assigned * via SET_TARGET_PROPERTIES when the property is a list of source files. @@ -155,7 +164,8 @@ public: /** * Get the flags for a given source file as used in this target */ - struct SourceFileFlags GetTargetSourceFileFlags(const cmSourceFile* sf); + struct SourceFileFlags + GetTargetSourceFileFlags(const cmSourceFile* sf) const; /** * Add sources to the target. @@ -175,10 +185,13 @@ public: {return this->OriginalLinkLibraries;} void GetDirectLinkLibraries(const char *config, std::vector<std::string> &, - cmTarget *head); + cmTarget const* head) const; + void GetInterfaceLinkLibraries(const char *config, + std::vector<std::string> &, + cmTarget const* head) const; /** Compute the link type to use for the given configuration. */ - LinkLibraryType ComputeLinkType(const char* config); + LinkLibraryType ComputeLinkType(const char* config) const; /** * Clear the dependency information recorded for this target, if any. @@ -186,7 +199,7 @@ public: void ClearDependencyInformation(cmMakefile& mf, const char* target); // Check to see if a library is a framework and treat it different on Mac - bool NameResolvesToFramework(const std::string& libname); + bool NameResolvesToFramework(const std::string& libname) const; void AddLinkLibrary(cmMakefile& mf, const char *target, const char* lib, LinkLibraryType llt); @@ -200,7 +213,7 @@ public: void MergeLinkLibraries( cmMakefile& mf, const char* selfname, const LinkLibraryVectorType& libs ); - const std::vector<std::string>& GetLinkDirectories(); + const std::vector<std::string>& GetLinkDirectories() const; void AddLinkDirectory(const char* d); @@ -208,21 +221,21 @@ public: * Set the path where this target should be installed. This is relative to * INSTALL_PREFIX */ - std::string GetInstallPath() {return this->InstallPath;} + 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() {return this->RuntimeInstallPath;} + 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() { return this->HaveInstallRule; } + 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 @@ -239,12 +252,12 @@ public: ///! Set/Get a property of this target file void SetProperty(const char *prop, const char *value); void AppendProperty(const char* prop, const char* value,bool asString=false); - const char *GetProperty(const char *prop); - const char *GetProperty(const char *prop, cmProperty::ScopeType scope); - bool GetPropertyAsBool(const char *prop); - void CheckProperty(const char* prop, cmMakefile* context); + const char *GetProperty(const char *prop) const; + const char *GetProperty(const char *prop, cmProperty::ScopeType scope) const; + bool GetPropertyAsBool(const char *prop) const; + void CheckProperty(const char* prop, cmMakefile* context) const; - const char* GetFeature(const char* feature, const char* config); + const char* GetFeature(const char* feature, const char* config) const; bool IsImported() const {return this->IsImportedTarget;} @@ -277,10 +290,10 @@ public: /** Get the link interface for the given configuration. Returns 0 if the target cannot be linked. */ LinkInterface const* GetLinkInterface(const char* config, - cmTarget *headTarget); + cmTarget const* headTarget) const; void GetTransitivePropertyLinkLibraries(const char* config, - cmTarget *headTarget, - std::vector<std::string> &libs); + cmTarget const* headTarget, + std::vector<std::string> &libs) const; /** The link implementation specifies the direct library dependencies needed by the object files of the target. */ @@ -297,7 +310,7 @@ public: std::vector<std::string> WrongConfigLibraries; }; LinkImplementation const* GetLinkImplementation(const char* config, - cmTarget *head); + cmTarget const* head) const; /** Link information from the transitive closure of the link implementation and the interfaces of its dependencies. */ @@ -309,44 +322,40 @@ public: // Languages whose runtime libraries must be linked. std::vector<std::string> Languages; }; - LinkClosure const* GetLinkClosure(const char* config, cmTarget *head); + LinkClosure const* GetLinkClosure(const char* config, + cmTarget const* head) const; /** Strip off leading and trailing whitespace from an item named in the link dependencies of this target. */ - std::string CheckCMP0004(std::string const& item); + std::string CheckCMP0004(std::string const& item) const; /** Get the directory in which this target will be built. If the configuration name is given then the generator will add its subdirectory for that configuration. Otherwise just the canonical output directory is given. */ - std::string GetDirectory(const char* config = 0, bool implib = false); + std::string GetDirectory(const char* config = 0, bool implib = false) const; /** Get the directory in which this targets .pdb files will be placed. If the configuration name is given then the generator will add its subdirectory for that configuration. Otherwise just the canonical pdb output directory is given. */ - std::string GetPDBDirectory(const char* config = 0); + std::string GetPDBDirectory(const char* config = 0) const; /** Get the location of the target in the build tree for the given configuration. This location is suitable for use as the LOCATION target property. */ - const char* GetLocation(const char* config); + const char* GetLocation(const char* config) const; /** Get the target major and minor version numbers interpreted from the VERSION property. Version 0 is returned if the property is not set or cannot be parsed. */ - void GetTargetVersion(int& major, int& minor); + void GetTargetVersion(int& major, int& minor) const; /** Get the target major, minor, and patch version numbers interpreted from the VERSION or SOVERSION property. Version 0 is returned if the property is not set or cannot be parsed. */ - void GetTargetVersion(bool soversion, int& major, int& minor, int& patch); - - /** - * Trace through the source files in this target and add al source files - * that they depend on, used by all generators - */ - void TraceDependencies(); + void + GetTargetVersion(bool soversion, int& major, int& minor, int& patch) const; /** * Make sure the full path to all source files is known. @@ -354,101 +363,102 @@ public: bool FindSourceFiles(); ///! Return the preferred linker language for this target - const char* GetLinkerLanguage(const char* config = 0, cmTarget *head = 0); + const char* GetLinkerLanguage(const char* config = 0, + cmTarget const* head = 0) const; /** Get the full name of the target according to the settings in its makefile. */ - std::string GetFullName(const char* config=0, bool implib = false); + std::string GetFullName(const char* config=0, bool implib = false) const; void GetFullNameComponents(std::string& prefix, std::string& base, std::string& suffix, - const char* config=0, bool implib = false); + const char* config=0, bool implib = false) const; /** Get the name of the pdb file for the target. */ - std::string GetPDBName(const char* config=0); + std::string GetPDBName(const char* config=0) const; /** Whether this library has soname enabled and platform supports it. */ - bool HasSOName(const char* config); + bool HasSOName(const char* config) const; /** Get the soname of the target. Allowed only for a shared library. */ - std::string GetSOName(const char* config); + std::string GetSOName(const char* config) const; + + /** Whether this library has \@rpath and platform supports it. */ + bool HasMacOSXRpathInstallNameDir(const char* config) const; - /** Whether this library has @rpath and platform supports it. */ - bool HasMacOSXRpath(const char* config); + /** Whether this library defaults to \@rpath. */ + bool MacOSXRpathInstallNameDirDefault() const; /** Test for special case of a third-party shared library that has no soname at all. */ - bool IsImportedSharedLibWithoutSOName(const char* config); + bool IsImportedSharedLibWithoutSOName(const char* config) const; /** Get the full path to the target according to the settings in its makefile and the configuration type. */ std::string GetFullPath(const char* config=0, bool implib = false, - bool realname = false); + bool realname = false) const; /** Get the names of the library needed to generate a build rule that takes into account shared library version numbers. This should be called only on a library target. */ void GetLibraryNames(std::string& name, std::string& soName, std::string& realName, std::string& impName, - std::string& pdbName, const char* config); + std::string& pdbName, const char* config) const; /** Get the names of the executable needed to generate a build rule that takes into account executable version numbers. This should be called only on an executable target. */ void GetExecutableNames(std::string& name, std::string& realName, std::string& impName, - std::string& pdbName, const char* config); + std::string& pdbName, const char* config) const; /** Does this target have a GNU implib to convert to MS format? */ - bool HasImplibGNUtoMS(); + bool HasImplibGNUtoMS() const; /** Convert the given GNU import library name (.dll.a) to a name with a new extension (.lib or ${CMAKE_IMPORT_LIBRARY_SUFFIX}). */ bool GetImplibGNUtoMS(std::string const& gnuName, std::string& out, - const char* newExt = 0); - - /** Add the target output files to the global generator manifest. */ - void GenerateTargetManifest(const char* config); + const char* newExt = 0) const; /** * Compute whether this target must be relinked before installing. */ - bool NeedRelinkBeforeInstall(const char* config); + bool NeedRelinkBeforeInstall(const char* config) const; - bool HaveBuildTreeRPATH(const char *config); - bool HaveInstallTreeRPATH(); + bool HaveBuildTreeRPATH(const char *config) const; + bool HaveInstallTreeRPATH() const; /** Return true if builtin chrpath will work for this target */ - bool IsChrpathUsed(const char* config); + bool IsChrpathUsed(const char* config) const; /** Return the install name directory for the target in the - * build tree. For example: "@rpath/", "@loader_path/", + * build tree. For example: "\@rpath/", "\@loader_path/", * or "/full/path/to/library". */ - std::string GetInstallNameDirForBuildTree(const char* config); + std::string GetInstallNameDirForBuildTree(const char* config) const; /** Return the install name directory for the target in the - * install tree. For example: "@rpath/" or "@loader_path/". */ - std::string GetInstallNameDirForInstallTree(); + * install tree. For example: "\@rpath/" or "\@loader_path/". */ + std::string GetInstallNameDirForInstallTree() const; cmComputeLinkInformation* GetLinkInformation(const char* config, - cmTarget *head = 0); + cmTarget const* head = 0) const; // Get the properties - cmPropertyMap &GetProperties() { return this->Properties; }; + cmPropertyMap &GetProperties() const { return this->Properties; }; bool GetMappedConfig(std::string const& desired_config, const char** loc, const char** imp, - std::string& suffix); + std::string& suffix) const; // Define the properties static void DefineProperties(cmake *cm); /** Get the macro to define when building sources in this target. If no macro should be defined null is returned. */ - const char* GetExportMacro(); + const char* GetExportMacro() const; void GetCompileDefinitions(std::vector<std::string> &result, - const char *config); + const char *config) const; // Compute the set of languages compiled by the target. This is // computed every time it is called because the languages can change @@ -459,34 +469,34 @@ public: /** Return whether this target is an executable with symbol exports enabled. */ - bool IsExecutableWithExports(); + bool IsExecutableWithExports() const; /** Return whether this target may be used to link another target. */ - bool IsLinkable(); + bool IsLinkable() const; /** Return whether or not the target is for a DLL platform. */ - bool IsDLLPlatform() { return this->DLLPlatform; } + bool IsDLLPlatform() const { return this->DLLPlatform; } /** Return whether or not the target has a DLL import library. */ - bool HasImportLibrary(); + bool HasImportLibrary() const; /** Return whether this target is a shared library Framework on Apple. */ - bool IsFrameworkOnApple(); + bool IsFrameworkOnApple() const; /** Return whether this target is a CFBundle (plugin) on Apple. */ - bool IsCFBundleOnApple(); + bool IsCFBundleOnApple() const; /** Return whether this target is an executable Bundle on Apple. */ - bool IsAppBundleOnApple(); + bool IsAppBundleOnApple() const; /** Return whether this target is an executable Bundle, a framework or CFBundle on Apple. */ - bool IsBundleOnApple(); + bool IsBundleOnApple() const; /** Return the framework version string. Undefined if IsFrameworkOnApple returns false. */ - std::string GetFrameworkVersion(); + std::string GetFrameworkVersion() const; /** Get a backtrace from the creation of the target. */ cmListFileBacktrace const& GetBacktrace() const; @@ -496,25 +506,26 @@ public: /** Return whether this target uses the default value for its output directory. */ - bool UsesDefaultOutputDir(const char* config, bool implib); + bool UsesDefaultOutputDir(const char* config, bool implib) const; /** @return the mac content directory for this target. */ std::string GetMacContentDirectory(const char* config, - bool implib); + bool implib) const; /** @return whether this target have a well defined output file name. */ - bool HaveWellDefinedOutputFiles(); + bool HaveWellDefinedOutputFiles() const; /** @return the Mac framework directory without the base. */ - std::string GetFrameworkDirectory(const char* config, bool rootDir); + std::string GetFrameworkDirectory(const char* config, bool rootDir) const; /** @return the Mac CFBundle directory without the base */ - std::string GetCFBundleDirectory(const char* config, bool contentOnly); + std::string GetCFBundleDirectory(const char* config, bool contentOnly) const; /** @return the Mac App directory without the base */ - std::string GetAppBundleDirectory(const char* config, bool contentOnly); + std::string GetAppBundleDirectory(const char* config, + bool contentOnly) const; - std::vector<std::string> GetIncludeDirectories(const char *config); + std::vector<std::string> GetIncludeDirectories(const char *config) const; void InsertInclude(const cmValueWithOrigin &entry, bool before = false); void InsertCompileOption(const cmValueWithOrigin &entry, @@ -525,22 +536,32 @@ public: void AppendBuildInterfaceIncludes(); void GetCompileOptions(std::vector<std::string> &result, - const char *config); + const char *config) const; + void GetAutoUicOptions(std::vector<std::string> &result, + const char *config) const; - bool IsNullImpliedByLinkLibraries(const std::string &p); + bool IsNullImpliedByLinkLibraries(const std::string &p) const; bool IsLinkInterfaceDependentBoolProperty(const std::string &p, - const char *config); + const char *config) const; bool IsLinkInterfaceDependentStringProperty(const std::string &p, - const char *config); + const char *config) const; + bool IsLinkInterfaceDependentNumberMinProperty(const std::string &p, + const char *config) const; + bool IsLinkInterfaceDependentNumberMaxProperty(const std::string &p, + const char *config) const; bool GetLinkInterfaceDependentBoolProperty(const std::string &p, - const char *config); + const char *config) const; const char *GetLinkInterfaceDependentStringProperty(const std::string &p, - const char *config); + const char *config) const; + const char *GetLinkInterfaceDependentNumberMinProperty(const std::string &p, + const char *config) const; + const char *GetLinkInterfaceDependentNumberMaxProperty(const std::string &p, + const char *config) const; std::string GetDebugGeneratorExpressions(const std::string &value, - cmTarget::LinkLibraryType llt); + cmTarget::LinkLibraryType llt) const; void AddSystemIncludeDirectories(const std::set<cmStdString> &incs); void AddSystemIncludeDirectories(const std::vector<std::string> &incs); @@ -552,7 +573,14 @@ public: bool LinkLanguagePropagatesToDependents() const { return this->TargetTypeValue == STATIC_LIBRARY; } + void ReportPropertyOrigin(const std::string &p, + const std::string &result, + const std::string &report, + const std::string &compatibilityType) const; + private: + bool HandleLocationPropertyPolicy() const; + // The set of include directories that are marked as system include // directories. std::set<cmStdString> SystemIncludeDirectories; @@ -610,42 +638,42 @@ private: void AnalyzeLibDependencies( const cmMakefile& mf ); - const char* GetSuffixVariableInternal(bool implib); - const char* GetPrefixVariableInternal(bool implib); - std::string GetFullNameInternal(const char* config, bool implib); + const char* GetSuffixVariableInternal(bool implib) const; + const char* GetPrefixVariableInternal(bool implib) const; + std::string GetFullNameInternal(const char* config, bool implib) const; void GetFullNameInternal(const char* config, bool implib, std::string& outPrefix, std::string& outBase, - std::string& outSuffix); + std::string& outSuffix) 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 char* property, const char* default_value); // Returns ARCHIVE, LIBRARY, or RUNTIME based on platform and type. - const char* GetOutputTargetType(bool implib); + const char* GetOutputTargetType(bool implib) const; // Get the target base name. - std::string GetOutputName(const char* config, bool implib); + std::string GetOutputName(const char* config, bool implib) const; - const char* ImportedGetLocation(const char* config); - const char* NormalGetLocation(const char* config); + const char* ImportedGetLocation(const char* config) const; + const char* NormalGetLocation(const char* config) const; - std::string GetFullNameImported(const char* config, bool implib); + std::string GetFullNameImported(const char* config, bool implib) const; - std::string ImportedGetFullPath(const char* config, bool implib); + std::string ImportedGetFullPath(const char* config, bool implib) const; std::string NormalGetFullPath(const char* config, bool implib, - bool realname); + bool realname) const; /** Get the real name of the target. Allowed only for non-imported targets. When a library or executable file is versioned this is the full versioned name. If the target is not versioned this is the same as GetFullName. */ - std::string NormalGetRealName(const char* config); + std::string NormalGetRealName(const char* config) const; /** Append to @a base the mac content directory and return it. */ std::string BuildMacContentDirectory(const std::string& base, const char* config, - bool contentOnly); + bool contentOnly) const; private: std::string Name; @@ -663,44 +691,47 @@ private: bool HaveInstallRule; std::string InstallPath; std::string RuntimeInstallPath; - std::string Location; - std::string ExportMacro; + mutable std::string ExportMacro; std::set<cmStdString> Utilities; bool RecordDependencies; - cmPropertyMap Properties; + mutable cmPropertyMap Properties; LinkLibraryVectorType OriginalLinkLibraries; bool DLLPlatform; bool IsApple; bool IsImportedTarget; - bool DebugIncludesDone; - bool DebugCompileOptionsDone; - bool DebugCompileDefinitionsDone; + mutable bool DebugIncludesDone; + mutable std::map<std::string, bool> DebugCompatiblePropertiesDone; + mutable bool DebugCompileOptionsDone; + mutable bool DebugCompileDefinitionsDone; mutable std::set<std::string> LinkImplicitNullProperties; bool BuildInterfaceIncludesAppended; // Cache target output paths for each configuration. struct OutputInfo; - OutputInfo const* GetOutputInfo(const char* config); - bool ComputeOutputDir(const char* config, bool implib, std::string& out); - bool ComputePDBOutputDir(const char* config, std::string& out); + OutputInfo const* GetOutputInfo(const char* config) const; + bool + ComputeOutputDir(const char* config, bool implib, std::string& out) const; + bool ComputePDBOutputDir(const char* config, std::string& out) const; // Cache import information from properties for each configuration. struct ImportInfo; ImportInfo const* GetImportInfo(const char* config, - cmTarget *workingTarget); + cmTarget const* workingTarget) const; void ComputeImportInfo(std::string const& desired_config, ImportInfo& info, - cmTarget *head); + cmTarget const* head) const; - cmTargetLinkInformationMap LinkInformation; + mutable cmTargetLinkInformationMap LinkInformation; void CheckPropertyCompatibility(cmComputeLinkInformation *info, - const char* config); + const char* config) const; bool ComputeLinkInterface(const char* config, LinkInterface& iface, - cmTarget *head); + cmTarget const* head) const; void ComputeLinkImplementation(const char* config, - LinkImplementation& impl, cmTarget *head); - void ComputeLinkClosure(const char* config, LinkClosure& lc, cmTarget *head); + LinkImplementation& impl, + cmTarget const* head) const; + void ComputeLinkClosure(const char* config, LinkClosure& lc, + cmTarget const* head) const; void ClearLinkMaps(); @@ -722,15 +753,17 @@ private: // Internal representation details. friend class cmTargetInternals; + friend class cmGeneratorTarget; + friend class cmTargetTraceDependencies; cmTargetInternalPointer Internal; - void ConstructSourceFileFlags(); + void ConstructSourceFileFlags() const; void ComputeVersionedName(std::string& vName, std::string const& prefix, std::string const& base, std::string const& suffix, std::string const& name, - const char* version); + const char* version) const; }; typedef std::map<cmStdString,cmTarget> cmTargets; |