cmGlobalXCodeGenerator.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286
  1. /* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
  2. file Copyright.txt or https://cmake.org/licensing for details. */
  3. #ifndef cmGlobalXCodeGenerator_h
  4. #define cmGlobalXCodeGenerator_h
  5. #include "cmConfigure.h" // IWYU pragma: keep
  6. #include <iosfwd>
  7. #include <map>
  8. #include <set>
  9. #include <string>
  10. #include <vector>
  11. #include "cmGlobalGenerator.h"
  12. #include "cmXCodeObject.h"
  13. class cmCustomCommand;
  14. class cmGeneratorTarget;
  15. class cmGlobalGeneratorFactory;
  16. class cmLocalGenerator;
  17. class cmMakefile;
  18. class cmSourceFile;
  19. class cmSourceGroup;
  20. class cmake;
  21. struct cmDocumentationEntry;
  22. /** \class cmGlobalXCodeGenerator
  23. * \brief Write a Unix makefiles.
  24. *
  25. * cmGlobalXCodeGenerator manages UNIX build process for a tree
  26. */
  27. class cmGlobalXCodeGenerator : public cmGlobalGenerator
  28. {
  29. public:
  30. cmGlobalXCodeGenerator(cmake* cm, std::string const& version_string,
  31. unsigned int version_number);
  32. static cmGlobalGeneratorFactory* NewFactory();
  33. ///! Get the name for the generator.
  34. std::string GetName() const override
  35. {
  36. return cmGlobalXCodeGenerator::GetActualName();
  37. }
  38. static std::string GetActualName() { return "Xcode"; }
  39. /** Get the documentation entry for this generator. */
  40. static void GetDocumentation(cmDocumentationEntry& entry);
  41. ///! Create a local generator appropriate to this Global Generator
  42. cmLocalGenerator* CreateLocalGenerator(cmMakefile* mf) override;
  43. /**
  44. * Try to determine system information such as shared library
  45. * extension, pthreads, byte order etc.
  46. */
  47. void EnableLanguage(std::vector<std::string> const& languages, cmMakefile*,
  48. bool optional) override;
  49. /**
  50. * Open a generated IDE project given the following information.
  51. */
  52. bool Open(const std::string& bindir, const std::string& projectName,
  53. bool dryRun) override;
  54. /**
  55. * Try running cmake and building a file. This is used for dynalically
  56. * loaded commands, not as part of the usual build process.
  57. */
  58. void GenerateBuildCommand(std::vector<std::string>& makeCommand,
  59. const std::string& makeProgram,
  60. const std::string& projectName,
  61. const std::string& projectDir,
  62. const std::string& targetName,
  63. const std::string& config, bool fast, bool verbose,
  64. std::vector<std::string> const& makeOptions =
  65. std::vector<std::string>()) override;
  66. /** Append the subdirectory for the given configuration. */
  67. void AppendDirectoryForConfig(const std::string& prefix,
  68. const std::string& config,
  69. const std::string& suffix,
  70. std::string& dir) override;
  71. bool FindMakeProgram(cmMakefile*) override;
  72. ///! What is the configurations directory variable called?
  73. const char* GetCMakeCFGIntDir() const override;
  74. ///! expand CFGIntDir
  75. std::string ExpandCFGIntDir(const std::string& str,
  76. const std::string& config) const override;
  77. void SetCurrentLocalGenerator(cmLocalGenerator*);
  78. /** Return true if the generated build tree may contain multiple builds.
  79. i.e. "Can I build Debug and Release in the same tree?" */
  80. bool IsMultiConfig() const override;
  81. bool HasKnownObjectFileLocation(std::string* reason) const override;
  82. bool IsIPOSupported() const override { return true; }
  83. bool UseEffectivePlatformName(cmMakefile* mf) const override;
  84. bool ShouldStripResourcePath(cmMakefile*) const override;
  85. bool SetGeneratorToolset(std::string const& ts, cmMakefile* mf) override;
  86. void AppendFlag(std::string& flags, std::string const& flag) const;
  87. protected:
  88. void AddExtraIDETargets() override;
  89. void Generate() override;
  90. private:
  91. cmXCodeObject* CreateOrGetPBXGroup(cmGeneratorTarget* gtgt,
  92. cmSourceGroup* sg);
  93. cmXCodeObject* CreatePBXGroup(cmXCodeObject* parent,
  94. const std::string& name);
  95. bool CreateGroups(std::vector<cmLocalGenerator*>& generators);
  96. std::string XCodeEscapePath(const std::string& p);
  97. std::string RelativeToSource(const char* p);
  98. std::string RelativeToBinary(const char* p);
  99. std::string ConvertToRelativeForMake(std::string const& p);
  100. void CreateCustomCommands(cmXCodeObject* buildPhases,
  101. cmXCodeObject* sourceBuildPhase,
  102. cmXCodeObject* headerBuildPhase,
  103. cmXCodeObject* resourceBuildPhase,
  104. std::vector<cmXCodeObject*> contentBuildPhases,
  105. cmXCodeObject* frameworkBuildPhase,
  106. cmGeneratorTarget* gtgt);
  107. std::string ComputeInfoPListLocation(cmGeneratorTarget* target);
  108. void AddCommandsToBuildPhase(cmXCodeObject* buildphase,
  109. cmGeneratorTarget* target,
  110. std::vector<cmCustomCommand> const& commands,
  111. const char* commandFileName);
  112. void CreateCustomRulesMakefile(const char* makefileBasename,
  113. cmGeneratorTarget* target,
  114. std::vector<cmCustomCommand> const& commands,
  115. const std::string& configName);
  116. cmXCodeObject* FindXCodeTarget(const cmGeneratorTarget*);
  117. std::string GetOrCreateId(const std::string& name, const std::string& id);
  118. // create cmXCodeObject from these functions so that memory can be managed
  119. // correctly. All objects created are stored in this->XCodeObjects.
  120. cmXCodeObject* CreateObject(cmXCodeObject::PBXType ptype);
  121. cmXCodeObject* CreateObject(cmXCodeObject::Type type);
  122. cmXCodeObject* CreateString(const std::string& s);
  123. cmXCodeObject* CreateObjectReference(cmXCodeObject*);
  124. cmXCodeObject* CreateFlatClone(cmXCodeObject*);
  125. cmXCodeObject* CreateXCodeTarget(cmGeneratorTarget* gtgt,
  126. cmXCodeObject* buildPhases);
  127. void ForceLinkerLanguages() override;
  128. void ForceLinkerLanguage(cmGeneratorTarget* gtgt);
  129. const char* GetTargetLinkFlagsVar(const cmGeneratorTarget* target) const;
  130. const char* GetTargetFileType(cmGeneratorTarget* target);
  131. const char* GetTargetProductType(cmGeneratorTarget* target);
  132. std::string AddConfigurations(cmXCodeObject* target,
  133. cmGeneratorTarget* gtgt);
  134. void AppendOrAddBuildSetting(cmXCodeObject* settings, const char* attr,
  135. const char* value);
  136. void AppendBuildSettingAttribute(cmXCodeObject* target, const char* attr,
  137. const char* value,
  138. const std::string& configName);
  139. cmXCodeObject* CreateUtilityTarget(cmGeneratorTarget* gtgt);
  140. void AddDependAndLinkInformation(cmXCodeObject* target);
  141. void CreateBuildSettings(cmGeneratorTarget* gtgt,
  142. cmXCodeObject* buildSettings,
  143. const std::string& buildType);
  144. std::string ExtractFlag(const char* flag, std::string& flags);
  145. std::string ExtractFlagRegex(const char* exp, int matchIndex,
  146. std::string& flags);
  147. void FilterConfigurationAttribute(std::string const& configName,
  148. std::string& attribute);
  149. void SortXCodeObjects();
  150. // delete all objects in the this->XCodeObjects vector.
  151. void ClearXCodeObjects();
  152. bool CreateXCodeObjects(cmLocalGenerator* root,
  153. std::vector<cmLocalGenerator*>& generators);
  154. void OutputXCodeProject(cmLocalGenerator* root,
  155. std::vector<cmLocalGenerator*>& generators);
  156. // Write shared scheme files for all the native targets
  157. void OutputXCodeSharedSchemes(const std::string& xcProjDir);
  158. void OutputXCodeWorkspaceSettings(const std::string& xcProjDir);
  159. void WriteXCodePBXProj(std::ostream& fout, cmLocalGenerator* root,
  160. std::vector<cmLocalGenerator*>& generators);
  161. cmXCodeObject* CreateXCodeFileReferenceFromPath(const std::string& fullpath,
  162. cmGeneratorTarget* target,
  163. const std::string& lang,
  164. cmSourceFile* sf);
  165. cmXCodeObject* CreateXCodeSourceFileFromPath(const std::string& fullpath,
  166. cmGeneratorTarget* target,
  167. const std::string& lang,
  168. cmSourceFile* sf);
  169. cmXCodeObject* CreateXCodeFileReference(cmSourceFile* sf,
  170. cmGeneratorTarget* target);
  171. cmXCodeObject* CreateXCodeSourceFile(cmLocalGenerator* gen, cmSourceFile* sf,
  172. cmGeneratorTarget* gtgt);
  173. bool CreateXCodeTargets(cmLocalGenerator* gen, std::vector<cmXCodeObject*>&);
  174. bool IsHeaderFile(cmSourceFile*);
  175. void AddDependTarget(cmXCodeObject* target, cmXCodeObject* dependTarget);
  176. void CreateXCodeDependHackTarget(std::vector<cmXCodeObject*>& targets);
  177. bool SpecialTargetEmitted(std::string const& tname);
  178. void SetGenerationRoot(cmLocalGenerator* root);
  179. void AddExtraTargets(cmLocalGenerator* root,
  180. std::vector<cmLocalGenerator*>& gens);
  181. cmXCodeObject* CreateBuildPhase(const char* name, const char* name2,
  182. cmGeneratorTarget* target,
  183. const std::vector<cmCustomCommand>&);
  184. void CreateReRunCMakeFile(cmLocalGenerator* root,
  185. std::vector<cmLocalGenerator*> const& gens);
  186. std::string LookupFlags(const std::string& varNamePrefix,
  187. const std::string& varNameLang,
  188. const std::string& varNameSuffix,
  189. const std::string& default_flags);
  190. class Factory;
  191. class BuildObjectListOrString;
  192. friend class BuildObjectListOrString;
  193. void AppendDefines(BuildObjectListOrString& defs, const char* defines_list,
  194. bool dflag = false);
  195. void AppendDefines(BuildObjectListOrString& defs,
  196. std::vector<std::string> const& defines,
  197. bool dflag = false);
  198. void ComputeTargetObjectDirectory(cmGeneratorTarget* gt) const override;
  199. protected:
  200. const char* GetInstallTargetName() const override { return "install"; }
  201. const char* GetPackageTargetName() const override { return "package"; }
  202. unsigned int XcodeVersion;
  203. std::string VersionString;
  204. std::set<std::string> XCodeObjectIDs;
  205. std::vector<cmXCodeObject*> XCodeObjects;
  206. cmXCodeObject* RootObject;
  207. private:
  208. std::string const& GetXcodeBuildCommand();
  209. std::string FindXcodeBuildCommand();
  210. std::string XcodeBuildCommand;
  211. bool XcodeBuildCommandInitialized;
  212. void PrintCompilerAdvice(std::ostream&, std::string const&,
  213. const char*) const override
  214. {
  215. }
  216. std::string GetObjectsNormalDirectory(const std::string& projName,
  217. const std::string& configName,
  218. const cmGeneratorTarget* t) const;
  219. static std::string GetDeploymentPlatform(const cmMakefile* mf);
  220. void ComputeArchitectures(cmMakefile* mf);
  221. void ComputeObjectDirArch(cmMakefile* mf);
  222. void addObject(cmXCodeObject* obj);
  223. std::string PostBuildMakeTarget(std::string const& tName,
  224. std::string const& configName);
  225. cmXCodeObject* MainGroupChildren;
  226. cmMakefile* CurrentMakefile;
  227. cmLocalGenerator* CurrentLocalGenerator;
  228. std::vector<std::string> CurrentConfigurationTypes;
  229. std::string CurrentReRunCMakeMakefile;
  230. std::string CurrentXCodeHackMakefile;
  231. std::string CurrentProject;
  232. std::set<std::string> TargetDoneSet;
  233. std::vector<std::string> ProjectSourceDirectoryComponents;
  234. std::vector<std::string> ProjectOutputDirectoryComponents;
  235. std::map<std::string, cmXCodeObject*> GroupMap;
  236. std::map<std::string, cmXCodeObject*> GroupNameMap;
  237. std::map<std::string, cmXCodeObject*> TargetGroup;
  238. std::map<std::string, cmXCodeObject*> FileRefs;
  239. std::map<cmGeneratorTarget const*, cmXCodeObject*> XCodeObjectMap;
  240. std::vector<std::string> Architectures;
  241. std::string ObjectDirArchDefault;
  242. std::string ObjectDirArch;
  243. std::string GeneratorToolset;
  244. };
  245. #endif