CPackNSIS.cmake 4.5 KB

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