Erweiterte Themen > Bootstrapper anpassen > Voraussetzungen für Bootstrapper definieren

Dieses Kapitel beschreibt, wie eigene Definitionen für Voraussetzungen vorbereitet werden.

Standard-Voraussetzungsdefinition

Die mit RayPack vorinstallierten Voraussetzungsdefinitionen sind im PackPoint-Ordner im Unterordner Prerequisite gespeichert, zum Beispiel:

C:\RayPack\PackPoint\Prerequisites

Eine einzelne Voraussetzung wird in einer XML-Datei mit der folgenden Syntax definiert:

<?xml version="1.0"?>

<Prerequisite

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<ProductName>Visual C++ 2010 Runtime Libraries (32-bit)</ProductName>

<Manufacturer>Microsoft Corporation</Manufacturer>

</MetaData>

<Setup>

<Command>vcredist_x86.exe</Command>

<Files>

<Path>($PackPointDir)\Prerequisites\($DepName)\vcredist_x86.exe</Path>

<DownloadPath>http://download.microsoft.com/download/5/B/C/

5BC5DBB3-652D-4DCE-B14A-475AB85EEF6E/

vcredist_x86.exe</DownloadPath>

<DownloadPage>https://www.microsoft.com/en-us/download/details.aspx?

id=40784</DownloadPage>

</File>

...

</Files>

</Setup>

<Condition Type="Registry" Property="None" Check="NotExist"

Architecture="SystemDefault">

<Path>HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\

Uninstall\{196BB40D-1578-3D01-B289-BEFC77A11A1E}</Path>

</Condition>

<Condition Type="OperatingSystem" Property="Version" Check="Equals"

Architecture="X86">

</Condition>

<Condition Type="OperatingSystem" Property="Version" Check="Equals"

Architecture="SystemDefault">

</Condition>

...

</Conditions>

<Path>($PackPointDir)\Prerequisites\WindowsInstaller_3.1_x86.rpdep</Path>

</Dependency>

...

</Dependencies>

</Prerequisite>

MetaData

Enthält eine Definition grundlegender Details wie Name und Version, die in der PackDesigner-Oberfläche angezeigt werden.

•ProductName
Der im Browser für Voraussetzungen anzuzeigende Name.

Beispiel:
Visual C++ 2010 Runtime Libraries (32-bit)

•ProductVersion:
Die im Browser für Voraussetzungen anzuzeigende Version.

Beispiel:

10.0.30319.1

•Manufacturer
Der im Browser für Voraussetzungen anzuzeigende Hersteller.

Beispiel
Microsoft Corporation

•SchemaVersion
Ein reservierter Wert, der die Version des Schemas angibt. Muss auf 1.0 gesetzt werden.

Setup

Enthält eine Definition der Setup-Routine – welche Dateien enthalten sein sollen, welcher Befehl zur Installation des Pakets verwendet wird usw.

•Command
Der Befehl, der zur Installation des Pakets ausgeführt wird.

Beispiel:
vcredist_x86.exe

•Arguments (optional)
Die zusätzlichen Argumente, die an den Befehl übergeben werden. In vielen Szenarien sollten hier Stille-Schalter verwendet werden.

Beispiel:
/q

•ExitCodes (optional)
Eine Liste der von der installierenden Anwendung zurückgegebenen Exit-Codes, die als „positiv" gelten. Wenn der einzig gültige Exit-Code „0" ist, kann dieser Wert leer gelassen werden. Wenn die Installation einen Exit-Code hat, der bedeutet, dass das Produkt bereits installiert ist, sollte der entsprechende Exit-Code hier angegeben werden. Der Exit-Code 0 gilt immer als korrekter Exit-Code, auch wenn er nicht in der Liste angegeben ist.

Beispiel:
1641,3010

•Files
Eine Liste der für die Installation erforderlichen Dateien. Siehe den nächsten Abschnitt für die Definition einer einzelnen Datei.

File

Enthält eine Definition der Setup-Routine – welche Dateien enthalten sein sollen, welcher Befehl zur Installation des Pakets verwendet wird usw.

•FileHash (optional)
Der Hash der Datei, mit dem überprüft wird, ob die heruntergeladene Datei nicht beschädigt oder unvollständig ist. Wenn weggelassen, wird der CRC-Hash der tatsächlichen Quelldatei nicht überprüft.

Beispiel:
B88228D5FEF4B6DC019D69D4471F23EC

•Size (optional)
Die Größe der Datei in Bytes. Wenn weggelassen, wird die Größe der tatsächlichen Quelldatei nicht überprüft.

Beispiel:
5073240

•Path
Der lokale Pfad, an dem die Ressource vorhanden sein soll. Platzhalter können verwendet werden, um das PackPoint-Verzeichnis und den Abhängigkeitsnamen aufzulösen.
($PackPointDir) wird zum vollständigen PackPoint-Verzeichnis aufgelöst, z. B. C:\RayPack\PackPoint
($DepName) wird zum Namen der .rpdep-Datei aufgelöst, z. B. VCRedistr_2010_x86.

Beispiel:
($PackPointDir)\Prerequisites\($DepName)\vcredist_x86.exe

Dieser Wert ist erforderlich und muss auf einen gültigen Dateispeicherort zeigen.

•DownloadPath (optional)
Die Quell-URL zum Herunterladen der Datei. Der Wert kann leer sein, wenn kein direkter Download-Link vorhanden ist.

Beispiel:
http://download.microsoft.com/download/5/B/C/5BC5DBB3-652D-4DCE-B14A-475AB85EEF6E/vcredist_x86.exe

•DownloadPage (optional)
Die Seiten-URL zum Herunterladen der Datei. Der Wert kann leer sein, wenn keine Download-Seite vorhanden ist.

Beispiel:
https://www.microsoft.com/en-us/download/details.aspx?id=40784

Dependency

Enthält eine Definition der Setup-Routine – welche Dateien enthalten sein sollen, welcher Befehl zur Installation des Pakets verwendet wird usw.

•Path
Ein Pfad zu einer .rpdep-Datei, die eine Abhängigkeit für eine bestimmte Voraussetzung enthält.

Beispiel:
($PackPointDir)\Prerequisites\WindowsInstaller_3.1_x86.rpdep

Dieser Wert ist erforderlich und muss auf einen gültigen Dateispeicherort zeigen.