diff options
Diffstat (limited to '3.8.2/doc/cmake/html/module/CPackWIX.html')
-rw-r--r-- | 3.8.2/doc/cmake/html/module/CPackWIX.html | 413 |
1 files changed, 0 insertions, 413 deletions
diff --git a/3.8.2/doc/cmake/html/module/CPackWIX.html b/3.8.2/doc/cmake/html/module/CPackWIX.html deleted file mode 100644 index b8103a0..0000000 --- a/3.8.2/doc/cmake/html/module/CPackWIX.html +++ /dev/null @@ -1,413 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - - -<html xmlns="http://www.w3.org/1999/xhtml"> - <head> - <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> - - <title>CPackWIX — CMake 3.8.2 Documentation</title> - - - <link rel="stylesheet" href="../_static/cmake.css" type="text/css" /> - <link rel="stylesheet" href="../_static/pygments.css" type="text/css" /> - - <script type="text/javascript"> - var DOCUMENTATION_OPTIONS = { - URL_ROOT: '../', - VERSION: '3.8.2', - COLLAPSE_INDEX: false, - FILE_SUFFIX: '.html', - HAS_SOURCE: true, - SOURCELINK_SUFFIX: '.txt' - }; - </script> - <script type="text/javascript" src="../_static/jquery.js"></script> - <script type="text/javascript" src="../_static/underscore.js"></script> - <script type="text/javascript" src="../_static/doctools.js"></script> - <link rel="shortcut icon" href="../_static/cmake-favicon.ico"/> - <link rel="index" title="Index" href="../genindex.html" /> - <link rel="search" title="Search" href="../search.html" /> - <link rel="next" title="CSharpUtilities" href="CSharpUtilities.html" /> - <link rel="prev" title="CPack" href="CPack.html" /> - </head> - <body role="document"> - <div class="related" role="navigation" aria-label="related navigation"> - <h3>Navigation</h3> - <ul> - <li class="right" style="margin-right: 10px"> - <a href="../genindex.html" title="General Index" - accesskey="I">index</a></li> - <li class="right" > - <a href="CSharpUtilities.html" title="CSharpUtilities" - accesskey="N">next</a> |</li> - <li class="right" > - <a href="CPack.html" title="CPack" - accesskey="P">previous</a> |</li> - <li> - <img src="../_static/cmake-logo-16.png" alt="" - style="vertical-align: middle; margin-top: -2px" /> - </li> - <li> - <a href="https://cmake.org/">CMake</a> » - </li> - <li> - <a href="../index.html">3.8.2 Documentation</a> » - </li> - - <li class="nav-item nav-item-1"><a href="../manual/cmake-modules.7.html" accesskey="U">cmake-modules(7)</a> »</li> - </ul> - </div> - - <div class="document"> - <div class="documentwrapper"> - <div class="bodywrapper"> - <div class="body" role="main"> - - <div class="section" id="cpackwix"> -<span id="module:CPackWIX"></span><h1>CPackWIX<a class="headerlink" href="#cpackwix" title="Permalink to this headline">¶</a></h1> -<p>CPack WiX generator specific options</p> -<div class="section" id="variables-specific-to-cpack-wix-generator"> -<h2>Variables specific to CPack WiX generator<a class="headerlink" href="#variables-specific-to-cpack-wix-generator" title="Permalink to this headline">¶</a></h2> -<p>The following variables are specific to the installers built on -Windows using WiX.</p> -<dl class="variable"> -<dt id="variable:CPACK_WIX_UPGRADE_GUID"> -<code class="descname">CPACK_WIX_UPGRADE_GUID</code><a class="headerlink" href="#variable:CPACK_WIX_UPGRADE_GUID" title="Permalink to this definition">¶</a></dt> -<dd><p>Upgrade GUID (<code class="docutils literal"><span class="pre">Product/@UpgradeCode</span></code>)</p> -<p>Will be automatically generated unless explicitly provided.</p> -<p>It should be explicitly set to a constant generated globally unique -identifier (GUID) to allow your installers to replace existing -installations that use the same GUID.</p> -<p>You may for example explicitly set this variable in your -CMakeLists.txt to the value that has been generated per default. You -should not use GUIDs that you did not generate yourself or which may -belong to other projects.</p> -<p>A GUID shall have the following fixed length syntax:</p> -<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">XXXXXXXX</span><span class="o">-</span><span class="n">XXXX</span><span class="o">-</span><span class="n">XXXX</span><span class="o">-</span><span class="n">XXXX</span><span class="o">-</span><span class="n">XXXXXXXXXXXX</span> -</pre></div> -</div> -<p>(each X represents an uppercase hexadecimal digit)</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_PRODUCT_GUID"> -<code class="descname">CPACK_WIX_PRODUCT_GUID</code><a class="headerlink" href="#variable:CPACK_WIX_PRODUCT_GUID" title="Permalink to this definition">¶</a></dt> -<dd><p>Product GUID (<code class="docutils literal"><span class="pre">Product/@Id</span></code>)</p> -<p>Will be automatically generated unless explicitly provided.</p> -<p>If explicitly provided this will set the Product Id of your installer.</p> -<p>The installer will abort if it detects a pre-existing installation that -uses the same GUID.</p> -<p>The GUID shall use the syntax described for CPACK_WIX_UPGRADE_GUID.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_LICENSE_RTF"> -<code class="descname">CPACK_WIX_LICENSE_RTF</code><a class="headerlink" href="#variable:CPACK_WIX_LICENSE_RTF" title="Permalink to this definition">¶</a></dt> -<dd><p>RTF License File</p> -<p>If CPACK_RESOURCE_FILE_LICENSE has an .rtf extension it is used as-is.</p> -<p>If CPACK_RESOURCE_FILE_LICENSE has an .txt extension it is implicitly -converted to RTF by the WiX Generator. -The expected encoding of the .txt file is UTF-8.</p> -<p>With CPACK_WIX_LICENSE_RTF you can override the license file used by the -WiX Generator in case CPACK_RESOURCE_FILE_LICENSE is in an unsupported -format or the .txt -> .rtf conversion does not work as expected.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_PRODUCT_ICON"> -<code class="descname">CPACK_WIX_PRODUCT_ICON</code><a class="headerlink" href="#variable:CPACK_WIX_PRODUCT_ICON" title="Permalink to this definition">¶</a></dt> -<dd><p>The Icon shown next to the program name in Add/Remove programs.</p> -<p>If set, this icon is used in place of the default icon.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_UI_REF"> -<code class="descname">CPACK_WIX_UI_REF</code><a class="headerlink" href="#variable:CPACK_WIX_UI_REF" title="Permalink to this definition">¶</a></dt> -<dd><p>This variable allows you to override the Id of the <code class="docutils literal"><span class="pre"><UIRef></span></code> element -in the WiX template.</p> -<p>The default is <code class="docutils literal"><span class="pre">WixUI_InstallDir</span></code> in case no CPack components have -been defined and <code class="docutils literal"><span class="pre">WixUI_FeatureTree</span></code> otherwise.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_UI_BANNER"> -<code class="descname">CPACK_WIX_UI_BANNER</code><a class="headerlink" href="#variable:CPACK_WIX_UI_BANNER" title="Permalink to this definition">¶</a></dt> -<dd><p>The bitmap will appear at the top of all installer pages other than the -welcome and completion dialogs.</p> -<p>If set, this image will replace the default banner image.</p> -<p>This image must be 493 by 58 pixels.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_UI_DIALOG"> -<code class="descname">CPACK_WIX_UI_DIALOG</code><a class="headerlink" href="#variable:CPACK_WIX_UI_DIALOG" title="Permalink to this definition">¶</a></dt> -<dd><p>Background bitmap used on the welcome and completion dialogs.</p> -<p>If this variable is set, the installer will replace the default dialog -image.</p> -<p>This image must be 493 by 312 pixels.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_PROGRAM_MENU_FOLDER"> -<code class="descname">CPACK_WIX_PROGRAM_MENU_FOLDER</code><a class="headerlink" href="#variable:CPACK_WIX_PROGRAM_MENU_FOLDER" title="Permalink to this definition">¶</a></dt> -<dd><p>Start menu folder name for launcher.</p> -<p>If this variable is not set, it will be initialized with CPACK_PACKAGE_NAME</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_CULTURES"> -<code class="descname">CPACK_WIX_CULTURES</code><a class="headerlink" href="#variable:CPACK_WIX_CULTURES" title="Permalink to this definition">¶</a></dt> -<dd><p>Language(s) of the installer</p> -<p>Languages are compiled into the WixUI extension library. To use them, -simply provide the name of the culture. If you specify more than one -culture identifier in a comma or semicolon delimited list, the first one -that is found will be used. You can find a list of supported languages at: -<a class="reference external" href="http://wix.sourceforge.net/manual-wix3/WixUI_localization.htm">http://wix.sourceforge.net/manual-wix3/WixUI_localization.htm</a></p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_TEMPLATE"> -<code class="descname">CPACK_WIX_TEMPLATE</code><a class="headerlink" href="#variable:CPACK_WIX_TEMPLATE" title="Permalink to this definition">¶</a></dt> -<dd><p>Template file for WiX generation</p> -<p>If this variable is set, the specified template will be used to generate -the WiX wxs file. This should be used if further customization of the -output is required.</p> -<p>If this variable is not set, the default MSI template included with CMake -will be used.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_PATCH_FILE"> -<code class="descname">CPACK_WIX_PATCH_FILE</code><a class="headerlink" href="#variable:CPACK_WIX_PATCH_FILE" title="Permalink to this definition">¶</a></dt> -<dd><p>Optional list of XML files with fragments to be inserted into -generated WiX sources</p> -<p>This optional variable can be used to specify an XML file that the -WiX generator will use to inject fragments into its generated -source files.</p> -<p>Patch files understood by the CPack WiX generator -roughly follow this RELAX NG compact schema:</p> -<div class="highlight-none"><div class="highlight"><pre><span></span>start = CPackWiXPatch - -CPackWiXPatch = element CPackWiXPatch { CPackWiXFragment* } - -CPackWiXFragment = element CPackWiXFragment -{ - attribute Id { string }, - fragmentContent* -} - -fragmentContent = element * - CPackWiXFragment -{ - (attribute * { text } | text | fragmentContent)* -} -</pre></div> -</div> -<p>Currently fragments can be injected into most -Component, File, Directory and Feature elements.</p> -<p>The following additional special Ids can be used:</p> -<ul class="simple"> -<li><code class="docutils literal"><span class="pre">#PRODUCT</span></code> for the <code class="docutils literal"><span class="pre"><Product></span></code> element.</li> -<li><code class="docutils literal"><span class="pre">#PRODUCTFEATURE</span></code> for the root <code class="docutils literal"><span class="pre"><Feature></span></code> element.</li> -</ul> -<p>The following example illustrates how this works.</p> -<p>Given that the WiX generator creates the following XML element:</p> -<div class="highlight-xml"><div class="highlight"><pre><span></span><span class="nt"><Component</span> <span class="na">Id=</span><span class="s">"CM_CP_applications.bin.my_libapp.exe"</span> <span class="na">Guid=</span><span class="s">"*"</span><span class="nt">/></span> -</pre></div> -</div> -<p>The following XML patch file may be used to inject an Environment element -into it:</p> -<div class="highlight-xml"><div class="highlight"><pre><span></span><span class="nt"><CPackWiXPatch></span> - <span class="nt"><CPackWiXFragment</span> <span class="na">Id=</span><span class="s">"CM_CP_applications.bin.my_libapp.exe"</span><span class="nt">></span> - <span class="nt"><Environment</span> <span class="na">Id=</span><span class="s">"MyEnvironment"</span> <span class="na">Action=</span><span class="s">"set"</span> - <span class="na">Name=</span><span class="s">"MyVariableName"</span> <span class="na">Value=</span><span class="s">"MyVariableValue"</span><span class="nt">/></span> - <span class="nt"></CPackWiXFragment></span> -<span class="nt"></CPackWiXPatch></span> -</pre></div> -</div> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_EXTRA_SOURCES"> -<code class="descname">CPACK_WIX_EXTRA_SOURCES</code><a class="headerlink" href="#variable:CPACK_WIX_EXTRA_SOURCES" title="Permalink to this definition">¶</a></dt> -<dd><p>Extra WiX source files</p> -<p>This variable provides an optional list of extra WiX source files (.wxs) -that should be compiled and linked. The full path to source files is -required.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_EXTRA_OBJECTS"> -<code class="descname">CPACK_WIX_EXTRA_OBJECTS</code><a class="headerlink" href="#variable:CPACK_WIX_EXTRA_OBJECTS" title="Permalink to this definition">¶</a></dt> -<dd><p>Extra WiX object files or libraries</p> -<p>This variable provides an optional list of extra WiX object (.wixobj) -and/or WiX library (.wixlib) files. The full path to objects and libraries -is required.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_EXTENSIONS"> -<code class="descname">CPACK_WIX_EXTENSIONS</code><a class="headerlink" href="#variable:CPACK_WIX_EXTENSIONS" title="Permalink to this definition">¶</a></dt> -<dd><p>This variable provides a list of additional extensions for the WiX -tools light and candle.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_<TOOL>_EXTENSIONS"> -<code class="descname">CPACK_WIX_<TOOL>_EXTENSIONS</code><a class="headerlink" href="#variable:CPACK_WIX_<TOOL>_EXTENSIONS" title="Permalink to this definition">¶</a></dt> -<dd><p>This is the tool specific version of CPACK_WIX_EXTENSIONS. -<code class="docutils literal"><span class="pre"><TOOL></span></code> can be either LIGHT or CANDLE.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_<TOOL>_EXTRA_FLAGS"> -<code class="descname">CPACK_WIX_<TOOL>_EXTRA_FLAGS</code><a class="headerlink" href="#variable:CPACK_WIX_<TOOL>_EXTRA_FLAGS" title="Permalink to this definition">¶</a></dt> -<dd><p>This list variable allows you to pass additional -flags to the WiX tool <code class="docutils literal"><span class="pre"><TOOL></span></code>.</p> -<p>Use it at your own risk. -Future versions of CPack may generate flags which may be in conflict -with your own flags.</p> -<p><code class="docutils literal"><span class="pre"><TOOL></span></code> can be either LIGHT or CANDLE.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_CMAKE_PACKAGE_REGISTRY"> -<code class="descname">CPACK_WIX_CMAKE_PACKAGE_REGISTRY</code><a class="headerlink" href="#variable:CPACK_WIX_CMAKE_PACKAGE_REGISTRY" title="Permalink to this definition">¶</a></dt> -<dd><p>If this variable is set the generated installer will create -an entry in the windows registry key -<code class="docutils literal"><span class="pre">HKEY_LOCAL_MACHINE\Software\Kitware\CMake\Packages\<package></span></code> -The value for <code class="docutils literal"><span class="pre"><package></span></code> is provided by this variable.</p> -<p>Assuming you also install a CMake configuration file this will -allow other CMake projects to find your package with -the <span class="target" id="index-0-command:find_package"></span><a class="reference internal" href="../command/find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal"><span class="pre">find_package()</span></code></a> command.</p> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_PROPERTY_<PROPERTY>"> -<code class="descname">CPACK_WIX_PROPERTY_<PROPERTY></code><a class="headerlink" href="#variable:CPACK_WIX_PROPERTY_<PROPERTY>" title="Permalink to this definition">¶</a></dt> -<dd><p>This variable can be used to provide a value for -the Windows Installer property <code class="docutils literal"><span class="pre"><PROPERTY></span></code></p> -<p>The following list contains some example properties that can be used to -customize information under -“Programs and Features” (also known as “Add or Remove Programs”)</p> -<ul class="simple"> -<li>ARPCOMMENTS - Comments</li> -<li>ARPHELPLINK - Help and support information URL</li> -<li>ARPURLINFOABOUT - General information URL</li> -<li>ARPURLUPDATEINFO - Update information URL</li> -<li>ARPHELPTELEPHONE - Help and support telephone number</li> -<li>ARPSIZE - Size (in kilobytes) of the application</li> -</ul> -</dd></dl> - -<dl class="variable"> -<dt id="variable:CPACK_WIX_ROOT_FEATURE_TITLE"> -<code class="descname">CPACK_WIX_ROOT_FEATURE_TITLE</code><a class="headerlink" href="#variable:CPACK_WIX_ROOT_FEATURE_TITLE" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<p>Sets the name of the root install feature in the WIX installer. Same as -CPACK_COMPONENT_<compName>_DISPLAY_NAME for components.</p> -<dl class="variable"> -<dt id="variable:CPACK_WIX_ROOT_FEATURE_DESCRIPTION"> -<code class="descname">CPACK_WIX_ROOT_FEATURE_DESCRIPTION</code><a class="headerlink" href="#variable:CPACK_WIX_ROOT_FEATURE_DESCRIPTION" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<p>Sets the description of the root install feature in the WIX installer. Same as -CPACK_COMPONENT_<compName>_DESCRIPTION for components.</p> -<dl class="variable"> -<dt id="variable:CPACK_WIX_SKIP_PROGRAM_FOLDER"> -<code class="descname">CPACK_WIX_SKIP_PROGRAM_FOLDER</code><a class="headerlink" href="#variable:CPACK_WIX_SKIP_PROGRAM_FOLDER" title="Permalink to this definition">¶</a></dt> -<dd></dd></dl> - -<p>If this variable is set to true, the default install location -of the generated package will be CPACK_PACKAGE_INSTALL_DIRECTORY directly. -The install location will not be located relatively below -ProgramFiles or ProgramFiles64.</p> -<blockquote> -<div><div class="admonition note"> -<p class="first admonition-title">Note</p> -<p>Installers created with this feature do not take differences -between the system on which the installer is created -and the system on which the installer might be used into account.</p> -<p class="last">It is therefor possible that the installer e.g. might try to install -onto a drive that is unavailable or unintended or a path that does not -follow the localization or convention of the system on which the -installation is performed.</p> -</div> -</div></blockquote> -</div> -</div> - - - </div> - </div> - </div> - <div class="sphinxsidebar" role="navigation" aria-label="main navigation"> - <div class="sphinxsidebarwrapper"> - <h3><a href="../index.html">Table Of Contents</a></h3> - <ul> -<li><a class="reference internal" href="#">CPackWIX</a><ul> -<li><a class="reference internal" href="#variables-specific-to-cpack-wix-generator">Variables specific to CPack WiX generator</a></li> -</ul> -</li> -</ul> - - <h4>Previous topic</h4> - <p class="topless"><a href="CPack.html" - title="previous chapter">CPack</a></p> - <h4>Next topic</h4> - <p class="topless"><a href="CSharpUtilities.html" - title="next chapter">CSharpUtilities</a></p> - <div role="note" aria-label="source link"> - <h3>This Page</h3> - <ul class="this-page-menu"> - <li><a href="../_sources/module/CPackWIX.rst.txt" - rel="nofollow">Show Source</a></li> - </ul> - </div> -<div id="searchbox" style="display: none" role="search"> - <h3>Quick search</h3> - <form class="search" action="../search.html" method="get"> - <div><input type="text" name="q" /></div> - <div><input type="submit" value="Go" /></div> - <input type="hidden" name="check_keywords" value="yes" /> - <input type="hidden" name="area" value="default" /> - </form> -</div> -<script type="text/javascript">$('#searchbox').show(0);</script> - </div> - </div> - <div class="clearer"></div> - </div> - <div class="related" role="navigation" aria-label="related navigation"> - <h3>Navigation</h3> - <ul> - <li class="right" style="margin-right: 10px"> - <a href="../genindex.html" title="General Index" - >index</a></li> - <li class="right" > - <a href="CSharpUtilities.html" title="CSharpUtilities" - >next</a> |</li> - <li class="right" > - <a href="CPack.html" title="CPack" - >previous</a> |</li> - <li> - <img src="../_static/cmake-logo-16.png" alt="" - style="vertical-align: middle; margin-top: -2px" /> - </li> - <li> - <a href="https://cmake.org/">CMake</a> » - </li> - <li> - <a href="../index.html">3.8.2 Documentation</a> » - </li> - - <li class="nav-item nav-item-1"><a href="../manual/cmake-modules.7.html" >cmake-modules(7)</a> »</li> - </ul> - </div> - <div class="footer" role="contentinfo"> - © Copyright 2000-2017 Kitware, Inc. and Contributors. - Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.5.2. - </div> - </body> -</html>
\ No newline at end of file |