cmCPackWIXGenerator.cxx 36 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217
  1. /* Distributed under the OSI-approved BSD 3-Clause License. See accompanying
  2. file Copyright.txt or https://cmake.org/licensing for details. */
  3. #include "cmCPackWIXGenerator.h"
  4. #include <algorithm>
  5. #include <cm/memory>
  6. #include <cm/string_view>
  7. #include <cmext/algorithm>
  8. #include "cmsys/Directory.hxx"
  9. #include "cmsys/Encoding.hxx"
  10. #include "cmsys/FStream.hxx"
  11. #include "cmsys/SystemTools.hxx"
  12. #include "cmCPackComponentGroup.h"
  13. #include "cmCPackLog.h"
  14. #include "cmCryptoHash.h"
  15. #include "cmGeneratedFileStream.h"
  16. #include "cmInstalledFile.h"
  17. #include "cmStringAlgorithms.h"
  18. #include "cmSystemTools.h"
  19. #include "cmUuid.h"
  20. #include "cmWIXDirectoriesSourceWriter.h"
  21. #include "cmWIXFeaturesSourceWriter.h"
  22. #include "cmWIXFilesSourceWriter.h"
  23. #include "cmWIXRichTextFormatWriter.h"
  24. #include "cmWIXSourceWriter.h"
  25. #ifdef _WIN32
  26. # include <rpc.h> // for GUID generation (windows only)
  27. #else
  28. # include <uuid/uuid.h> // for GUID generation (libuuid)
  29. #endif
  30. #include "cmCMakeToWixPath.h"
  31. cmCPackWIXGenerator::cmCPackWIXGenerator()
  32. : ComponentGuidType(cmWIXSourceWriter::WIX_GENERATED_GUID)
  33. {
  34. }
  35. cmCPackWIXGenerator::~cmCPackWIXGenerator() = default;
  36. int cmCPackWIXGenerator::InitializeInternal()
  37. {
  38. componentPackageMethod = ONE_PACKAGE;
  39. this->Patch = cm::make_unique<cmWIXPatch>(this->Logger);
  40. return this->Superclass::InitializeInternal();
  41. }
  42. bool cmCPackWIXGenerator::RunWiXCommand(std::string const& command)
  43. {
  44. std::string logFileName = this->CPackTopLevel + "/wix.log";
  45. cmCPackLogger(cmCPackLog::LOG_DEBUG,
  46. "Running WiX command: " << command << std::endl);
  47. std::string output;
  48. int returnValue = 0;
  49. bool status = cmSystemTools::RunSingleCommand(
  50. command, &output, &output, &returnValue, 0, cmSystemTools::OUTPUT_NONE);
  51. cmsys::ofstream logFile(logFileName.c_str(), std::ios::app);
  52. logFile << command << std::endl;
  53. logFile << output;
  54. logFile.close();
  55. if (!status || returnValue) {
  56. cmCPackLogger(cmCPackLog::LOG_ERROR,
  57. "Problem running WiX candle. "
  58. "Please check '"
  59. << logFileName << "' for errors." << std::endl);
  60. return false;
  61. }
  62. return true;
  63. }
  64. bool cmCPackWIXGenerator::RunCandleCommand(std::string const& sourceFile,
  65. std::string const& objectFile)
  66. {
  67. std::string executable;
  68. if (!RequireOption("CPACK_WIX_CANDLE_EXECUTABLE", executable)) {
  69. return false;
  70. }
  71. std::ostringstream command;
  72. command << QuotePath(executable);
  73. command << " -nologo";
  74. command << " -arch " << GetArchitecture();
  75. command << " -out " << QuotePath(objectFile);
  76. for (std::string const& ext : CandleExtensions) {
  77. command << " -ext " << QuotePath(ext);
  78. }
  79. if (!cmHasSuffix(sourceFile, this->CPackTopLevel)) {
  80. command << " " << QuotePath("-I" + this->CPackTopLevel);
  81. }
  82. AddCustomFlags("CPACK_WIX_CANDLE_EXTRA_FLAGS", command);
  83. command << " " << QuotePath(sourceFile);
  84. return RunWiXCommand(command.str());
  85. }
  86. bool cmCPackWIXGenerator::RunLightCommand(std::string const& objectFiles)
  87. {
  88. std::string executable;
  89. if (!RequireOption("CPACK_WIX_LIGHT_EXECUTABLE", executable)) {
  90. return false;
  91. }
  92. std::ostringstream command;
  93. command << QuotePath(executable);
  94. command << " -nologo";
  95. command << " -out " << QuotePath(CMakeToWixPath(packageFileNames.at(0)));
  96. for (std::string const& ext : this->LightExtensions) {
  97. command << " -ext " << QuotePath(ext);
  98. }
  99. const char* const cultures = GetOption("CPACK_WIX_CULTURES");
  100. if (cultures) {
  101. command << " -cultures:" << cultures;
  102. }
  103. AddCustomFlags("CPACK_WIX_LIGHT_EXTRA_FLAGS", command);
  104. command << " " << objectFiles;
  105. return RunWiXCommand(command.str());
  106. }
  107. int cmCPackWIXGenerator::PackageFiles()
  108. {
  109. if (!PackageFilesImpl() || cmSystemTools::GetErrorOccuredFlag()) {
  110. cmCPackLogger(cmCPackLog::LOG_ERROR,
  111. "Fatal WiX Generator Error" << std::endl);
  112. return false;
  113. }
  114. return true;
  115. }
  116. bool cmCPackWIXGenerator::InitializeWiXConfiguration()
  117. {
  118. if (!ReadListFile("Internal/CPack/CPackWIX.cmake")) {
  119. cmCPackLogger(cmCPackLog::LOG_ERROR,
  120. "Error while executing CPackWIX.cmake" << std::endl);
  121. return false;
  122. }
  123. if (GetOption("CPACK_WIX_PRODUCT_GUID") == 0) {
  124. std::string guid = GenerateGUID();
  125. SetOption("CPACK_WIX_PRODUCT_GUID", guid.c_str());
  126. cmCPackLogger(cmCPackLog::LOG_VERBOSE,
  127. "CPACK_WIX_PRODUCT_GUID implicitly set to " << guid << " . "
  128. << std::endl);
  129. }
  130. if (GetOption("CPACK_WIX_UPGRADE_GUID") == 0) {
  131. std::string guid = GenerateGUID();
  132. SetOption("CPACK_WIX_UPGRADE_GUID", guid.c_str());
  133. cmCPackLogger(cmCPackLog::LOG_WARNING,
  134. "CPACK_WIX_UPGRADE_GUID implicitly set to "
  135. << guid
  136. << " . "
  137. "Please refer to the documentation on how and why "
  138. "you might want to set this explicitly."
  139. << std::endl);
  140. }
  141. if (!RequireOption("CPACK_TOPLEVEL_DIRECTORY", this->CPackTopLevel)) {
  142. return false;
  143. }
  144. if (GetOption("CPACK_WIX_LICENSE_RTF") == 0) {
  145. std::string licenseFilename = this->CPackTopLevel + "/License.rtf";
  146. SetOption("CPACK_WIX_LICENSE_RTF", licenseFilename.c_str());
  147. if (!CreateLicenseFile()) {
  148. return false;
  149. }
  150. }
  151. if (GetOption("CPACK_PACKAGE_VENDOR") == 0) {
  152. std::string defaultVendor = "Humanity";
  153. SetOption("CPACK_PACKAGE_VENDOR", defaultVendor.c_str());
  154. cmCPackLogger(cmCPackLog::LOG_VERBOSE,
  155. "CPACK_PACKAGE_VENDOR implicitly set to "
  156. << defaultVendor << " . " << std::endl);
  157. }
  158. if (GetOption("CPACK_WIX_UI_REF") == 0) {
  159. std::string defaultRef = "WixUI_InstallDir";
  160. if (!this->Components.empty()) {
  161. defaultRef = "WixUI_FeatureTree";
  162. }
  163. SetOption("CPACK_WIX_UI_REF", defaultRef.c_str());
  164. }
  165. const char* packageContact = GetOption("CPACK_PACKAGE_CONTACT");
  166. if (packageContact != 0 && GetOption("CPACK_WIX_PROPERTY_ARPCONTACT") == 0) {
  167. SetOption("CPACK_WIX_PROPERTY_ARPCONTACT", packageContact);
  168. }
  169. CollectExtensions("CPACK_WIX_EXTENSIONS", this->CandleExtensions);
  170. CollectExtensions("CPACK_WIX_CANDLE_EXTENSIONS", this->CandleExtensions);
  171. this->LightExtensions.insert("WixUIExtension");
  172. CollectExtensions("CPACK_WIX_EXTENSIONS", this->LightExtensions);
  173. CollectExtensions("CPACK_WIX_LIGHT_EXTENSIONS", this->LightExtensions);
  174. CollectXmlNamespaces("CPACK_WIX_CUSTOM_XMLNS", this->CustomXmlNamespaces);
  175. const char* patchFilePath = GetOption("CPACK_WIX_PATCH_FILE");
  176. if (patchFilePath) {
  177. std::vector<std::string> patchFilePaths = cmExpandedList(patchFilePath);
  178. for (std::string const& p : patchFilePaths) {
  179. if (!this->Patch->LoadFragments(p)) {
  180. return false;
  181. }
  182. }
  183. }
  184. // if install folder is supposed to be set absolutely, the default
  185. // component guid "*" cannot be used
  186. if (cmIsOn(GetOption("CPACK_WIX_SKIP_PROGRAM_FOLDER"))) {
  187. this->ComponentGuidType = cmWIXSourceWriter::CMAKE_GENERATED_GUID;
  188. }
  189. return true;
  190. }
  191. bool cmCPackWIXGenerator::PackageFilesImpl()
  192. {
  193. if (!InitializeWiXConfiguration()) {
  194. return false;
  195. }
  196. CreateWiXVariablesIncludeFile();
  197. CreateWiXPropertiesIncludeFile();
  198. CreateWiXProductFragmentIncludeFile();
  199. if (!CreateWiXSourceFiles()) {
  200. return false;
  201. }
  202. AppendUserSuppliedExtraSources();
  203. std::set<std::string> usedBaseNames;
  204. std::ostringstream objectFiles;
  205. for (std::string const& sourceFilename : this->WixSources) {
  206. std::string baseName =
  207. cmSystemTools::GetFilenameWithoutLastExtension(sourceFilename);
  208. unsigned int counter = 0;
  209. std::string uniqueBaseName = baseName;
  210. while (usedBaseNames.find(uniqueBaseName) != usedBaseNames.end()) {
  211. std::ostringstream tmp;
  212. tmp << baseName << ++counter;
  213. uniqueBaseName = tmp.str();
  214. }
  215. usedBaseNames.insert(uniqueBaseName);
  216. std::string objectFilename =
  217. this->CPackTopLevel + "/" + uniqueBaseName + ".wixobj";
  218. if (!RunCandleCommand(CMakeToWixPath(sourceFilename),
  219. CMakeToWixPath(objectFilename))) {
  220. return false;
  221. }
  222. objectFiles << " " << QuotePath(CMakeToWixPath(objectFilename));
  223. }
  224. AppendUserSuppliedExtraObjects(objectFiles);
  225. return RunLightCommand(objectFiles.str());
  226. }
  227. void cmCPackWIXGenerator::AppendUserSuppliedExtraSources()
  228. {
  229. const char* cpackWixExtraSources = GetOption("CPACK_WIX_EXTRA_SOURCES");
  230. if (!cpackWixExtraSources)
  231. return;
  232. cmExpandList(cpackWixExtraSources, this->WixSources);
  233. }
  234. void cmCPackWIXGenerator::AppendUserSuppliedExtraObjects(std::ostream& stream)
  235. {
  236. const char* cpackWixExtraObjects = GetOption("CPACK_WIX_EXTRA_OBJECTS");
  237. if (!cpackWixExtraObjects)
  238. return;
  239. std::vector<std::string> expandedExtraObjects =
  240. cmExpandedList(cpackWixExtraObjects);
  241. for (std::string const& obj : expandedExtraObjects) {
  242. stream << " " << QuotePath(obj);
  243. }
  244. }
  245. void cmCPackWIXGenerator::CreateWiXVariablesIncludeFile()
  246. {
  247. std::string includeFilename = this->CPackTopLevel + "/cpack_variables.wxi";
  248. cmWIXSourceWriter includeFile(this->Logger, includeFilename,
  249. this->ComponentGuidType,
  250. cmWIXSourceWriter::INCLUDE_ELEMENT_ROOT);
  251. InjectXmlNamespaces(includeFile);
  252. CopyDefinition(includeFile, "CPACK_WIX_PRODUCT_GUID");
  253. CopyDefinition(includeFile, "CPACK_WIX_UPGRADE_GUID");
  254. CopyDefinition(includeFile, "CPACK_PACKAGE_VENDOR");
  255. CopyDefinition(includeFile, "CPACK_PACKAGE_NAME");
  256. CopyDefinition(includeFile, "CPACK_PACKAGE_VERSION");
  257. CopyDefinition(includeFile, "CPACK_WIX_LICENSE_RTF", DefinitionType::PATH);
  258. CopyDefinition(includeFile, "CPACK_WIX_PRODUCT_ICON", DefinitionType::PATH);
  259. CopyDefinition(includeFile, "CPACK_WIX_UI_BANNER", DefinitionType::PATH);
  260. CopyDefinition(includeFile, "CPACK_WIX_UI_DIALOG", DefinitionType::PATH);
  261. SetOptionIfNotSet("CPACK_WIX_PROGRAM_MENU_FOLDER",
  262. GetOption("CPACK_PACKAGE_NAME"));
  263. CopyDefinition(includeFile, "CPACK_WIX_PROGRAM_MENU_FOLDER");
  264. CopyDefinition(includeFile, "CPACK_WIX_UI_REF");
  265. }
  266. void cmCPackWIXGenerator::CreateWiXPropertiesIncludeFile()
  267. {
  268. std::string includeFilename = this->CPackTopLevel + "/properties.wxi";
  269. cmWIXSourceWriter includeFile(this->Logger, includeFilename,
  270. this->ComponentGuidType,
  271. cmWIXSourceWriter::INCLUDE_ELEMENT_ROOT);
  272. InjectXmlNamespaces(includeFile);
  273. std::string prefix = "CPACK_WIX_PROPERTY_";
  274. std::vector<std::string> options = GetOptions();
  275. for (std::string const& name : options) {
  276. if (cmHasPrefix(name, prefix)) {
  277. std::string id = name.substr(prefix.length());
  278. std::string value = GetOption(name.c_str());
  279. includeFile.BeginElement("Property");
  280. includeFile.AddAttribute("Id", id);
  281. includeFile.AddAttribute("Value", value);
  282. includeFile.EndElement("Property");
  283. }
  284. }
  285. if (GetOption("CPACK_WIX_PROPERTY_ARPINSTALLLOCATION") == 0) {
  286. includeFile.BeginElement("Property");
  287. includeFile.AddAttribute("Id", "INSTALL_ROOT");
  288. includeFile.AddAttribute("Secure", "yes");
  289. includeFile.BeginElement("RegistrySearch");
  290. includeFile.AddAttribute("Id", "FindInstallLocation");
  291. includeFile.AddAttribute("Root", "HKLM");
  292. includeFile.AddAttribute(
  293. "Key",
  294. "Software\\Microsoft\\Windows\\"
  295. "CurrentVersion\\Uninstall\\[WIX_UPGRADE_DETECTED]");
  296. includeFile.AddAttribute("Name", "InstallLocation");
  297. includeFile.AddAttribute("Type", "raw");
  298. includeFile.EndElement("RegistrySearch");
  299. includeFile.EndElement("Property");
  300. includeFile.BeginElement("SetProperty");
  301. includeFile.AddAttribute("Id", "ARPINSTALLLOCATION");
  302. includeFile.AddAttribute("Value", "[INSTALL_ROOT]");
  303. includeFile.AddAttribute("After", "CostFinalize");
  304. includeFile.EndElement("SetProperty");
  305. }
  306. }
  307. void cmCPackWIXGenerator::CreateWiXProductFragmentIncludeFile()
  308. {
  309. std::string includeFilename = this->CPackTopLevel + "/product_fragment.wxi";
  310. cmWIXSourceWriter includeFile(this->Logger, includeFilename,
  311. this->ComponentGuidType,
  312. cmWIXSourceWriter::INCLUDE_ELEMENT_ROOT);
  313. InjectXmlNamespaces(includeFile);
  314. this->Patch->ApplyFragment("#PRODUCT", includeFile);
  315. }
  316. void cmCPackWIXGenerator::CopyDefinition(cmWIXSourceWriter& source,
  317. std::string const& name,
  318. DefinitionType type)
  319. {
  320. const char* value = GetOption(name.c_str());
  321. if (value) {
  322. if (type == DefinitionType::PATH) {
  323. AddDefinition(source, name, CMakeToWixPath(value));
  324. } else {
  325. AddDefinition(source, name, value);
  326. }
  327. }
  328. }
  329. void cmCPackWIXGenerator::AddDefinition(cmWIXSourceWriter& source,
  330. std::string const& name,
  331. std::string const& value)
  332. {
  333. std::ostringstream tmp;
  334. tmp << name << "=\"" << value << '"';
  335. source.AddProcessingInstruction("define", tmp.str());
  336. }
  337. bool cmCPackWIXGenerator::CreateWiXSourceFiles()
  338. {
  339. // if install folder is supposed to be set absolutely, the default
  340. // component guid "*" cannot be used
  341. std::string directoryDefinitionsFilename =
  342. this->CPackTopLevel + "/directories.wxs";
  343. this->WixSources.push_back(directoryDefinitionsFilename);
  344. cmWIXDirectoriesSourceWriter directoryDefinitions(
  345. this->Logger, directoryDefinitionsFilename, this->ComponentGuidType);
  346. InjectXmlNamespaces(directoryDefinitions);
  347. directoryDefinitions.BeginElement("Fragment");
  348. std::string installRoot;
  349. if (!RequireOption("CPACK_PACKAGE_INSTALL_DIRECTORY", installRoot)) {
  350. return false;
  351. }
  352. directoryDefinitions.BeginElement("Directory");
  353. directoryDefinitions.AddAttribute("Id", "TARGETDIR");
  354. directoryDefinitions.AddAttribute("Name", "SourceDir");
  355. size_t installRootSize =
  356. directoryDefinitions.BeginInstallationPrefixDirectory(GetRootFolderId(),
  357. installRoot);
  358. std::string fileDefinitionsFilename = this->CPackTopLevel + "/files.wxs";
  359. this->WixSources.push_back(fileDefinitionsFilename);
  360. cmWIXFilesSourceWriter fileDefinitions(this->Logger, fileDefinitionsFilename,
  361. this->ComponentGuidType);
  362. InjectXmlNamespaces(fileDefinitions);
  363. fileDefinitions.BeginElement("Fragment");
  364. std::string featureDefinitionsFilename =
  365. this->CPackTopLevel + "/features.wxs";
  366. this->WixSources.push_back(featureDefinitionsFilename);
  367. cmWIXFeaturesSourceWriter featureDefinitions(
  368. this->Logger, featureDefinitionsFilename, this->ComponentGuidType);
  369. InjectXmlNamespaces(featureDefinitions);
  370. featureDefinitions.BeginElement("Fragment");
  371. featureDefinitions.BeginElement("Feature");
  372. featureDefinitions.AddAttribute("Id", "ProductFeature");
  373. featureDefinitions.AddAttribute("Display", "expand");
  374. featureDefinitions.AddAttribute("Absent", "disallow");
  375. featureDefinitions.AddAttribute("ConfigurableDirectory", "INSTALL_ROOT");
  376. std::string cpackPackageName;
  377. if (!RequireOption("CPACK_PACKAGE_NAME", cpackPackageName)) {
  378. return false;
  379. }
  380. std::string featureTitle = cpackPackageName;
  381. if (const char* title = GetOption("CPACK_WIX_ROOT_FEATURE_TITLE")) {
  382. featureTitle = title;
  383. }
  384. featureDefinitions.AddAttribute("Title", featureTitle);
  385. if (const char* desc = GetOption("CPACK_WIX_ROOT_FEATURE_DESCRIPTION")) {
  386. featureDefinitions.AddAttribute("Description", desc);
  387. }
  388. featureDefinitions.AddAttribute("Level", "1");
  389. this->Patch->ApplyFragment("#PRODUCTFEATURE", featureDefinitions);
  390. const char* package = GetOption("CPACK_WIX_CMAKE_PACKAGE_REGISTRY");
  391. if (package) {
  392. featureDefinitions.CreateCMakePackageRegistryEntry(
  393. package, GetOption("CPACK_WIX_UPGRADE_GUID"));
  394. }
  395. if (!CreateFeatureHierarchy(featureDefinitions)) {
  396. return false;
  397. }
  398. featureDefinitions.EndElement("Feature");
  399. std::set<cmWIXShortcuts::Type> emittedShortcutTypes;
  400. cmWIXShortcuts globalShortcuts;
  401. if (Components.empty()) {
  402. AddComponentsToFeature(toplevel, "ProductFeature", directoryDefinitions,
  403. fileDefinitions, featureDefinitions,
  404. globalShortcuts);
  405. globalShortcuts.AddShortcutTypes(emittedShortcutTypes);
  406. } else {
  407. for (auto const& i : this->Components) {
  408. cmCPackComponent const& component = i.second;
  409. std::string componentPath = cmStrCat(toplevel, '/', component.Name);
  410. std::string const componentFeatureId = "CM_C_" + component.Name;
  411. cmWIXShortcuts featureShortcuts;
  412. AddComponentsToFeature(componentPath, componentFeatureId,
  413. directoryDefinitions, fileDefinitions,
  414. featureDefinitions, featureShortcuts);
  415. featureShortcuts.AddShortcutTypes(emittedShortcutTypes);
  416. if (!CreateShortcuts(component.Name, componentFeatureId,
  417. featureShortcuts, false, fileDefinitions,
  418. featureDefinitions)) {
  419. return false;
  420. }
  421. }
  422. }
  423. bool emitUninstallShortcut = true;
  424. const char* cpackWixProgramMenuFolder =
  425. GetOption("CPACK_WIX_PROGRAM_MENU_FOLDER");
  426. if (cpackWixProgramMenuFolder &&
  427. cm::string_view(cpackWixProgramMenuFolder) == ".") {
  428. emitUninstallShortcut = false;
  429. } else if (emittedShortcutTypes.find(cmWIXShortcuts::START_MENU) ==
  430. emittedShortcutTypes.end()) {
  431. emitUninstallShortcut = false;
  432. }
  433. if (!CreateShortcuts(std::string(), "ProductFeature", globalShortcuts,
  434. emitUninstallShortcut, fileDefinitions,
  435. featureDefinitions)) {
  436. return false;
  437. }
  438. featureDefinitions.EndElement("Fragment");
  439. fileDefinitions.EndElement("Fragment");
  440. directoryDefinitions.EndInstallationPrefixDirectory(installRootSize);
  441. if (emittedShortcutTypes.find(cmWIXShortcuts::START_MENU) !=
  442. emittedShortcutTypes.end()) {
  443. directoryDefinitions.EmitStartMenuFolder(
  444. GetOption("CPACK_WIX_PROGRAM_MENU_FOLDER"));
  445. }
  446. if (emittedShortcutTypes.find(cmWIXShortcuts::DESKTOP) !=
  447. emittedShortcutTypes.end()) {
  448. directoryDefinitions.EmitDesktopFolder();
  449. }
  450. if (emittedShortcutTypes.find(cmWIXShortcuts::STARTUP) !=
  451. emittedShortcutTypes.end()) {
  452. directoryDefinitions.EmitStartupFolder();
  453. }
  454. directoryDefinitions.EndElement("Directory");
  455. directoryDefinitions.EndElement("Fragment");
  456. if (!GenerateMainSourceFileFromTemplate()) {
  457. return false;
  458. }
  459. return this->Patch->CheckForUnappliedFragments();
  460. }
  461. std::string cmCPackWIXGenerator::GetRootFolderId() const
  462. {
  463. if (cmIsOn(GetOption("CPACK_WIX_SKIP_PROGRAM_FOLDER"))) {
  464. return "";
  465. }
  466. std::string result = "ProgramFiles<64>Folder";
  467. const char* rootFolderId = GetOption("CPACK_WIX_ROOT_FOLDER_ID");
  468. if (rootFolderId) {
  469. result = rootFolderId;
  470. }
  471. if (GetArchitecture() == "x86") {
  472. cmSystemTools::ReplaceString(result, "<64>", "");
  473. } else {
  474. cmSystemTools::ReplaceString(result, "<64>", "64");
  475. }
  476. return result;
  477. }
  478. bool cmCPackWIXGenerator::GenerateMainSourceFileFromTemplate()
  479. {
  480. std::string wixTemplate = FindTemplate("WIX.template.in");
  481. if (GetOption("CPACK_WIX_TEMPLATE") != 0) {
  482. wixTemplate = GetOption("CPACK_WIX_TEMPLATE");
  483. }
  484. if (wixTemplate.empty()) {
  485. cmCPackLogger(cmCPackLog::LOG_ERROR,
  486. "Could not find CPack WiX template file WIX.template.in"
  487. << std::endl);
  488. return false;
  489. }
  490. std::string mainSourceFilePath = this->CPackTopLevel + "/main.wxs";
  491. if (!ConfigureFile(wixTemplate, mainSourceFilePath)) {
  492. cmCPackLogger(cmCPackLog::LOG_ERROR,
  493. "Failed creating '" << mainSourceFilePath
  494. << "'' from template." << std::endl);
  495. return false;
  496. }
  497. this->WixSources.push_back(mainSourceFilePath);
  498. return true;
  499. }
  500. bool cmCPackWIXGenerator::CreateFeatureHierarchy(
  501. cmWIXFeaturesSourceWriter& featureDefinitions)
  502. {
  503. for (auto const& i : ComponentGroups) {
  504. cmCPackComponentGroup const& group = i.second;
  505. if (group.ParentGroup == 0) {
  506. featureDefinitions.EmitFeatureForComponentGroup(group, *this->Patch);
  507. }
  508. }
  509. for (auto const& i : this->Components) {
  510. cmCPackComponent const& component = i.second;
  511. if (!component.Group) {
  512. featureDefinitions.EmitFeatureForComponent(component, *this->Patch);
  513. }
  514. }
  515. return true;
  516. }
  517. bool cmCPackWIXGenerator::AddComponentsToFeature(
  518. std::string const& rootPath, std::string const& featureId,
  519. cmWIXDirectoriesSourceWriter& directoryDefinitions,
  520. cmWIXFilesSourceWriter& fileDefinitions,
  521. cmWIXFeaturesSourceWriter& featureDefinitions, cmWIXShortcuts& shortcuts)
  522. {
  523. featureDefinitions.BeginElement("FeatureRef");
  524. featureDefinitions.AddAttribute("Id", featureId);
  525. std::vector<std::string> cpackPackageExecutablesList;
  526. const char* cpackPackageExecutables = GetOption("CPACK_PACKAGE_EXECUTABLES");
  527. if (cpackPackageExecutables) {
  528. cmExpandList(cpackPackageExecutables, cpackPackageExecutablesList);
  529. if (cpackPackageExecutablesList.size() % 2 != 0) {
  530. cmCPackLogger(
  531. cmCPackLog::LOG_ERROR,
  532. "CPACK_PACKAGE_EXECUTABLES should contain pairs of <executable> and "
  533. "<text label>."
  534. << std::endl);
  535. return false;
  536. }
  537. }
  538. std::vector<std::string> cpackPackageDesktopLinksList;
  539. const char* cpackPackageDesktopLinks =
  540. GetOption("CPACK_CREATE_DESKTOP_LINKS");
  541. if (cpackPackageDesktopLinks) {
  542. cmExpandList(cpackPackageDesktopLinks, cpackPackageDesktopLinksList);
  543. }
  544. AddDirectoryAndFileDefinitions(
  545. rootPath, "INSTALL_ROOT", directoryDefinitions, fileDefinitions,
  546. featureDefinitions, cpackPackageExecutablesList,
  547. cpackPackageDesktopLinksList, shortcuts);
  548. featureDefinitions.EndElement("FeatureRef");
  549. return true;
  550. }
  551. bool cmCPackWIXGenerator::CreateShortcuts(
  552. std::string const& cpackComponentName, std::string const& featureId,
  553. cmWIXShortcuts const& shortcuts, bool emitUninstallShortcut,
  554. cmWIXFilesSourceWriter& fileDefinitions,
  555. cmWIXFeaturesSourceWriter& featureDefinitions)
  556. {
  557. if (!shortcuts.empty(cmWIXShortcuts::START_MENU)) {
  558. if (!this->CreateShortcutsOfSpecificType(
  559. cmWIXShortcuts::START_MENU, cpackComponentName, featureId, "",
  560. shortcuts, emitUninstallShortcut, fileDefinitions,
  561. featureDefinitions)) {
  562. return false;
  563. }
  564. }
  565. if (!shortcuts.empty(cmWIXShortcuts::DESKTOP)) {
  566. if (!this->CreateShortcutsOfSpecificType(
  567. cmWIXShortcuts::DESKTOP, cpackComponentName, featureId, "DESKTOP",
  568. shortcuts, false, fileDefinitions, featureDefinitions)) {
  569. return false;
  570. }
  571. }
  572. if (!shortcuts.empty(cmWIXShortcuts::STARTUP)) {
  573. if (!this->CreateShortcutsOfSpecificType(
  574. cmWIXShortcuts::STARTUP, cpackComponentName, featureId, "STARTUP",
  575. shortcuts, false, fileDefinitions, featureDefinitions)) {
  576. return false;
  577. }
  578. }
  579. return true;
  580. }
  581. bool cmCPackWIXGenerator::CreateShortcutsOfSpecificType(
  582. cmWIXShortcuts::Type type, std::string const& cpackComponentName,
  583. std::string const& featureId, std::string const& idPrefix,
  584. cmWIXShortcuts const& shortcuts, bool emitUninstallShortcut,
  585. cmWIXFilesSourceWriter& fileDefinitions,
  586. cmWIXFeaturesSourceWriter& featureDefinitions)
  587. {
  588. std::string directoryId;
  589. switch (type) {
  590. case cmWIXShortcuts::START_MENU: {
  591. const char* cpackWixProgramMenuFolder =
  592. GetOption("CPACK_WIX_PROGRAM_MENU_FOLDER");
  593. if (cpackWixProgramMenuFolder &&
  594. cm::string_view(cpackWixProgramMenuFolder) == ".") {
  595. directoryId = "ProgramMenuFolder";
  596. } else {
  597. directoryId = "PROGRAM_MENU_FOLDER";
  598. }
  599. } break;
  600. case cmWIXShortcuts::DESKTOP:
  601. directoryId = "DesktopFolder";
  602. break;
  603. case cmWIXShortcuts::STARTUP:
  604. directoryId = "StartupFolder";
  605. break;
  606. default:
  607. return false;
  608. }
  609. featureDefinitions.BeginElement("FeatureRef");
  610. featureDefinitions.AddAttribute("Id", featureId);
  611. std::string cpackVendor;
  612. if (!RequireOption("CPACK_PACKAGE_VENDOR", cpackVendor)) {
  613. return false;
  614. }
  615. std::string cpackPackageName;
  616. if (!RequireOption("CPACK_PACKAGE_NAME", cpackPackageName)) {
  617. return false;
  618. }
  619. std::string idSuffix;
  620. if (!cpackComponentName.empty()) {
  621. idSuffix += "_";
  622. idSuffix += cpackComponentName;
  623. }
  624. std::string componentId = "CM_SHORTCUT";
  625. if (idPrefix.size()) {
  626. componentId += "_" + idPrefix;
  627. }
  628. componentId += idSuffix;
  629. fileDefinitions.BeginElement("DirectoryRef");
  630. fileDefinitions.AddAttribute("Id", directoryId);
  631. fileDefinitions.BeginElement("Component");
  632. fileDefinitions.AddAttribute("Id", componentId);
  633. fileDefinitions.AddAttribute(
  634. "Guid", fileDefinitions.CreateGuidFromComponentId(componentId));
  635. this->Patch->ApplyFragment(componentId, fileDefinitions);
  636. std::string registryKey =
  637. std::string("Software\\") + cpackVendor + "\\" + cpackPackageName;
  638. shortcuts.EmitShortcuts(type, registryKey, cpackComponentName,
  639. fileDefinitions);
  640. if (type == cmWIXShortcuts::START_MENU) {
  641. const char* cpackWixProgramMenuFolder =
  642. GetOption("CPACK_WIX_PROGRAM_MENU_FOLDER");
  643. if (cpackWixProgramMenuFolder &&
  644. cm::string_view(cpackWixProgramMenuFolder) != ".") {
  645. fileDefinitions.EmitRemoveFolder("CM_REMOVE_PROGRAM_MENU_FOLDER" +
  646. idSuffix);
  647. }
  648. }
  649. if (emitUninstallShortcut) {
  650. fileDefinitions.EmitUninstallShortcut(cpackPackageName);
  651. }
  652. fileDefinitions.EndElement("Component");
  653. fileDefinitions.EndElement("DirectoryRef");
  654. featureDefinitions.EmitComponentRef(componentId);
  655. featureDefinitions.EndElement("FeatureRef");
  656. return true;
  657. }
  658. bool cmCPackWIXGenerator::CreateLicenseFile()
  659. {
  660. std::string licenseSourceFilename;
  661. if (!RequireOption("CPACK_RESOURCE_FILE_LICENSE", licenseSourceFilename)) {
  662. return false;
  663. }
  664. std::string licenseDestinationFilename;
  665. if (!RequireOption("CPACK_WIX_LICENSE_RTF", licenseDestinationFilename)) {
  666. return false;
  667. }
  668. std::string extension = GetRightmostExtension(licenseSourceFilename);
  669. if (extension == ".rtf") {
  670. cmSystemTools::CopyAFile(licenseSourceFilename.c_str(),
  671. licenseDestinationFilename.c_str());
  672. } else if (extension == ".txt") {
  673. cmWIXRichTextFormatWriter rtfWriter(licenseDestinationFilename);
  674. cmsys::ifstream licenseSource(licenseSourceFilename.c_str());
  675. std::string line;
  676. while (std::getline(licenseSource, line)) {
  677. rtfWriter.AddText(line);
  678. rtfWriter.AddText("\n");
  679. }
  680. } else {
  681. cmCPackLogger(cmCPackLog::LOG_ERROR,
  682. "unsupported WiX License file extension '"
  683. << extension << "'" << std::endl);
  684. return false;
  685. }
  686. return true;
  687. }
  688. void cmCPackWIXGenerator::AddDirectoryAndFileDefinitions(
  689. std::string const& topdir, std::string const& directoryId,
  690. cmWIXDirectoriesSourceWriter& directoryDefinitions,
  691. cmWIXFilesSourceWriter& fileDefinitions,
  692. cmWIXFeaturesSourceWriter& featureDefinitions,
  693. std::vector<std::string> const& packageExecutables,
  694. std::vector<std::string> const& desktopExecutables,
  695. cmWIXShortcuts& shortcuts)
  696. {
  697. cmsys::Directory dir;
  698. dir.Load(topdir.c_str());
  699. std::string relativeDirectoryPath =
  700. cmSystemTools::RelativePath(toplevel.c_str(), topdir.c_str());
  701. if (relativeDirectoryPath.empty()) {
  702. relativeDirectoryPath = ".";
  703. }
  704. cmInstalledFile const* directoryInstalledFile = this->GetInstalledFile(
  705. this->RelativePathWithoutComponentPrefix(relativeDirectoryPath));
  706. bool emptyDirectory = dir.GetNumberOfFiles() == 2;
  707. bool createDirectory = false;
  708. if (emptyDirectory) {
  709. createDirectory = true;
  710. }
  711. if (directoryInstalledFile) {
  712. if (directoryInstalledFile->HasProperty("CPACK_WIX_ACL")) {
  713. createDirectory = true;
  714. }
  715. }
  716. if (createDirectory) {
  717. std::string componentId = fileDefinitions.EmitComponentCreateFolder(
  718. directoryId, GenerateGUID(), directoryInstalledFile);
  719. featureDefinitions.EmitComponentRef(componentId);
  720. }
  721. if (emptyDirectory) {
  722. return;
  723. }
  724. for (size_t i = 0; i < dir.GetNumberOfFiles(); ++i) {
  725. std::string fileName = dir.GetFile(static_cast<unsigned long>(i));
  726. if (fileName == "." || fileName == "..") {
  727. continue;
  728. }
  729. std::string fullPath = topdir + "/" + fileName;
  730. std::string relativePath =
  731. cmSystemTools::RelativePath(toplevel.c_str(), fullPath.c_str());
  732. std::string id = PathToId(relativePath);
  733. if (cmSystemTools::FileIsDirectory(fullPath.c_str())) {
  734. std::string subDirectoryId = std::string("CM_D") + id;
  735. directoryDefinitions.BeginElement("Directory");
  736. directoryDefinitions.AddAttribute("Id", subDirectoryId);
  737. directoryDefinitions.AddAttribute("Name", fileName);
  738. this->Patch->ApplyFragment(subDirectoryId, directoryDefinitions);
  739. AddDirectoryAndFileDefinitions(
  740. fullPath, subDirectoryId, directoryDefinitions, fileDefinitions,
  741. featureDefinitions, packageExecutables, desktopExecutables, shortcuts);
  742. directoryDefinitions.EndElement("Directory");
  743. } else {
  744. cmInstalledFile const* installedFile = this->GetInstalledFile(
  745. this->RelativePathWithoutComponentPrefix(relativePath));
  746. if (installedFile) {
  747. shortcuts.CreateFromProperties(id, directoryId, *installedFile);
  748. }
  749. std::string componentId = fileDefinitions.EmitComponentFile(
  750. directoryId, id, fullPath, *(this->Patch), installedFile);
  751. featureDefinitions.EmitComponentRef(componentId);
  752. for (size_t j = 0; j < packageExecutables.size(); ++j) {
  753. std::string const& executableName = packageExecutables[j++];
  754. std::string const& textLabel = packageExecutables[j];
  755. if (cmSystemTools::LowerCase(fileName) ==
  756. cmSystemTools::LowerCase(executableName) + ".exe") {
  757. cmWIXShortcut shortcut;
  758. shortcut.label = textLabel;
  759. shortcut.workingDirectoryId = directoryId;
  760. shortcuts.insert(cmWIXShortcuts::START_MENU, id, shortcut);
  761. if (cm::contains(desktopExecutables, executableName)) {
  762. shortcuts.insert(cmWIXShortcuts::DESKTOP, id, shortcut);
  763. }
  764. }
  765. }
  766. }
  767. }
  768. }
  769. bool cmCPackWIXGenerator::RequireOption(std::string const& name,
  770. std::string& value) const
  771. {
  772. const char* tmp = GetOption(name.c_str());
  773. if (tmp) {
  774. value = tmp;
  775. return true;
  776. } else {
  777. cmCPackLogger(cmCPackLog::LOG_ERROR,
  778. "Required variable " << name << " not set" << std::endl);
  779. return false;
  780. }
  781. }
  782. std::string cmCPackWIXGenerator::GetArchitecture() const
  783. {
  784. std::string void_p_size;
  785. RequireOption("CPACK_WIX_SIZEOF_VOID_P", void_p_size);
  786. if (void_p_size == "8") {
  787. return "x64";
  788. } else {
  789. return "x86";
  790. }
  791. }
  792. std::string cmCPackWIXGenerator::GenerateGUID()
  793. {
  794. #ifdef _WIN32
  795. UUID guid;
  796. UuidCreate(&guid);
  797. unsigned short* tmp = 0;
  798. UuidToStringW(&guid, &tmp);
  799. std::string result =
  800. cmsys::Encoding::ToNarrow(reinterpret_cast<wchar_t*>(tmp));
  801. RpcStringFreeW(&tmp);
  802. #else
  803. uuid_t guid;
  804. char guid_ch[37] = { 0 };
  805. uuid_generate(guid);
  806. uuid_unparse(guid, guid_ch);
  807. std::string result = guid_ch;
  808. #endif
  809. return cmSystemTools::UpperCase(result);
  810. }
  811. std::string cmCPackWIXGenerator::QuotePath(std::string const& path)
  812. {
  813. return std::string("\"") + path + '"';
  814. }
  815. std::string cmCPackWIXGenerator::GetRightmostExtension(
  816. std::string const& filename)
  817. {
  818. std::string extension;
  819. std::string::size_type i = filename.rfind(".");
  820. if (i != std::string::npos) {
  821. extension = filename.substr(i);
  822. }
  823. return cmSystemTools::LowerCase(extension);
  824. }
  825. std::string cmCPackWIXGenerator::PathToId(std::string const& path)
  826. {
  827. id_map_t::const_iterator i = PathToIdMap.find(path);
  828. if (i != PathToIdMap.end())
  829. return i->second;
  830. std::string id = CreateNewIdForPath(path);
  831. return id;
  832. }
  833. std::string cmCPackWIXGenerator::CreateNewIdForPath(std::string const& path)
  834. {
  835. std::vector<std::string> components;
  836. cmSystemTools::SplitPath(path.c_str(), components, false);
  837. size_t replacementCount = 0;
  838. std::string identifier;
  839. std::string currentComponent;
  840. for (size_t i = 1; i < components.size(); ++i) {
  841. if (i != 1)
  842. identifier += '.';
  843. currentComponent =
  844. NormalizeComponentForId(components[i], replacementCount);
  845. identifier += currentComponent;
  846. }
  847. std::string idPrefix = "P";
  848. size_t replacementPercent = replacementCount * 100 / identifier.size();
  849. if (replacementPercent > 33 || identifier.size() > 60) {
  850. identifier = CreateHashedId(path, currentComponent);
  851. idPrefix = "H";
  852. }
  853. std::ostringstream result;
  854. result << idPrefix << "_" << identifier;
  855. size_t ambiguityCount = ++IdAmbiguityCounter[identifier];
  856. if (ambiguityCount > 999) {
  857. cmCPackLogger(cmCPackLog::LOG_ERROR,
  858. "Error while trying to generate a unique Id for '"
  859. << path << "'" << std::endl);
  860. return std::string();
  861. } else if (ambiguityCount > 1) {
  862. result << "_" << ambiguityCount;
  863. }
  864. std::string resultString = result.str();
  865. PathToIdMap[path] = resultString;
  866. return resultString;
  867. }
  868. std::string cmCPackWIXGenerator::CreateHashedId(
  869. std::string const& path, std::string const& normalizedFilename)
  870. {
  871. cmCryptoHash sha1(cmCryptoHash::AlgoSHA1);
  872. std::string const hash = sha1.HashString(path);
  873. const size_t maxFileNameLength = 52;
  874. std::string identifier =
  875. cmStrCat(cm::string_view(hash).substr(0, 7), '_',
  876. cm::string_view(normalizedFilename).substr(0, maxFileNameLength));
  877. // if the name was truncated
  878. if (normalizedFilename.length() > maxFileNameLength) {
  879. identifier += "...";
  880. }
  881. return identifier;
  882. }
  883. std::string cmCPackWIXGenerator::NormalizeComponentForId(
  884. std::string const& component, size_t& replacementCount)
  885. {
  886. std::string result;
  887. result.resize(component.size());
  888. for (size_t i = 0; i < component.size(); ++i) {
  889. char c = component[i];
  890. if (IsLegalIdCharacter(c)) {
  891. result[i] = c;
  892. } else {
  893. result[i] = '_';
  894. ++replacementCount;
  895. }
  896. }
  897. return result;
  898. }
  899. bool cmCPackWIXGenerator::IsLegalIdCharacter(char c)
  900. {
  901. return (c >= '0' && c <= '9') || (c >= 'a' && c <= 'z') ||
  902. (c >= 'A' && c <= 'Z') || c == '_' || c == '.';
  903. }
  904. void cmCPackWIXGenerator::CollectExtensions(std::string const& variableName,
  905. extension_set_t& extensions)
  906. {
  907. const char* variableContent = GetOption(variableName.c_str());
  908. if (!variableContent)
  909. return;
  910. std::vector<std::string> list = cmExpandedList(variableContent);
  911. extensions.insert(list.begin(), list.end());
  912. }
  913. void cmCPackWIXGenerator::CollectXmlNamespaces(std::string const& variableName,
  914. xmlns_map_t& namespaces)
  915. {
  916. const char* variableContent = GetOption(variableName.c_str());
  917. if (!variableContent) {
  918. return;
  919. }
  920. std::vector<std::string> list = cmExpandedList(variableContent);
  921. for (std::string const& str : list) {
  922. auto pos = str.find('=');
  923. if (pos != std::string::npos) {
  924. auto name = str.substr(0, pos);
  925. auto value = str.substr(pos + 1);
  926. namespaces.emplace(std::make_pair(name, value));
  927. } else {
  928. cmCPackLogger(cmCPackLog::LOG_ERROR,
  929. "Invalid element in CPACK_WIX_CUSTOM_XMLNS ignored: "
  930. << "\"" << str << "\"" << std::endl);
  931. }
  932. }
  933. std::ostringstream oss;
  934. for (auto& ns : namespaces) {
  935. oss << " xmlns:" << ns.first << "=\""
  936. << cmWIXSourceWriter::EscapeAttributeValue(ns.second) << '"';
  937. }
  938. SetOption("CPACK_WIX_CUSTOM_XMLNS_EXPANDED", oss.str().c_str());
  939. }
  940. void cmCPackWIXGenerator::AddCustomFlags(std::string const& variableName,
  941. std::ostream& stream)
  942. {
  943. const char* variableContent = GetOption(variableName.c_str());
  944. if (!variableContent)
  945. return;
  946. std::vector<std::string> list = cmExpandedList(variableContent);
  947. for (std::string const& i : list) {
  948. stream << " " << QuotePath(i);
  949. }
  950. }
  951. std::string cmCPackWIXGenerator::RelativePathWithoutComponentPrefix(
  952. std::string const& path)
  953. {
  954. if (this->Components.empty()) {
  955. return path;
  956. }
  957. std::string::size_type pos = path.find('/');
  958. return path.substr(pos + 1);
  959. }
  960. void cmCPackWIXGenerator::InjectXmlNamespaces(cmWIXSourceWriter& sourceWriter)
  961. {
  962. for (auto& ns : this->CustomXmlNamespaces) {
  963. sourceWriter.AddAttributeUnlessEmpty("xmlns:" + ns.first, ns.second);
  964. }
  965. }