CPackNSIS.cmake 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143
  1. #.rst:
  2. # CPackNSIS
  3. # ---------
  4. #
  5. # CPack NSIS generator specific options
  6. #
  7. # Variables specific to CPack NSIS generator
  8. # ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  9. #
  10. # The following variables are specific to the graphical installers built
  11. # on Windows using the Nullsoft Installation System.
  12. #
  13. # .. variable:: CPACK_NSIS_INSTALL_ROOT
  14. #
  15. # The default installation directory presented to the end user by the NSIS
  16. # installer is under this root dir. The full directory presented to the end
  17. # user is: ${CPACK_NSIS_INSTALL_ROOT}/${CPACK_PACKAGE_INSTALL_DIRECTORY}
  18. #
  19. # .. variable:: CPACK_NSIS_MUI_ICON
  20. #
  21. # An icon filename. The name of a ``*.ico`` file used as the main icon for the
  22. # generated install program.
  23. #
  24. # .. variable:: CPACK_NSIS_MUI_UNIICON
  25. #
  26. # An icon filename. The name of a ``*.ico`` file used as the main icon for the
  27. # generated uninstall program.
  28. #
  29. # .. variable:: CPACK_NSIS_INSTALLER_MUI_ICON_CODE
  30. #
  31. # undocumented.
  32. #
  33. # .. variable:: CPACK_NSIS_MUI_WELCOMEFINISHPAGE_BITMAP
  34. #
  35. # The filename of a bitmap to use as the NSIS MUI_WELCOMEFINISHPAGE_BITMAP.
  36. #
  37. # .. variable:: CPACK_NSIS_MUI_UNWELCOMEFINISHPAGE_BITMAP
  38. #
  39. # The filename of a bitmap to use as the NSIS MUI_UNWELCOMEFINISHPAGE_BITMAP.
  40. #
  41. # .. variable:: CPACK_NSIS_EXTRA_PREINSTALL_COMMANDS
  42. #
  43. # Extra NSIS commands that will be added to the beginning of the install
  44. # Section, before your install tree is available on the target system.
  45. #
  46. # .. variable:: CPACK_NSIS_EXTRA_INSTALL_COMMANDS
  47. #
  48. # Extra NSIS commands that will be added to the end of the install Section,
  49. # after your install tree is available on the target system.
  50. #
  51. # .. variable:: CPACK_NSIS_EXTRA_UNINSTALL_COMMANDS
  52. #
  53. # Extra NSIS commands that will be added to the uninstall Section, before
  54. # your install tree is removed from the target system.
  55. #
  56. # .. variable:: CPACK_NSIS_COMPRESSOR
  57. #
  58. # The arguments that will be passed to the NSIS SetCompressor command.
  59. #
  60. # .. variable:: CPACK_NSIS_ENABLE_UNINSTALL_BEFORE_INSTALL
  61. #
  62. # Ask about uninstalling previous versions first. If this is set to "ON",
  63. # then an installer will look for previous installed versions and if one is
  64. # found, ask the user whether to uninstall it before proceeding with the
  65. # install.
  66. #
  67. # .. variable:: CPACK_NSIS_MODIFY_PATH
  68. #
  69. # Modify PATH toggle. If this is set to "ON", then an extra page will appear
  70. # in the installer that will allow the user to choose whether the program
  71. # directory should be added to the system PATH variable.
  72. #
  73. # .. variable:: CPACK_NSIS_DISPLAY_NAME
  74. #
  75. # The display name string that appears in the Windows Add/Remove Program
  76. # control panel
  77. #
  78. # .. variable:: CPACK_NSIS_PACKAGE_NAME
  79. #
  80. # The title displayed at the top of the installer.
  81. #
  82. # .. variable:: CPACK_NSIS_INSTALLED_ICON_NAME
  83. #
  84. # A path to the executable that contains the installer icon.
  85. #
  86. # .. variable:: CPACK_NSIS_HELP_LINK
  87. #
  88. # URL to a web site providing assistance in installing your application.
  89. #
  90. # .. variable:: CPACK_NSIS_URL_INFO_ABOUT
  91. #
  92. # URL to a web site providing more information about your application.
  93. #
  94. # .. variable:: CPACK_NSIS_CONTACT
  95. #
  96. # Contact information for questions and comments about the installation
  97. # process.
  98. #
  99. # .. variable:: CPACK_NSIS_CREATE_ICONS_EXTRA
  100. #
  101. # Additional NSIS commands for creating start menu shortcuts.
  102. #
  103. # .. variable:: CPACK_NSIS_DELETE_ICONS_EXTRA
  104. #
  105. # Additional NSIS commands to uninstall start menu shortcuts.
  106. #
  107. # .. variable:: CPACK_NSIS_EXECUTABLES_DIRECTORY
  108. #
  109. # Creating NSIS start menu links assumes that they are in 'bin' unless this
  110. # variable is set. For example, you would set this to 'exec' if your
  111. # executables are in an exec directory.
  112. #
  113. # .. variable:: CPACK_NSIS_MUI_FINISHPAGE_RUN
  114. #
  115. # Specify an executable to add an option to run on the finish page of the
  116. # NSIS installer.
  117. #
  118. # .. variable:: CPACK_NSIS_MENU_LINKS
  119. #
  120. # Specify links in [application] menu. This should contain a list of pair
  121. # "link" "link name". The link may be an URL or a path relative to
  122. # installation prefix. Like::
  123. #
  124. # set(CPACK_NSIS_MENU_LINKS
  125. # "doc/cmake-@CMake_VERSION_MAJOR@.@CMake_VERSION_MINOR@/cmake.html"
  126. # "CMake Help" "https://cmake.org" "CMake Web Site")
  127. #
  128. #=============================================================================
  129. # Copyright 2006-2009 Kitware, Inc.
  130. #
  131. # Distributed under the OSI-approved BSD License (the "License");
  132. # see accompanying file Copyright.txt for details.
  133. #
  134. # This software is distributed WITHOUT ANY WARRANTY; without even the
  135. # implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  136. # See the License for more information.
  137. #=============================================================================
  138. # (To distribute this file outside of CMake, substitute the full
  139. # License text for the above reference.)
  140. #FIXME we should put NSIS specific code here
  141. #FIXME but I'm not doing it because I'm not able to test it...