mirror of
https://github.com/Kitware/CMake.git
synced 2025-05-09 23:08:18 +08:00
bdca8b01d2
#pragma once is a widely supported compiler pragma, even though it is not part of the C++ standard. Many of the issues keeping #pragma once from being standardized (distributed filesystems, build farms, hard links, etc.) do not apply to CMake - it is easy to build CMake on a single machine. CMake also does not install any header files which can be consumed by other projects (though cmCPluginAPI.h has been deliberately omitted from this conversion in case anyone is still using it.) Finally, #pragma once has been required to build CMake since at least August 2017 (7f29bbe6 enabled server mode unconditionally, which had been using #pragma once since September 2016 (b13d3e0d)). The fact that we now require C++11 filters out old compilers, and it is unlikely that there is a compiler which supports C++11 but does not support #pragma once.
225 lines
9.2 KiB
C++
225 lines
9.2 KiB
C++
/* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
|
file Copyright.txt or https://cmake.org/licensing for details. */
|
|
#pragma once
|
|
|
|
#include "cmConfigure.h" // IWYU pragma: keep
|
|
|
|
#include <iosfwd>
|
|
#include <map>
|
|
#include <set>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "cmGeneratorExpression.h"
|
|
#include "cmStateTypes.h"
|
|
#include "cmVersion.h"
|
|
#include "cmVersionConfig.h"
|
|
|
|
class cmGeneratorTarget;
|
|
|
|
#define STRINGIFY_HELPER(X) #X
|
|
#define STRINGIFY(X) STRINGIFY_HELPER(X)
|
|
|
|
#define DEVEL_CMAKE_VERSION(major, minor) \
|
|
(CMake_VERSION_ENCODE(major, minor, 0) > \
|
|
CMake_VERSION_ENCODE(CMake_VERSION_MAJOR, CMake_VERSION_MINOR, 0) \
|
|
? STRINGIFY(CMake_VERSION_MAJOR) "." STRINGIFY( \
|
|
CMake_VERSION_MINOR) "." STRINGIFY(CMake_VERSION_PATCH) \
|
|
: #major "." #minor ".0")
|
|
|
|
class cmTargetExport;
|
|
|
|
/** \class cmExportFileGenerator
|
|
* \brief Generate a file exporting targets from a build or install tree.
|
|
*
|
|
* cmExportFileGenerator is the superclass for
|
|
* cmExportBuildFileGenerator and cmExportInstallFileGenerator. It
|
|
* contains common code generation routines for the two kinds of
|
|
* export implementations.
|
|
*/
|
|
class cmExportFileGenerator
|
|
{
|
|
public:
|
|
cmExportFileGenerator();
|
|
virtual ~cmExportFileGenerator() = default;
|
|
|
|
/** Set the full path to the export file to generate. */
|
|
void SetExportFile(const char* mainFile);
|
|
const std::string& GetMainExportFileName() const;
|
|
|
|
/** Set the namespace in which to place exported target names. */
|
|
void SetNamespace(const std::string& ns) { this->Namespace = ns; }
|
|
std::string GetNamespace() const { return this->Namespace; }
|
|
|
|
void SetExportOld(bool exportOld) { this->ExportOld = exportOld; }
|
|
|
|
/** Add a configuration to be exported. */
|
|
void AddConfiguration(const std::string& config);
|
|
|
|
/** Actually generate the export file. Returns whether there was an
|
|
error. */
|
|
bool GenerateImportFile();
|
|
|
|
protected:
|
|
using ImportPropertyMap = std::map<std::string, std::string>;
|
|
|
|
// Generate per-configuration target information to the given output
|
|
// stream.
|
|
void GenerateImportConfig(std::ostream& os, const std::string& config,
|
|
std::vector<std::string>& missingTargets);
|
|
|
|
// Methods to implement export file code generation.
|
|
virtual void GeneratePolicyHeaderCode(std::ostream& os);
|
|
virtual void GeneratePolicyFooterCode(std::ostream& os);
|
|
virtual void GenerateImportHeaderCode(std::ostream& os,
|
|
const std::string& config = "");
|
|
virtual void GenerateImportFooterCode(std::ostream& os);
|
|
void GenerateImportVersionCode(std::ostream& os);
|
|
virtual void GenerateImportTargetCode(std::ostream& os,
|
|
cmGeneratorTarget const* target,
|
|
cmStateEnums::TargetType targetType);
|
|
virtual void GenerateImportPropertyCode(std::ostream& os,
|
|
const std::string& config,
|
|
cmGeneratorTarget const* target,
|
|
ImportPropertyMap const& properties);
|
|
virtual void GenerateImportedFileChecksCode(
|
|
std::ostream& os, cmGeneratorTarget* target,
|
|
ImportPropertyMap const& properties,
|
|
const std::set<std::string>& importedLocations);
|
|
virtual void GenerateImportedFileCheckLoop(std::ostream& os);
|
|
virtual void GenerateMissingTargetsCheckCode(
|
|
std::ostream& os, const std::vector<std::string>& missingTargets);
|
|
|
|
virtual void GenerateExpectedTargetsCode(std::ostream& os,
|
|
const std::string& expectedTargets);
|
|
|
|
// Collect properties with detailed information about targets beyond
|
|
// their location on disk.
|
|
void SetImportDetailProperties(const std::string& config,
|
|
std::string const& suffix,
|
|
cmGeneratorTarget* target,
|
|
ImportPropertyMap& properties,
|
|
std::vector<std::string>& missingTargets);
|
|
|
|
enum class ImportLinkPropertyTargetNames
|
|
{
|
|
Yes,
|
|
No,
|
|
};
|
|
template <typename T>
|
|
void SetImportLinkProperty(std::string const& suffix,
|
|
cmGeneratorTarget* target,
|
|
const std::string& propName,
|
|
std::vector<T> const& entries,
|
|
ImportPropertyMap& properties,
|
|
std::vector<std::string>& missingTargets,
|
|
ImportLinkPropertyTargetNames targetNames);
|
|
|
|
/** Each subclass knows how to generate its kind of export file. */
|
|
virtual bool GenerateMainFile(std::ostream& os) = 0;
|
|
|
|
/** Each subclass knows where the target files are located. */
|
|
virtual void GenerateImportTargetsConfig(
|
|
std::ostream& os, const std::string& config, std::string const& suffix,
|
|
std::vector<std::string>& missingTargets) = 0;
|
|
|
|
/** Each subclass knows how to deal with a target that is missing from an
|
|
* export set. */
|
|
virtual void HandleMissingTarget(std::string& link_libs,
|
|
std::vector<std::string>& missingTargets,
|
|
cmGeneratorTarget* depender,
|
|
cmGeneratorTarget* dependee) = 0;
|
|
void PopulateInterfaceProperty(const std::string&, cmGeneratorTarget* target,
|
|
cmGeneratorExpression::PreprocessContext,
|
|
ImportPropertyMap& properties,
|
|
std::vector<std::string>& missingTargets);
|
|
bool PopulateInterfaceLinkLibrariesProperty(
|
|
cmGeneratorTarget* target, cmGeneratorExpression::PreprocessContext,
|
|
ImportPropertyMap& properties, std::vector<std::string>& missingTargets);
|
|
void PopulateInterfaceProperty(const std::string& propName,
|
|
cmGeneratorTarget* target,
|
|
ImportPropertyMap& properties);
|
|
void PopulateCompatibleInterfaceProperties(cmGeneratorTarget* target,
|
|
ImportPropertyMap& properties);
|
|
virtual void GenerateInterfaceProperties(
|
|
cmGeneratorTarget const* target, std::ostream& os,
|
|
const ImportPropertyMap& properties);
|
|
void PopulateIncludeDirectoriesInterface(
|
|
cmTargetExport* target,
|
|
cmGeneratorExpression::PreprocessContext preprocessRule,
|
|
ImportPropertyMap& properties, std::vector<std::string>& missingTargets);
|
|
void PopulateSourcesInterface(
|
|
cmTargetExport* target,
|
|
cmGeneratorExpression::PreprocessContext preprocessRule,
|
|
ImportPropertyMap& properties, std::vector<std::string>& missingTargets);
|
|
void PopulateLinkDirectoriesInterface(
|
|
cmTargetExport* target,
|
|
cmGeneratorExpression::PreprocessContext preprocessRule,
|
|
ImportPropertyMap& properties, std::vector<std::string>& missingTargets);
|
|
void PopulateLinkDependsInterface(
|
|
cmTargetExport* target,
|
|
cmGeneratorExpression::PreprocessContext preprocessRule,
|
|
ImportPropertyMap& properties, std::vector<std::string>& missingTargets);
|
|
|
|
void SetImportLinkInterface(
|
|
const std::string& config, std::string const& suffix,
|
|
cmGeneratorExpression::PreprocessContext preprocessRule,
|
|
cmGeneratorTarget* target, ImportPropertyMap& properties,
|
|
std::vector<std::string>& missingTargets);
|
|
|
|
enum FreeTargetsReplace
|
|
{
|
|
ReplaceFreeTargets,
|
|
NoReplaceFreeTargets
|
|
};
|
|
|
|
void ResolveTargetsInGeneratorExpressions(
|
|
std::string& input, cmGeneratorTarget* target,
|
|
std::vector<std::string>& missingTargets,
|
|
FreeTargetsReplace replace = NoReplaceFreeTargets);
|
|
|
|
virtual void GenerateRequiredCMakeVersion(std::ostream& os,
|
|
const char* versionString);
|
|
|
|
bool PopulateExportProperties(cmGeneratorTarget* gte,
|
|
ImportPropertyMap& properties,
|
|
std::string& errorMessage);
|
|
|
|
// The namespace in which the exports are placed in the generated file.
|
|
std::string Namespace;
|
|
|
|
bool ExportOld;
|
|
|
|
// The set of configurations to export.
|
|
std::vector<std::string> Configurations;
|
|
|
|
// The file to generate.
|
|
std::string MainImportFile;
|
|
std::string FileDir;
|
|
std::string FileBase;
|
|
std::string FileExt;
|
|
bool AppendMode;
|
|
|
|
// The set of targets included in the export.
|
|
std::set<cmGeneratorTarget*> ExportedTargets;
|
|
|
|
private:
|
|
void PopulateInterfaceProperty(const std::string&, const std::string&,
|
|
cmGeneratorTarget* target,
|
|
cmGeneratorExpression::PreprocessContext,
|
|
ImportPropertyMap& properties,
|
|
std::vector<std::string>& missingTargets);
|
|
|
|
bool AddTargetNamespace(std::string& input, cmGeneratorTarget* target,
|
|
std::vector<std::string>& missingTargets);
|
|
|
|
void ResolveTargetsInGeneratorExpression(
|
|
std::string& input, cmGeneratorTarget* target,
|
|
std::vector<std::string>& missingTargets);
|
|
|
|
virtual void ReplaceInstallPrefix(std::string& input);
|
|
|
|
virtual std::string InstallNameDir(cmGeneratorTarget* target,
|
|
const std::string& config) = 0;
|
|
};
|