The SuezCollection

WIX

Allgemein

WIX ist die Abkürzung für Windows Installer XML. WIX stammte ursprünglich von Microsoft und war eines der ersten Programmpakete, die von MS OpenSource gestellt wurden. Detail kann man hier nachlesen Historie .

Einbau

Wie wird CPack mit diesem Generator in CMake integriert? Wie fast alles bei CMake: Über die CMakeLists-Datei.

Projekt herunter laden .







	1:	# CMake Grundsätzliches -------------------------------------------
	2:	CMAKE_MINIMUM_REQUIRED(VERSION 3.0.0)
	3:	IF (POLICY CMP0048)
	4:		CMAKE_POLICY(SET CMP0048 NEW) # Wg. VERSION im project Befehl
	5:	ENDIF (POLICY CMP0048)
	6:	
	7:	# Start d. Projekts -----------------------------------------------
	8:	PROJECT(Simple VERSION 1.2.3)
	9:	
	10:	ADD_EXECUTABLE(tm tm.c)
	11:	
	12:	INSTALL(TARGETS tm DESTINATION bin)
	13:	INSTALL(FILES tm.c DESTINATION src)
	14:	
	15:	# Standard --------------------------------------------------------
	16:	# GUID mit MSVC erstellen
	17:	SET(CPACK_WIX_UPGRADE_GUID "E7511A05-2B91-47C6-973A-23E7827CBEB7")
	18:	# Sprache
	19:	SET(CPACK_WIX_CULTURES "de-DE")
	20:	# WIX Generator
	21:	SET(CPACK_GENERATOR WIX)
	22:	# Standard Ende ---------------------------------------------------
	23:	
	24:	INCLUDE(CPack)

Erläuterungen

Zeile 1: Nur CMake mit Version größer oder gleich 3.0.0 dürfen verwendet werden
Zeilen 2-3: Das CMake-Entwickler Team möchte das Projekte, die mit CMake Vers. 1.0 entwickelt wurden auch mit CMake Vers. 3.x, ohne Änderung verwendet werden können. Das führt manchmal zu gewissen Schwieigkeiten. In diesem Fall, weil im Projekt-Befehl "project" die Option "version" verwendet wird. Dies ist nur möglich, wenn CMP0048 aud new gesetzt wird (s.a Die Bedeutung von CMP0048 ). Natürlich könnte man zur Versionierung die CPACK-Variablen CPACK_PACKAGE_VERSION_etc. verwenden. Diese gelten aber dann nur für den Generator.
Zeile 6: Projektname mit Version, die für das ganze Projekt gilt.
Zeile 7: Erstellung eines Programms.
Zeilen 10-11: Installation des Programms und der Quell-Datei.

Die folgenden Skrikt-Zeilen betreffen ausschließlich den WIX-Generator.

Zeile 13: Der WIX-Generator benötigt eine die globale ID GUID (Globally Unique IDentifier) damit er überprüfen kann, ob das Programmpakt schon installiert ist. Am einfachsten wird diese ID im Visual Studio im Menü "Extras -> GUID erstellen" erzeugt.
Zeile 14: Legt die Sprache fest, die der Generator verwenden soll.
Zeile 15: Bestimmt den Generator.
Zeile 17: Lädt die CPack Skripte.

Erstellung des Installtionsprogramm

Im Projektmappen-Explorer existiert der Eintrag "Package". Dieser Eintrag muss ausgewählt werden. Dann rechte Maustaste und aus dem Context-Menü "erstellen" auswählen => das Installations-Paket wird erstellt.

Ausführung der Installation

Der WIX-Generator erzeugt erzeugt eine Datei namens Simple-1.2.3-win65.msi. Wenn man diese Datei ausführt, startet die Installation.

Bild 1: Standard-Eröffnung des Inst.-Assistenten

Abnicken der Lizenzvereinbarung — Bild 1: Standard-Eröffnung des Inst.-Assistenten

Fertig. Das Programm wird installiert.

Installationsverzeichnis

Das Installationsverzeichnis ist "C:\Program Files". Mit SET(CPACK_PACKAGE_INSTALL_DIRECTORY /meinVerzeichnis/uV) kann man sein Software-Paket in "C:\Program Files\meinVerzeichnis\uV" installieren. (Man beachte das im CMake-Paket grundsätzlich mit dem normalen Beistrich gearbeitet wird).