mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
517f5d6b6a
Way back in Swift 1 I was trying to draw a distinction between "overlays", separate libraries that added Swift content to an existing Objective-C framework, and "the Swift part of a mixed-source framework", even though they're implemented in almost exactly the same way. "Adapter module" was the term that covered both of those. In practice, however, no one knew what "adapter" meant. Bring an end to this confusion by just using "overlay" within the compiler even for the mixed-source framework case. No intended functionality change.
129 lines
4.3 KiB
C++
129 lines
4.3 KiB
C++
//===--- ClangImporterOptions.h ---------------------------------*- C++ -*-===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2014 - 2017 Apple Inc. and the Swift project authors
|
|
// Licensed under Apache License v2.0 with Runtime Library Exception
|
|
//
|
|
// See https://swift.org/LICENSE.txt for license information
|
|
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef SWIFT_CLANGIMPORTER_CLANGIMPORTEROPTIONS_H
|
|
#define SWIFT_CLANGIMPORTER_CLANGIMPORTEROPTIONS_H
|
|
|
|
#include "llvm/ADT/Hashing.h"
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
namespace swift {
|
|
|
|
/// Options for controlling the behavior of the Clang importer.
|
|
class ClangImporterOptions {
|
|
public:
|
|
/// The module cache path which the Clang importer should use.
|
|
std::string ModuleCachePath;
|
|
|
|
/// Extra arguments which should be passed to the Clang importer.
|
|
std::vector<std::string> ExtraArgs;
|
|
|
|
/// A directory for overriding Clang's resource directory.
|
|
std::string OverrideResourceDir;
|
|
|
|
/// The target CPU to compile for.
|
|
///
|
|
/// Equivalent to Clang's -mcpu=.
|
|
std::string TargetCPU;
|
|
|
|
/// The path to which we should store indexing data, if any.
|
|
std::string IndexStorePath;
|
|
|
|
/// The bridging header or PCH that will be imported.
|
|
std::string BridgingHeader;
|
|
|
|
/// When automatically generating a precompiled header from the bridging
|
|
/// header, place it in this directory.
|
|
std::string PrecompiledHeaderOutputDir;
|
|
|
|
/// The optimizaton setting. This doesn't typically matter for
|
|
/// import, but it can affect Clang's IR generation of static functions.
|
|
std::string Optimization;
|
|
|
|
/// Disable validating the persistent PCH.
|
|
bool PCHDisableValidation = false;
|
|
|
|
/// \see Mode
|
|
enum class Modes : uint8_t {
|
|
/// Set up Clang for importing modules into Swift and generating IR from
|
|
/// Swift code.
|
|
Normal,
|
|
/// Set up Clang for backend compilation only.
|
|
EmbedBitcode
|
|
};
|
|
|
|
/// Controls how Clang is initially set up.
|
|
Modes Mode = Modes::Normal;
|
|
|
|
/// When set, preserves more information during import.
|
|
///
|
|
/// Also \em disables some information that is only needed for object file
|
|
/// generation.
|
|
bool DetailedPreprocessingRecord = false;
|
|
|
|
/// If true, Clang diagnostics will be dumped to stderr using Clang's
|
|
/// diagnostic printer as well as being passed to Swift's diagnostic engine.
|
|
bool DumpClangDiagnostics = false;
|
|
|
|
/// If true, forward declarations will be imported using unavailable types
|
|
/// instead of dropped altogether when possible.
|
|
bool ImportForwardDeclarations = false;
|
|
|
|
/// Whether to use the import as member inference system
|
|
///
|
|
/// When importing a global, try to infer whether we can import it as a
|
|
/// member of some type instead. This includes inits, computed properties,
|
|
/// and methods.
|
|
bool InferImportAsMember = false;
|
|
|
|
/// If true ignore the swift bridged attribute.
|
|
bool DisableSwiftBridgeAttr = false;
|
|
|
|
/// When set, don't validate module system headers. If a header is modified
|
|
/// and this is not set, clang will rebuild the module.
|
|
bool DisableModulesValidateSystemHeaders = false;
|
|
|
|
/// When set, don't look for or load overlays.
|
|
bool DisableOverlayModules = false;
|
|
|
|
/// When set, don't enforce warnings with -Werror.
|
|
bool DebuggerSupport = false;
|
|
|
|
/// Return a hash code of any components from these options that should
|
|
/// contribute to a Swift Bridging PCH hash.
|
|
llvm::hash_code getPCHHashComponents() const {
|
|
using llvm::hash_value;
|
|
using llvm::hash_combine;
|
|
|
|
auto Code = hash_value(ModuleCachePath);
|
|
// ExtraArgs ignored - already considered in Clang's module hashing.
|
|
Code = hash_combine(Code, OverrideResourceDir);
|
|
Code = hash_combine(Code, TargetCPU);
|
|
Code = hash_combine(Code, BridgingHeader);
|
|
Code = hash_combine(Code, PrecompiledHeaderOutputDir);
|
|
Code = hash_combine(Code, static_cast<uint8_t>(Mode));
|
|
Code = hash_combine(Code, DetailedPreprocessingRecord);
|
|
Code = hash_combine(Code, ImportForwardDeclarations);
|
|
Code = hash_combine(Code, InferImportAsMember);
|
|
Code = hash_combine(Code, DisableSwiftBridgeAttr);
|
|
Code = hash_combine(Code, DisableModulesValidateSystemHeaders);
|
|
Code = hash_combine(Code, DisableOverlayModules);
|
|
return Code;
|
|
}
|
|
};
|
|
|
|
} // end namespace swift
|
|
|
|
#endif
|