Inhaltsverzeichnis
Für weitere Hilfe setzen Sie sich mit dem Technischen Support von Asymetrix in Verbindung.

	Einführung in das Asymetrix-Installationswerkzeug Verwenden von SETUPMGR.EXE


Einführung in das Asymetrix-Installationswerkzeug

Wissenswertes über das Asymetrix-Installationswerkzeug

Installationsvorgang

Vertriebsdisketten

Vertreiben von Runtime ToolBook

Das Installationsskript

Dialogfeld Installationsoptionen

Dialogfeld Komponentenauswahl

Dialogfeld Systemdateien


Verwenden von SETUPMGR.EXE (Themenliste)
Verwenden von SETUPMGR.EXE

Verwenden von SETUPMGR.EXE

Register Allgemein

Register Dateien

Register PM-Symbole

Register Konfiguration

Register EXE starten

Register Disketten erstellen

Hinzufügen der Runtime ToolBook-Komponente

Installieren von Runtime ToolBook (allgemein)

Tips zum Vertreiben von Runtime ToolBook mit Ihren Anwendungen

Menü Datei

Menü Bearbeiten

.INF-Datei

Angepaßte Installationen


Informationen zum Technischen Support

Support per Telefon

Setzen Sie sich mit Asymetrix unter der unten aufgelisteten Telefonnummern für Informationen über Support-Verträge in Verbindung.

Australien/Ostpazifik	(61+3) 5255471
Europa (außer Frankreich und Deutschland), Naher Osten, Afrika, Russland	44-923-208-433
UK	0800-716-957 (gebührenfrei)
Frankreich	05-90-83-19 (gebührenfrei)
Deutschland	01-30-81-27-07 (gebührenfrei)
USA und der Rest der Welt	206-637-1600
Online-Dienste

Asymetrix bietet registrierten Benutzern gratis Support über Fax, den Asymetrix-Infoservice, CompuServe, America Online und das Internet. Unser Support-Personal beantwortet Ihre Online-Fragen innerhalb von 48 Stunden (montags bis freitags).

Technischer Support per Fax

Australien/Ostpazifik	(61+3) 5255-482

Europa	44-923-208-419

USA	206-454-0672

CompuServe

Windows Third Party Developer A-Forum, Abschnitt 1	go asymetrix oder go winapa

Multimedia Vendors-Forum, Abschnitt 15	go multiven

IBM Ultimedia Tools A-Forum, Abschnitt 5	go ultiatools

Internet

techsup@asymetrix.com

support@asymetrix.com


Wissenswertes über das Asymetrix-Installationswerkzeug
Einführung in das Asymetrix-Installationswerkzeug

Das Asymetrix-Installationswerkzeug gibt Programmentwicklern eine einfache Methode, professionelle Installationsprogramme zu erstellen, die der Benutzer zum Installieren der Anwendung benutzen kann. Das Asymetrix-Installationswerkzeug kann mit Anwendungen eingesetzt werden, die mit jedem Programmierwerkzeug oder -sprache erstellt wurden.

Das Werkzeug stellt die Hilfsmittel zur Verfügung, die Sie zum Erstellen eines Installationsskripts für Ihre Anwendung benötigen.

Bietet dem Benutzer ein professionelles, leicht zu bedienendes Installationspaket.

Erstellt Vertriebsdisketten mit komprimierten Dateien

Das Installations-Werkzeug besteht aus zwei Teilen:

SETUPMGR.EXE, einer ToolBook-Anwendung, mit der Sie das Installationsskript für Ihre Anwendung und die Installationsdateien auf Disketten erstellen können. SETUPMGR.EXE speichert die Skriptanweisungen in einer Datei mit der Erweiterung .INF.

SETUP.EXE, die Anwendung, die der Benutzer zum Installieren der Anwendung benutzt.

Wenn der Benutzer SETUP.EXE ausführt, kopiert dieses zuerst einige Dateien in das temporäre Verzeichnis, das es anlegt und während der Installation verwendet. Dann führt es die Anweisungen in der .INF-Datei aus, um die Anwendung zu installieren. Wenn es mit der Installation fertig ist, löscht es die temporären Dateien und das temporäre Verzeichnis.


Einführung in das Asymetrix-Installationswerkzeug

Dialogfeld Komponentenauswahl

Vertriebsdisketten

Dialogfeld Installationsoptionen

Installationsvorgang

Das Installationsskript

Verwenden von SETUPMGR.EXE

Verwenden von SETUPMGR.EXE


Installationsvorgang
Einführung in das Asymetrix-Installationswerkzeug

Sie verstehen Ihre Arbeit mit SETUPMGR.EXE am besten, wenn Sie an das Endergebnis des Vorgangs denken: die Installation der Anwendung auf dem System des Benutzers. Mit SETUPMGR.EXE richten Sie die Anweisungen ein, die die Art der Interaktion zwischen dem Installationsprogramm und dem Benutzer steuert und die Anwendung installiert.


Einführung in das Asymetrix-Installationswerkzeug

Dialogfeld Komponentenauswahl

Vertriebsdisketten

Dialogfeld Installationsoptionen

Das Installationsskript

Verwenden von SETUPMGR.EXE

Verwenden von SETUPMGR.EXE


Vertriebsdisketten
Einführung in das Asymetrix-Installationswerkzeug

SETUPMGR.EXE stellt Master-Vertriebsdisketten her, die die zur Installation benötigte Software enthalten. Die erste Diskette enthält SETUP.EXE sowie die erste komprimierte Installationsdatei. Falls nötig werden weitere Disketten erstellt, die zusätzliche Teile der komprimierten Installationsdatei enthalten.

Das Vertriebsmedium kann eine Diskette beliebiger Größe oder eine CD-ROM sein.


Einführung in das Asymetrix-Installationswerkzeug

Dialogfeld Komponentenauswahl

Dialogfeld Installationsoptionen

Verwenden von SETUPMGR.EXE

Verwenden von SETUPMGR.EXE


Vertrieb von Runtime ToolBook
Einführung in das Asymetrix-Installationswerkzeug

Das Asymetrix-Intstallationswerkzeug macht es Ihnen leicht, die Runtime ToolBook-Dateien mit Ihrer Anwendung mitzuliefern. Durch Klicken auf eine Schaltfläche in SETUPMGR.EXE können Sie eine spezielle Komponente zu Ihrer .INF-Datei hinzufügen, die die angegebenen Runtime ToolBook-Dateien enthält.

Während der Installation Ihrer Anwendung prüft SETUPMGR.EXE, ob eine Kopie derselben Version von Runtime ToolBook auf dem Zielsystem bereits vorhanden ist. Falls ja, installiert SETUPMGR.EXE die neue Kopie am selben Speicherort, so daß der Benutzer am Schluß nicht zwei Kopien derselben Datei hat.

Falls gewünscht, können Sie diese Funktionen außer Kraft setzen, wenn Sie eine Runtime-Komponente selbst erstellen und diese in einem von Ihnen angegebenen Verzeichnis installieren wollen.


Verwenden von SETUPMGR.EXE

Register Dateien

Hinzufügen der Runtime ToolBook-Komponente

Installieren von Runtime ToolBook (allgemein)

Tips zum Vertreiben von Runtime ToolBook mit Ihren Anwendungen


Hinzufügen der Runtime ToolBook-Komponente
Verwenden von SETUPMGR.EXE

Wenn Sie Runtime ToolBook zusammen mit Ihrer Anwendung ausliefern wollen, fügen Sie eine Komponente zum Installationsskript hinzu, die die Runtime-Dateien installiert. Sie können dies auf zwei Weisen erreichen:

1.	Klicken Sie auf die Schaltfläche "Allgemeine Runtime ToolBook-Komponente hinzufügen" im Register Dateien, um SETUPMGR.EXE zu veranlassen, eine Komponente mit allen benötigten Dateien zu installieren.

2.	Erstellen Sie Ihre eigene Runtime-Komponente genau wie jede andere Komponente, wobei Sie alle benötigten Dateien selbst angeben müssen.

Die erste Methode bringt einige Vorteile:

Sie müssen die Dateien nicht einzeln angeben. Dies spart Ihnen Zeit.

Es besteht kein Risiko, daß Sie eine erforderliche Datei vergessen könnten.

Wenn SETUPMGR.EXE die spezielle Komponente mit dem Kennzeichen [AllgemeineKomponente] in Ihrer .INF-Datei findet, prüft es nach, ob eine Kopie von Runtime ToolBook bereits existiert. Falls ja, verwendet SETUPMGR.EXE diese Kopie und installiert kein Duplikat.

Wenn Sie die zweite Methode verwenden, wird die Runtime-Komponente wie jede andere Komponente behandelt. Sie können sie zu einem beliebigen Zeitpunkt beim Installationsvorgang aufrufen, und sie wird im von Ihnen angegebenen Verzeichnis gespeichert, gleichgültig, ob sich eine andere Kopie von Runtime ToolBook bereits auf dem System befindet oder nicht (es sei denn, der Benutzer gibt ein anderes Verzeichnis an oder die Option zur Installation dieser Komponente ist deaktiviert).

Vollständige Informationen darüber, wie SETUP.EXE den Speicherort der [AllgemeinenKomponente] feststellt, finden Sie unter Installieren von Runtime ToolBook (allgemein).


Verwenden von SETUPMGR.EXE

Installieren von Runtime ToolBook (allgemein)

Tips zum Vertreiben von Runtime ToolBook mit Ihren Anwendungen


Installieren von Runtime ToolBook (allgemein)
Verwenden von SETUPMGR.EXE

Sobald SETUPMGR.EXE die Komponente mit dem Kennzeichen [AllgemeineKomponente] in der .INF-Datei findet, muß es feststellen, in welchem Verzeichnis Runtime ToolBook installiert werden soll. Dieser Vorgang dient dazu, die Installation von Duplikaten der Runtime-Dateien zu verhindern, falls diese Dateien auf dem Zielsystem bereits vorhanden sind.

Das folgende Flußdiagramm veranschaulicht diesen Vorgang, der vor der Anzeige des Startbildschirms durchgeführt wird.


Verwenden von SETUPMGR.EXE

Hinzufügen der Runtime ToolBook-Komponente

Tips zum Vertreiben von Runtime ToolBook mit Ihren Anwendungen


Module registriert?

Wird das Modul in der ASYM.INI angegeben?


Registrierter Pfad entspricht Standard-Pfad?

Ist der in der ASYM.INI-Datei eingetragene Pfad derselbe wie der in der .INF-Datei angegebene Standard-Pfad?


Stimmen die Sprachen überein?

Hat das in der ASYM.INI registrierte Modul dieselbe Sprache wie das zu installierende Modul?


Sprachspezifisches Unterverzeichnis erstellen

Erstellen Sie im Verzeichnis, das das registrierte Modul enthält, ein Unterverzeichnis. Dieses Verzeichnis hat denselben Namen wie die Sprache des zu installierenden Moduls (z.B. /Deutsch, /Englisch).


Moduldateien im Standard-Pfad installieren

Es sind keine anderen Kopien der Runtime ToolBook-Dateien in derselben Version oder Sprache auf dem Zielsystem vorhanden. Installieren Sie das Modul im Zielverzeichnis, das in der .INF-Datei angegeben ist.


Moduldateien im sprachspezifischen Unterverzeichnis installieren

Auf dem Zielsystem ist eine andere Kopie von Runtime ToolBook in derselben Version, jedoch in einer anderen Sprache. Installieren Sie das neue Modul in einem Unterverzeichnis.


Moduldateien in einem registrierten Pfad iinstallieren
Moduldateien in einem registrierten Pfad installieren

Auf dem Zielsystem ist eine andere Kopie von Runtime ToolBook in derselben Version und Sprache vorhanden. Überschreiben Sie die vorhandene Kopie und installieren Sie das neue im selben Verzeichnis.


Modul, Pfad und Sprache in der ASYM.INI-Datei registrieren

Registrieren Sie das neue Modul, den neuen Pfad und die neue Sprache in der ASYM.INI-Datei.


Menü Datei
Verwenden von SETUPMGR.EXE

Befehl	Beschreibung
Neu	Öffnet eine neue .INF-Datei. Falls die aktuelle Datei ungespeicherte Änderungen hat, werden Sie zum Speichern aufgefordert.
Öffnen	Öffnet eine vorhandene .INF-Datei. Wenn die aktuelle Datei ungespeicherte Änderungen hat, werden Sie zum Speichern aufgefordert.
Speichern	Speichert Ihre Arbeit. Wenn Ihre Arbeit noch nicht mit einem Namen gespeichert wurde, erscheint das Dialogfeld Speichern unter.
Speichern unter	Wird zum Speichern von Arbeit verwendet, die noch nicht gespeichert wurde, oder zum Speichern einer Datei unter einem neuen Namen.
Beenden	Beendet das Programm. Falls die aktuelle Datei ungespeicherte Änderungen hat, werden Sie zum Speichern aufgefordert.


Menü Bearbeiten
Verwenden von SETUPMGR.EXE

Befehl	Beschreibung
Ausschneiden	Entfernt den markierten Text und überträgt ihn in die Windows-Zwischenablage.
Kopieren	Legt eine Kopie des markierten Texts in der Zwischenablage ab.
Einfügen	Fügt den Inhalt der Zwischenablage an der Einfügemarke ein oder ersetzt den markierten Text.
Löschen	Entfernt den markierten Text, ohne ihn in die Zwischenablage zu übertragen.


Verzeichnis-Platzhalter
Verwenden von SETUPMGR.EXE

Verzeichnis-Platzhalter sind Zeichenfolgen, die für Verzeichnisse stehen. Während der Installation werden diese Platzhalter durch den tatsächlichen Pfad und Verzeichnisnamen ersetzt, wie dieser vom Benutzer angegeben oder von SETUP.EXE bestimmt wurde.

Die Verzeichnis-Platzhalter sind wie folgt:

$Windows$	Pfadname des Windows-Verzeichnisses auf dem Zielsystem.
$system$	Pfadname des Windows-Systemverzeichnisses auf dem Zielsystem.
$install$	Pfadname des Verzeichnisses, in dem die Anwendung installiert wird.
$source$	Pfadname des Verzeichnisses, von dem SETUP.EXE gestartet wurde.
$common$	Pfadname des Verzeichnisses, in dem die Runtime ToolBook-Dateien installiert werden.
Zum Einfügen eines Platzhalters klicken Sie auf die Schaltfläche "Verzeichnis einfügen" und dann auf die zutreffende Schaltfläche im Dialogfeld, das dann erscheint:


.INF-Datei
Verwenden von SETUPMGR.EXE

Die .INF-Datei ist ein Windows-kompatibles Profil. Sie enthält die folgenden Abschnitte.

Abschnitt	Informationen
[Allgemein]	Allgemeine Informationen zur Installation.
[Komponente <n>]	Ein Komponente-Abschnitt enthält Installationsanweisungen für einen bestimmten Teil der Anwendung, den der Benutzer wahlweise installieren oder übergehen kann. Es existiert ein [Komponente]-Abschnitt für jede Komponente der Anwendung; der Wert n entspricht der Nummer der jeweiligen Komponente.
[Standard-Komponente]	Die Standard-Komponente enthält Anweisungen, die immer ausgeführt werden, wenn der Benutzer einen Teil der Anwendung installiert.

Im folgenden wird ein typisches Skript aufgeführt. Die wichtigsten Teile des Skripts erscheinen als Aktionsbereiche, auf die Sie klicken können, um weitere Informationen anzuzeigen.

[General]

Title=The Ticket Kiosk

Background=Blue,Tiled,C:\TBEA\CLIPART\BITMAPS\COAST.BMP

Directory=c:\tickets

Splash=C:\TBEA\CLIPART\BITMAPS\TREE.BMP,3000

ArchiveName=KIOSK2

RegistrationINI=$Windows$\asym.ini,Registered Apps

FullInstallBMP=DEFAULT

Common=MTB30,$windows$\asym\setup,3.0,United States

[Component0]

Name=Ticket Sales

TotalSize=83114

File0=ticksale.tbk,$Install$,c:\tbea\setup,AskUser

File1=tb30pdx.dll,$Install$,c:\tbea,AlwaysCopy

File2=irpcx9.flt,$Install$\ticksale,c:\tbea\filters,AlwaysCopy

File3=credit.ico,$Install$,c:\tbea\icons,AlwaysCopy

PMGroupItem0=The Ticket Kiosk,$Install$\,Ticket Sales,$Install$\CREDIT.ICO

[Component1]

Name=Event Calendar

TotalSize=240262

File0=calendar.tbk,$Install$,c:\tbea\setup,AskUser

File1=dl_inf01.bmp,$Install$,c:\tbea\setup,AlwaysCopy

File2=dl_inf02.bmp,$Install$,c:\tbea\setup,AlwaysCopy

File3=dlgs.dll,$Install$,c:\tbea\setup,AlwaysCopy

File4=calendar.ico,$Install$,c:\tbea\icons,AlwaysCopy

PMGroupItem0=The Ticket Kiosk,$Install$\,Event Calendar,$Install$\CALENDAR.ICO

Ini0=$Install$\mmfiles.ini,Sounds,Dir1,$Install$\media\sounds

[Component2]

Name=Seating Chart

TotalSize=157887

File0=seatchrt.tbk,$Install$\seating,c:\tbea\setup,AlwaysCopy

File1=xlcall.dll,$Install$,c:\excel,AlwaysCopy

File2=readme.txt,$Install$,c:\excel,AlwaysCopy

File3=butnprop.bmp,$Install$,c:\jx_hlp,AlwaysCopy

File4=chkprop.bmp,$Install$,c:\jx_hlp,AlwaysCopy

File5=iconprop.bmp,$Install$,c:\jx_hlp,AlwaysCopy

File6=lftsign.ico,$Install$,c:\tbea\icons,AlwaysCopy

PMGroupItem0=The Ticket Kiosk,$Install$\,Seating Chart,$Install$\LFTSIGN.ICO

Ini0=$Install$\mmfiles.ini,AVI,Dir1,$Install$\media.avi

[CommonComponent]

Name=MMTB runtime

TotalSize=2623135

File0=mtb30bas.dll,$Common$,C:\TBEA,IfNewer

File1=mtb30run.exe,$Common$,C:\TBEA,IfNewer

File2=mtb30cmp.dll,$Common$,C:\TBEA,IfNewer

File3=mtb30flt.dll,$Common$,C:\TBEA,IfNewer

File4=mtb30utl.dll,$Common$,C:\TBEA,IfNewer

File5=mtb30net.exe,$Common$,C:\TBEA,IfNewer

File6=mtb30lnl.dll,$Common$,C:\TBEA,IfNewer

File7=mtb30mm.dll,$Common$,C:\TBEA,IfNewer

File8=mtb30bmp.dll,$Common$,C:\TBEA,IfNewer

File9=tbload.exe,$Common$,C:\TBEA,IfNewer

File10=mtb30mm.ini,$Common$,C:\TBEA,IfNewer

File11=pcdxbmp.dll,$Common$,C:\TBEA,IfNewer

File12=pcdlib.dll,$Common$,C:\TBEA,IfNewer

File13=photo.dll,$Common$,C:\TBEA,IfNewer

Autoexe0=path=$Common$,%path%

[DefaultComponent]

Autoexec0=set path=$Install$,%path;

Action0=$Windows$\notepad.exe $Install$\readme.txt

Message0="Thanks for using The Ticket Kiosk. Please send in your registration card right away, and

}


Verwenden von SETUPMGR.EXE

Register Konfiguration

Register Disketten erstellen

Register Dateien

Register Allgemein

Register EXE starten

Register PM-Symbole


Komponente <n>

Ein Komponente-Abschnitt enthält Installationsanweisungen für einen Teil der Anwendung, den der Benutzer wahlweise installieren oder nicht installieren kann. Es besteht ein [Komponente]-Abschnitt für jede Komponente der Anwendung; der Wert entspricht der Nummer der jeweiligen Komponente.


Datei <n>


PM-Gruppe


Konfigurationsänderung

Eine Änderung an einer .INF-Datei, die durchgeführt wird, wenn der Benutzer wählt, eine bestimmte Komponente zu installieren.


Standard-Komponente

Die Standard-Komponente, die Installationsanweisungen enthält, falls der Benutzer wählt, einen beliebigen Teil der Anwendung zu installieren. Diese Komponente kann dieselbe Art von Anweisungen wie jede andere Komponente enthalten, jedoch werden die Angaben Datei <X>, Name, Gesamtgröße und Anfrage bei der Installation ignoriert.


Aktion-Anweisung

Eine Anweisung, die ausgeführt wird, sobald die Installation abgeschlossen ist. Sie können so viele Aktion-Anweisungen wie gewünscht hinzufügen; die Anweisungen werden in der aufgelisteten Reihenfolge ausgeführt.

Das folgende Beispiel startet den Windows-Editor im Windows-Verzeichnis und öffnet die LESEN.TXT-Datei im Zielverzeicnnis.

Action0=$Windows$\notepad.exe $Install$\lesen.txt


Meldung

Eine Meldung, die angezeigt wird, wenn die Installation abgeschlossen ist. (Die Meldung ist eine einzelne Textzeile im Skript. Je nach dem verwendeten Editor müssen Sie evtl. einen Bildlauf durchführen, um die gesamte Meldung sehen zu können.)


Konfigurationsänderung

Eine Konfigurationsänderung, die durchgeführt wird, wenn der Benutzer einen beliebigen Teil der Anwendung installiert.


Archivname

Der Stammname der komprimierten Vertriebsdisketten. Jede Datei hat diesen Namen und eine Erweiterung wie .001, .002, usw.


Startbildschirm


Schaltflächen-Bitmaps

SETUPMGR.EXE legt FullInstallBMP automatisch auf Standard fest. Dies bewirkt, daß die Standard-Bitmaps für die Schaltflächen "Vollständig", "Benutzerdefiniert" und "Beenden" im Dialogfeld Installationsoptionen verwendet werden.

Wenn Sie benutzerdefinierte Bitmaps verwenden wollen, fügen Sie die folgenden Zeilen zur .INF-Datei hinzu.

Skriptzeile	Beschreibung
FullInstallBMP=<Bitmap 1 Pfad/Name>	Gibt die Bitmap für die Schaltfläche "Vollständige Installation" an.
CustomInstallBMP=<Bitmap 2 Pfad/Name>	Gibt die Bitmap für die Schaltfläche "Benutzerdefinierte Installation" an.
ExitInstallBMP=<Bitmap 3 Pfad/Name>	Gibt die Bitmap für die Schaltfläche "Beenden" an.
Der Parameter <Bitmap n Pfad\Name> ist der Pfad und der Name der Bitmap.


Hintergrund


Allgemein

Der Allgemein-Abschnitt des Skripts enthält Installationsanweisungen, die alle Komponenten betreffen, plus Grafiken, die während der Installation erscheinen.


Registrationspfad

Der Pfad zur .INI-Datei, in der Runtime ToolBook registriert werden soll. SETUPMGR.EXE fügt diese Zeile automatisch hinzu.


Registrationsinformation

Informationen, die zur ASYM.INI-Datei hinzugefügt werden. Zusätzlich zur Version und Sprache von Runtime ToolBook enthält diese Angabe den im Register Allgemein angegebenen Standard-Zielpfad. Wenn der Benutzer diesen Pfad ändert, wird der neue Pfad in der ASYM.INI-Datei aufgezeichnet.


Zielverzeichnis

Das Standard-Zielverzeichnis. Die Anwendungsdateien (jedoch nicht unbedingt die Runtime ToolBook-Dateien) werden in diesem Verzeichnis gespeichert, außer wenn der Benutzer ein anderes Verzeichnis angibt.


Allgemeine Komponente

Die Komponente, die Anweisungen zum Installieren der Runtime ToolBook-Dateien enthält. Diese Komponente wird automatisch erstellt, wenn Sie auf die Schaltfläche "Allgemeine Runtime ToolBook-Komponente hinzufügen" im Register Dateien klicken. Wenn Sie eine Runtime ToolBook-Komponente manuell erstellen (indem Sie die Dateien selbst angeben) erhält diese Komponente wie jede andere Komponente die Bezeichnung [Komponente <n>].


Runtime ToolBook-Dateien

Die zur Ausführung von Runtime ToolBook erforderlichen Dateien.


Weitere Anpassung
Verwenden von SETUPMGR.EXE

Einige Funktionen können Sie zu Ihrem Installationsskript hinzufügen, indem Sie die .INF-Datei direkt bearbeiten. (Die .INF-Datei kann mit einem beliebigen Texteditor bearbeitet werden.) Diese Funktionen sind:

Bitmaps für Prozent abgeschlossen

Benutzerdefinierte Bitmaps für Schaltflächen

Abfragen


Bitmaps für Prozent abgeschlossen
Verwenden von SETUPMGR.EXE

SETUP.EXE zeigt eine Meldung an, die anzeigt, wieviel Prozent des Speichervorgangs bei der momentan kopierten Datei abgeschlossen und wieviel Prozent der Installation abgeschlossen ist.

Sie können darüber hinaus dem Allgemein-Abschnitt des Installationsskript Bitmap<X>-Anweisungen hinzufügen, um Bitmaps zu bestimmten Zeitpunken während des Installationsvorgangs anzuzeigen.

Bitmap<X>

Syntax:	Bitmap<X>=BitmapName,Ausrichtung, Startprozent,Endprozent

Parameter:	BitmapName	String	Pfad zur Bitmap-Datei.

Ausrichtung	String	Wie bei Hintergrund-Bitmap, aber Tiled und AllTiled werden ignoriert.

StartPercentage 	Integer	Prozent, bei der die Bitmap angezeigt werden soll.

EndPercentage 	Integer	Prozent, bei der die Bitmap ausgeblendet werden soll.

Beispiel:	Bitmap0=c:\windows\regnote.bmp,UpperRight,0,25

Dieses Beispiel zeigt die Bitmap regnote.bmp in der oberen rechten Ecke des Bildschirms an. Die Bitmap wird bei Beginn des Installationsvorgangs angezeigt und bleibt auf dem Bildschirm, bis die Installation 25 Prozent abgeschlossen ist.

Sie können mehrere Bitmap<X>-Anweisungen verwenden, um mehrere Bitmaps auf dem Bildschirm anzeigen zu lassen. Die Anweisungen werden mit Bitmap<0>, Bitmap<1>, usw. durchnumeriert.


Optionen des Dialogfelds Installationsoptionen
Dialogfeld Installationsoptionen
Verwenden von SETUPMGR.EXE

SETUPMGR.EXE fügt die folgende Zeile automatisch zum Allgemein-Abschnitt des Installationsskripts hinzu:

FullInstallBMP=DEFAULT

Diese Zeile bewirkt, daß das Dialogfeld Installationsoptionen angezeigt wird.

Wenn Sie diese Zeile löschen wird das standardmäßige Windows-Dialogfeld Installationsoptionen angezeigt.

Sie können auch jede oder alle der Standard-Schaltflächen-Bitmaps im benutzerdefinierten Dialogfeld mit Ihren eigenen Bitmaps ersetzen, indem Sie die folgenden Anweisungen hinzufügen.

Skriptzeile	Beschreibung
FullInstallBMP=<bitmap 1 path/name>	Legt die Bitmap für die Schaltfläche "Vollständige Installation" fest.
CustomInstallBMP=<bitmap 2 path/name>	Legt die Bitmap für die Schaltfläche "Benutzerdefinierte Installation" fest.
ExitInstallBMP=<bitmap 3 path/name>	Legt die Bitmap für die Schaltfläche "Beenden" fest.
Der Parameter <Bitmap n Pfad\Name> gibt den Pfad und Namen der Bitmap an.


Abfragen
Verwenden von SETUPMGR.EXE

Sie können jedem Komponentenabschnitt des Skripts Abfrageanweisungen hinzufügen, um den Benutzer mit Ja/Nein-Fragen abzufragen, ob eine bestimmte Komponente installiert werden soll. Die Frage wird angezeigt, wenn die Bedingung in der Anweisung erfüllt ist. Die drei möglichen Bedingungen sind:

IfSelected	Die Frage wird angezeigt, nur wenn die Komponente zur Installation ausgewählt ist.

IfNotSelected	Die Frage wird angezeigt, nur wenn die Komponente nicht zur Installation ausgewählt ist.

Always	Die Frage wird immer angezeigt, gleichgültig, ob die Komponente zur Installaion ausgewählt ist oder nicht.

Abfrage

Syntax:	Query Condition, Text

Parameter:	Bedingung	String	Bestimmt, ob der Benutzer abgefragt werden soll oder nicht. Bei IfSelected wird die Frage nur dann angezeigt, wenn die Komponente zur Installation ausgewählt ist. Bei IfNotSelected wird die Frage nur dann angezeigt, wenn die Komponente zur Installation ausgewählt ist. Bei Always wird die Frage angezeigt, gleichgültig, ob die Komponente zur Installation ausgewählt ist oder nicht.

Text	String	Der Inhalt des Ja/Nein-Meldungsfelds. Die Frage sollte so formuliert werden, daß eine "Ja"-Antwort die Installation der Komponente bestätigt.

Beispiel:	Query = IfNotSelected, "Die ausführbaren Dateien sind nicht zur Installation ausgewählt. Wollen Sie diese Dateien jetzt installieren?"

In diesem Beispiel ist die Komponente nicht zur Installation ausgewählt. Die Meldung wird deshalb angezeigt, und der Benutzer kann durch Klicken auf "Ja" oder "Nein" im Meldungsfeld antworten. Die Antwort des Benutzers auf diese Abfrage übergeht evtl. frühere Benutzerauswahlen in Bezug auf die Installation der Komponente.


Das Installationsskript
Einführung in das Asymetrix-Installationswerkzeug

Das Installationsskript ist eine Reihe von Anweisungen, die das SETUP.EXE-Programm verwendet, um Ihre Anwendung zu installieren. Sie können zum Beispiel bestimmen, welche Dateien mit der Anwendung installiert werden, in welchem Verzeichnis auf dem Zielsystem die Anwendung installiert werden soll und welche Aktionen bei Beendigung der Installation durchgeführt werden sollen (z.B. die Anzeige einer Meldung). Der Benutzer kann die zu installierenden Komponenten der Anwendung (wie in der .INF-Datei definiert) auswählen.

Sie verwenden die Register in SETUPMGR.EXE, um die Anweisungen einzurichten, die dann in einer Textdatei mit der Erweiterung .INF gespeichert werden.

Das Installationsskript kann sehr komplex werden. Es ist wichtig, es gründlich zu testen bevor Sie Ihre Anwendung ausliefern.


Einführung in das Asymetrix-Installationswerkzeug

Dialogfeld Komponentenauswahl

Vertriebsdisketten

Dialogfeld Installationsoptionen

Verwenden von SETUPMGR.EXE


Installationsoptionen (Dialogfeld)
Dialogfeld Installationsoptionen
Einführung in das Asymetrix-Installationswerkzeug

Wenn der Benutzer Ihre Anwendung installiert, erscheint das Dialogfeld Installationsoptionen, sobald der Startbildschirm verschwindet. Der Benutzer kann die Art der Installation (vollständig oder benutzerdefiniert) und ein anderes Zielverzeichnis angeben.


Einführung in das Asymetrix-Installationswerkzeug

Wissenswertes über das Asymetrix-Installationswerkzeug

Dialogfeld Komponentenauswahl


Benutzerdefinierte Installation (Schaltfläche)
Schaltfläche "Benutzerdefinierte Installation"

Wenn der Benutzer auf diese Schaltfläche klickt, erscheint das Dialogfeld Komponentenauswahl, mit dem der Benutzer die zu installierenden Komponenten auswählen kann.


Beenden (Schaltfläche)
Beenden

Durch Klicken auf "Beenden" kann der Benutzer das Installationsprogramm beenden.


Zielverzeichnis

Das Zielverzeichnis der Installation. Dieser Pfad und dieses Verzeichnis werden zu Beginn von SETUP.EXE anhand von Informationen aus der .INF-Datei festgelegt. Der Benutzer kann ein anderes Verzeichnis angeben. Wenn der Benutzer ein nicht vorhandenes Verzeichnis angibt, wird es von SETUP.EXE erstellt (vorausgesetzt, daß es sich auf einem vorhandenen Laufwerk befindet).


Durchsuchen (Schaltfläche)
Schaltfläche "Durchsuchen"

Durch Klicken auf "Durchsuchen" wird ein Dialogfeld geöffnet, in dem der Benutzer ein Laufwerk und Verzeichnis für die Installation auswählen kann.


Vollständige Installation (Schaltfläche)
Schaltfläche "Vollständige Installation"

Der Benutzer klickt auf diese Schaltfläche, um alle Komponenten zu installieren.


Komponentenauswahl (Dialogfeld)
Dialogfeld Komponentenauswahl
Einführung in das Asymetrix-Installationswerkzeug

Wenn der Benutzer eine benutzerdefinierte Installation auswählt, erscheint das Dialogfeld Installationsoptionen. Hier kann der Benutzer die zu installierenden Komponenten auswählen oder ein anderes Zielverzeichnis für die Installation angeben.


Einführung in das Asymetrix-Installationswerkzeug

Wissenswertes über das Asymetrix-Installationswerkzeug

Dialogfeld Installationsoptionen


Fortfahren (Schaltfläche)
Fortfahren

Nachdem die gewünschten Komponenten ausgewählt wurden, klickt der Benutzer auf "Fortfahren", um die Installation einzuleiten.


Zurück (Schaltfläche)
Zurück

Durch Klicken auf "Zurück" kehrt der Benutzer zum Dialogfeld Installationsoptionen zurück. Alle bisher gemachten Auswahlen werden dabei ignoriert.


Komponentenliste

Die Liste der Komponenten und ihre Größen. Beim Öffnen des Dialogfelds sind alle Kontrollkästchen aktiviert. Der Benutzer kann dann Komponenten deaktivieren, indem er die Häkchen aus den Kontrollkästchen entfernt, und die gewünschten Optionen dann erneut aktiviert.


Runtime ToolBook dialog box
Dialogfeld Runtime ToolBook
Einführung in das Asymetrix-Installationswerkzeug


Runtime ToolBook installieren

Falls der Benutzer Runtime ToolBook nicht installieren möchte, kann er das Kontrollkästchen in diesem Feld entfernen.


Zielverzeichnis

Das Verzeichnis, in dem die Runtime ToolBook-Dateien installiert werden. Der Standard-Eintrag in diesem Feld ist der Pfad, der in der Allgemein-Komponente der .INF-Datei angegeben ist. Falls gewünscht, kann der Benutzer diesen Pfad ändern.


Plattenspeicher

Dieses Feld zeigt den erforderlichen Plattenspeicher und den verfügbaren Plattenspeicher auf jedem Laufwerk, in dem die Dateien installiert werden sollen. Unter "Erforderlich" wird der von sämtlichen Komponenten einschließlich Runtime ToolBook-Dateien beanspruchte Plattenspeicher angegeben.


Durchsuchen

Durch Klicken auf diese Schaltfläche wird ein Dialogfeld angezeigt, mit dem der Benutzer das Verzeichnis suchen kann, in dem die Runtime ToolBook-Dateien installiert werden sollen.


Runtime ToolBook-Verzeichnis ändern

Falls die Benutzer die Runtime ToolBook-Dateien in einem anderen als dem aktuellen Verzeichnis speichern wollen, können Sie auf diese Schaltfläche klicken, um das Dialogfeld Runtime ToolBook zu öffnen. Wenn Sie eine zusätzliche Komponente für die Installationsanweisungen für Runtime ToolBook erstellt haben (so daß keine Allgemein-Komponente in der .INF-Datei vorhanden ist) erscheint diese Schaltfläche nicht im Dialogfeld.


Verwenden von SETUPMGR.EXE
Verwenden von SETUPMGR.EXE

SETUPMGR.EXE enthält ein Dialogfeld mit sechs Registern. Klicken Sie auf das Register am oberen Rand des Dialogfelds, um von einem Abschnitt zum anderen zu gelangen. Die Registerabschnnitte stellen folgende Informationen zur Verfügung.

Register	Informationen
Allgemein	Titel der Installations-Dialogfelder.
	Standardverzeichnis der Installation.
	Grafiken, die während der Installation erscheinen.
Dateien	Komponentennamen.
	Dateien, die zur jeweiligen Komponente hinzugefügt werden sollen.
	Gesamtgröße der Komponente.
PM-Symbole	Name der Programmgruppe.
(für jede Installationskomponente)	Beschreibung des Programmelements.
	Befehlszeile.
	Symbol.
Konfiguration (für jede Installationskomponente)	Änderungen, die an .INI, AUTOEXEC.BAT und CONFIG.SYS-Dateien vorgenommen werden müssen.
EXE starten (für jede Installationskomponente)	Befehle, die bei Beendigung der Installation ausgeführt werden sollen.
Disketten erstellen	Laufwerk und Verzeichnis für Archivdateien.
	Name der festgelegten Archivdatei.
	Dateigröße der Archivdatei.
Zum Erstellen einer neuen .INF-Datei füllen Sie die Register aus und wählen Sie die gewünschten Optionen. Wenn Sie fertig sind, speichern Sie die Datei.

Zum Bearbeiten einer vorhandenen .INF-Datei starten Sie SETUPMGR.EXE und öffnen Sie die gewünschte Datei. Die in der Datei gespeicherten Werte erscheinen in den entsprechenden Feldern der Register. Sie können diese Werte nach Wunsch ändern und die Datei erneut speichern.


Register Allgemein
Verwenden von SETUPMGR.EXE

Hinweis: Bitmap-Farben werden den ähnlichsten Farben auf dem Zielsystem zugeordnet. Die besten Ergebnisse erzielen Sie, wenn Sie Bitmaps in die 16 Farben-Palette von Windows umwandeln.


Verwenden von SETUPMGR.EXE

.INF-Datei

Register Konfiguration

Register Disketten erstellen

Register Dateien

Register EXE starten

Register PM-Symbole


Titel (Dialogfeld)
Dialogfeld Titel

Geben Sie den Titel ein, der in der Titelleiste der Dialogfelder Installationsoptionen und Komponentenauswahl erscheinen soll.


Standardverzeichnis

Geben Sie den vollständigen Pfad und das Zielverzeichnis ein, in dem die Anwendung installiert werden soll, oder klicken Sie auf Auswählen und wählen Sie ein Verzeichnis auf Ihrem eigenen System aus. Dieser Pfad erscheint im Dialogfeld Installationsoptionen; falls nötig, kann dieses Verzeichnis vom Benutzer geändert werden.

Sie können im Pfad auch Verzeichnis-Platzhalter verwenden.


Standardverzeichnis auswählen

Wenn Sie auf "Auswählen" klicken, erscheint das Dialogfeld Verzeichnis auswählen. Wählen Sie ein Verzeichnis auf Ihrem System. Der vollständige Pfad zu diesem Verzeichnis wird in das Feld "Standardverzeichnis" eingegeben.


Hintergrund

Eine Beschreibung des Hintergrundbildschirms, der während der Installation erscheint. Der Bildschirm kann einen Farbverlauf und eine Bitmap haben. Die Bitmap kann als einzelne Abbildung oder als nebeneinander geordnetes Bildmuster erscheinen.

Zum Einrichten dieses Bildschirms klicken Sie auf die Schaltfläche Optionen.


Zeitdauer

Die Anzahl der Sekunden, die die Bitmap angezeigt wird. Klicken Sie auf den Aufwärtspfeil, um den Zeitwert zu erhöhen, oder auf den Abwärtspfeil, um ihn zu reduzieren. Wenn Sie die Zeitdauer auf 0 festlegen, bleibt die Start-Bitmap auf dem Bildschirm, bis der Benutzer eine Maustaste klickt oder eine beliebige Taste drückt.


Start-Bitmap

Die Start-Bitmap (auch Start-Bildschirm genannt) erscheint vor dem Hintergrund-Farbverlauf, nachdem das Installationsprogramm die benötigten Dateien in das temporäre Verzeichnis kopiert hat. Sie bleibt auf dem Bildschirm die von Ihnen angegebene Zeitdauer oder bis der Benutzer eine beliebige Taste drückt oder auf die Bitmap klickt. Anschließend wird die Hintergrund-Bitmap (falls vorhanden) angezeigt.

Geben Sie den vollständigen Pfad (auf Ihrem System) und Dateinamen der Start-Bitmap ein. Wenn Sie die Start-Bitmap aus einem Dialogfeld auswählen möchten, klicken Sie auf die Schaltfläche "Auswählen".


Start-Bitmap auswählen

Wenn Sie auf "Auswählen" klicken, erscheint das Dialogfeld "Auswählen". Wählen Sie die gewünschte Bitmap aus. Der Pfad und Name werden in das entsprechende Feld im Register Allgemein eingegeben.


Choose common directory
Allgemeines Verzeichnis auswählen

Wenn Sie für die Runtime ToolBook-Dateien ein anderes Zielverzeichnis angeben wollen, können Sie den Pfad in das Feld "Allgemeines Verzeichnis" eingeben oder auf diese Schaltfläche klicken und den gewünschten Pfad auf Ihrem System auswählen.


Allgemeines Verzeichnis auswählen
Allgemeines Verzeichnis

Das Verzeichnis, in dem die Runtime ToolBook-Dateien installiert werden, wenn Sie die Schaltfläche "Allgemeine Runtime ToolBook-Komponente hinzufügen" im Register Dateien verwenden. Diese Kopie von Runtime ToolBook wird evtl. mit zukünftigen Anwendungen gemeinsam verwendet; deshalb wird empfohlen, daß Sie diese Dateien in einem anderen Zielverzeichnis als die Anwendungsdateien einrichten. Der Benutzer kann dieses Verzeichnis auch während der Installation ändern.


Hintergrundoptionen

Beim Klicken auf die Schaltfläche "Optionen" erscheint das Dialogfeld Hintergrundoptionen.


Farbverlauf

Wählen Sie die Hintergrundfarbe aus. Wenn Sie Rot, Grün oder Blau auswählen, erscheint die Farbe in einem Farbverlauf, wobei hellere Schattierungen am oberen Bildschirmrand und dunklere Schattierungen am unteren Bildschirmrand angezeigt werden.


Ausrichtung

Wählen Sie eine Ausrichtungsoption für die Bitmap aus. Wählen Sie "Kein", wenn Sie keine Bitmap verwenden wollen. Wählen Sie "Angeordnet", wenn die Bitmap in einem sich wiederholenden Muster angeordnet und ein Rahmen um die Bitmap-Gruppe angezeigt werden soll. Wählen Sie "Alle angeordnet", wenn das Bitmap-Muster den gesamten Bildschirm ausfüllen soll.


Bitmap

Geben Sie den vollständigen Pfad (auf Ihrem System) und Dateinamen der Bitmap ein. Klicken Sie auf die Schaltfläche "Auswählen", um eine Bitmap auszuwählen.


Bildschirmabbildung

Der von Ihnen ausgewählte Hintergrund-Farbverlauf und die von Ihnen ausgewählte Bitmap. Die Bitmap wird in verkleinerter Form angezeigt, nicht in der Größe, in der sie auf dem Installationsbildschirm erscheint.


Abbrechen

Klicken Sie auf "Abbrechen", um die von Ihnen vorgenommenen Änderungen abzubrechen und zum vorhergehenden Dialogfeld zurückzukehren.


Bitmap auswählen

Beim Klicken auf diese Schaltfläche erscheint das Dialogfeld Auswählen, in dem Sie eine Bitmap auswählen können. Der Pfad und der Name werden im Feld "Start-Bitmap" im Register Allgemein ausgewählt.


OK

Klicken Sie auf "OK", um die von Ihnen vorgenommenen Änderungen zu speichern und das Dialogfeld zu schließen.


Register Dateien
Verwenden von SETUPMGR.EXE

Im Register Dateien können Sie die Komponenten Ihrer Anwendung einrichten, wobei Sie jeder Komponente einen Namen zuweisen und die Dateien auswählen, aus denen die Komponente besteht. Die Komponente und ihre Größen werden im Listenfeld angezeigt. Mit den Schaltflächen im Dialogfeld können Sie Komponenten hinzufügen und löschen, ihre Namen ändern und die Dateien für die jeweiligen Komponenten auswählen.

"Namen der Installationskomponenten" (z.B. Bibliothek, Hilfe, Editor, usw.) gibt die Dateien an, die im Dialogfeld Komponentenauswahl aufgelistet werden. Hier kann der Benutzer bestimmen, ob die jeweiligen Komponenten installiert werden sollen oder nicht.

Die Namen erscheinen im Dialogfeld Komponentenauswahl in derselben Reihenfolge wie sie in diesem Listenfeld erscheinen. Wenn Sie die Komponenten im Listenfeld umordnen wollen, klicken Sie auf einen Komponentennamen und ziehen Sie ihn an eine neue Position in der Liste.

"Gesamtgröße der Komponente" ist die Gesamtgröße (unkomprimiert) aller Dateien in jeder Komponente. Die Größe wird von SETUPMGR.EXE berechnet, während Sie Dateien auswählen. Diese Größe erscheint im Dialogfeld Komponentenauswahl neben dem jeweilligen Komponentennamen.


Verwenden von SETUPMGR.EXE

.INF-Datei

Register Konfiguration

Register Disketten erstellen

Register Allgemein

Register EXE starten

Register PM-Symbole

Distributing Runtime ToolBook


Hinzufügen@@
Hinzufügen

Klicken Sie auf "Neu", um eine neue Komponente hinzuzufügen. Ein Dialogfeld erscheint, in dem Sie den Namen der neuen Komponente eingeben können.


Namen ändern

Wählen Sie eine Komponente aus und klicken Sie auf "Namen ändern", um ihren Namen zu ändern. Ein Dialogfeld erscheint, in dem Sie den neuen Namen angeben können.


Dateiliste anzeigen

Wählen Sie eine Komponente aus, klicken Sie dann auf "Dateiliste anzeigen" und wählen Sie die Dateien für die Komponente aus. Daraufhin erscheint das Dialogfeld Komponenten-Dateiliste.


Allgemeine Runtime ToolBook-Komponente hinzufügen

Klicken Sie auf "Allgemeine Runtime ToolBook-Komponente hinzufügen", um die zur Ausführung der Runtime-Version von ToolBook erforderlichen Dateien als Komponente Ihrer Anwendung hinzuzufügen. Weitere Einzelheiten hierzu finden Sie unter Installieren von Runtime ToolBook (allgemein).


Löschen@@
Löschen

Wählen Sie eine Komponente aus und klicken Sie dann auf "Löschen", um diese zu entfernen. Daraufhin erscheint eine Meldung, die Sie zur Bestätigung des Löschvorgangs auffordert. Wenn Sie "Ja" wählen, wird die Komponente und alle zugehörigen Informationen aus der .INF-Datei gelöscht; die Dateien selbst werden nicht von Ihrer Festplatte gelöscht.


Namen der Installationskomponenten

Die Namen, die Sie den Komponenten der Anwendung zuweisen.


Gesamtgröße der Komponenten

Die gesamte Byteanzahl (unkomprimiert) in jeder Komponente.


Gesamtgröße der Komponenten
Dialogfeld Kompontenten-Dateiliste
Verwenden von SETUPMGR.EXE

Im Dialogfeld Komponenten-Dateiliste können Sie Dateien für eine Komponente auswählen, die Bedingungen festlegen, unter denen diese Dateien auf die Festplatte des Benutzers kopiert werden sollen, und das Verzeichnis auswählen, in das diese Dateien kopiert werden sollen.


Komponentenname

Der Name der Komponente, die Sie mit dem Register Dateien eingerichtet haben.


Dateiliste

Die Liste der für die ausgewählte Komponente ausgewählten Dateien.


Zielverzeichnis

Das Verzeichnis, in das die Datei kopiert werden soll. Sie können für jede Datei in der Dateiliste ein anderes Zielverzeichnis angeben. Sie können Verzeichnis-Platzhalter im Pfad verwenden. Der Benutzer wird diesen Pfad bei der Installation nicht ändern können.


Schließen

Klicken Sie auf "Schließen", um das Dialogfeld zu schließen und zum vorhergehenden Dialogfeld zurückzukehren.


Kopieren wann@@
Kopieren wann
Verwenden von SETUPMGR.EXE

Zeigt Optionen zum Kopieren einer bestimmten Datei bei der Installation der jeweiligen Komponente. Die Standardeinstellung ist "Immer kopieren". Um eine andere Option auszuwählen, klicken Sie auf den Abwärtspfeil und treffen Sie eine Auswahl aus der Liste. Die Optionen sind:

Immer kopieren. Die Datei wird auf jeden Fall kopiert. Wenn sich eine Datei mit demselben Namen im Zielverzeichnis befindet, wird diese überschrieben, ohne zur Bestätigung aufzufordern.

Benutzer fragen. Vor dem Kopieren wird der Benutzer gefragt, ob die Datei kopiert werden soll. Wenn der Benutzer mit "Ja" antwortet und eine Datei mit demselben Name bereits im Zielverzeichnis vorhanden ist, wird diese überschrieben, ohne zur Bestätigung aufzufordern.

Wenn nicht vorhanden. Kopiert die Datei, nur wenn keine Datei mit demselben Namen im Zielverzeichnis vorhanden ist.

Neuste Version. Kopiert die Datei, wenn sie eine neuere Version ist als die Datei desselben Namens im Zielverzeichnis.

Neuste Version auf System. Kopiert die Datei, wenn sie die neuste Version mit demselben Namen auf dem System des Benutzers ist. Wenn die ältere Datei sich im Zielverzeichnis befindet, wird sie überschrieben. Wenn sie sich in einem anderen Verzeichnis des Systems befindet, wird sie nicht überschrieben oder gelöscht. In diesem Fall hat der Benutzer zwei Dateien desselben Namens in jeweils verschiedenen Verzeichnissen.

Sicherungsdatei erstellen. Falls eine Datei mit demselben Namen im Zielverzeichnis vorhanden ist, wird eine Sicherungskopie (mit der Erweiterung .BAK) erstellt, bevor die neue Datei kopiert wird.

Hinweis: Beim Vergleichen des Erstelldatums von Dateien verwendet SETUP.EXE die Windows-Versionsinformationen, falls vorhanden. Falls nicht, werden die Datums- und Uhrzeitangaben von DOS verwendet.


Verzeichnis einfügen

Klicken Sie auf "Verzeichnis einfügen", um einen Verzeichnis-Platzhalter in den Pfad einzufügen. Um einen Platzhalter einfügen zu können, müssen Sie die Einfügemarke zuerst in ein veränderbares Feld setzen.


Dateien auswählen (Schaltfläche)
Dateien auswählen

Klicken Sie auf die Schaltfläche "Dateien auswählen", um die Dateien für die Komponente auszuwählen. Daraufhin erscheint das Dialogfeld Dateien auswählen.


Löschen

Zum Löschen einer Datei aus der Dateiliste für die Komponente klicken Sie auf den Dateinamen und dann auf "Löschen".


Dateien auswählen (Dialogfeld)
Dialogfeld Dateien auswählen
Verwenden von SETUPMGR.EXE


Dateiauswahlbereich

Standardmäßige Windows-Dialogfelder für Dateien und Verzeichnisse, die zum Auswählen der Dateien verwendet werden, die Sie zu einer Komponente hinzufügen wollen.


Ausgewählte Dateien

Die Liste der für die aktuelle Komponente ausgewählten Dateien.


Hinzufügen (Schaltfläche)
Hinzufügen

Wählen Sie aus dem Feld "Dateiname" eine Datei aus und klicken Sie dann auf "Hinzufügen", um sie zum Feld "Dateien" hinzuzufügen.


Alle hinzufügen (Schaltfläche)
Alle hinzufügen

Wählen Sie ein Verzeichnis im Listenfeld "Verzeichnisse" aus und klicken Sie dann auf "Alle hinzufügen", um alle Dateien im Verzeichnis zum Listenfeld "Ausgewählte Dateien" hinzuzufügen.


Entfernen (Schaltfläche)
Entfernen

Zum Entfernen einer Datei aus einer Liste der ausgewählten Dateien klicken Sie zuerst auf den Dateinamen und dann auf "Entfernen".


Register PM-Symbole
Verwenden von SETUPMGR.EXE

Verwenden Sie dieses Register, um die von SETUP.EXE erstellten Programmgruppen und Programmsymbole einzurichten.


Verwenden von SETUPMGR.EXE

.INF-Datei

Register Konfiguration

Register Disketten erstellen

Register Dateien

Register Allgemein

Register EXE starten


Programmsymbole

Die Zeilen in diesem Feld geben die Programmgruppe, Beschreibung und Befehlszeileninformationen an, die in den daruntenstehenden Feldern eingegeben wurden. Zum Hinzufügen einer neuen Zeile für Programmsymbol klicken Sie unterhalb der untersten, vorhandenen Zeile und geben Sie die Informationen in die Felder im unteren Bereich des Fensters ein.


Mit Komponente installiert

Der Name der Komponente, für die diese Programmgruppe erstellt werden soll. Wenn der Benutzer wählt, diese Komponente nicht zu installieren, wird die Programmgruppe nicht installiert. Klicken Sie auf den Abwärtspfeil, um eine Liste der für die Anwendung definierten Komponenten anzuzeigen.


Programmgruppe

Der Name, der in der Titelleiste der Programmgruppe bzw. unterhalb des Programmsymbols erscheint, wenn die Programmgruppe im Windows Programm-Manager minimiert wird.


Beschreibung

Der Name, der unterhalb des Programmsymbols erscheint.


Befehlszeile

Die mit dem Programmelement verbundene Befehlszeile; wird zum Starten der Anwendung (und einer bestimmten Datei, falls gewünscht) verwendet.


Programmsymbol

Das Programmsymbol, das in der Programmgruppe erscheint. Wenn Sie kein Symbol auswählen, erscheint das Standardsymbol des Programm-Managers:


Symbol ändern

Klicken Sie auf "Symbol ändern", um ein Symbol für das Programmelement auszuwählen. Daraufhin erscheint das Dialogfeld Symbol ändern.


Programmsymbol entfernen

Wählen Sie ein Programmsymbol aus und klicken Sie dann auf "Programmsymbol entfernen", um dieses aus der Liste zu entfernen.


Symbolindex

Wenn Sie eine Symboldatei mit mehreren Symbolen auswählen, verwenden Sie den Aufwärts- bzw. Abwärtspfeil, um den Index des gewünschten Symbols festzulegen (0 für das erste, 1 für das zweite, usw.).


Konfiguration (Register)
Register Konfiguration
Verwenden von SETUPMGR.EXE

Mit diesem Register können Sie die Änderungen festlegen, die während des Installationsvorgangs an den AUTOEXEC.BAT, CONFIG.SYS und .INI-Dateien des Benutzers vorgenommen werden sollen. Änderungen an .INI-Dateien werden automatisch durchgeführt. Bevor die AUTOEXEC.BAT- und CONFIG.SYS-Datei geändert wird, fordert SETUP.EXE den Benutzer auf, die Änderung zu bestätigen.


Verwenden von SETUPMGR.EXE

.INF-Datei

Register Disketten erstellen

Register Dateien

Register Allgemein

Register EXE starten

Register PM-Symbole


Änderungen an der Konfigurationsdatei

Eine Liste der Änderungen.


Mit Komponente installiert

Der Name der Komponente, mit der eine Änderung verbunden ist. Wenn der Benutzer wählt, die Komponente nicht zu installieren, wird die Änderung nicht vorgenommen. Klicken Sie auf den Abwärtspfeil, um eine Liste der für die Anwendung definierten Komponenten anzuzeigen.


Dateiname ( nur .INI-Dateien)

Der Pfad und Name der .INI-Datei, die geändert werden soll. Sie können im Pfad Verzeichnis-Platzhalter verwenden.


Abschnitt (nur .INI-Dateien)

Der Abschnitt der .INI-Datei, zu dem die neue Zeile hinzugefügt werden soll. Falls der Abschnitt in der .INI-Datei nicht existiert, wird er von SETUP.EXE erstellt.

Im folgenden Beispiel:

[User Information]

Name=Friedrich Knoblauch

ist [User Information] der Abschnittsname.


Eintrag (nur .INI-Dateien)

Das Element, das zur .INI-Datei hinzugefügt werden soll.

Im folgenden Beispiel:

[User Information]

Name=Friedrich Knoblauch

Ist Name der Eintrag.


Wert (nur .INI-Dateien)

Der Wert des Eintrags.

Im folgenden Beispiel:

[User Information]

Name=Friedrich Knoblauch

Ist Friedrich Knoblauch der Wert.


Dateiauswahl-Schaltflächen

Klicken Sie auf die Schaltfläche für die Art der Datei, die geändert werden soll. Die Felder des Dialogfelds ändern sich entsprechend der von Ihnen ausgewählten Schaltfläche.


Zur durch Kommas getrennte Liste hinzufügen

Zum Hinzufügen eines neuen Werts zu einem vorhanden Eintrag in einer .INI-Datei geben Sie die Informationen in die Felder ein und klicken Sie auf dieses Optionsfeld. Wenn der von Ihnen angegebene Eintrag in der .INI-Datei existiert, wird der Wert zu den vorhandenen Werten hinzugefügt. Wenn der Eintrag noch nicht existiert, wird er mit dem von Ihnen angegebenen Wert hinzugefügt.


Änderung an Konfigurationsdatei löschen

Wählen Sie eine Änderung an der Konfigurationsdatei aus und klicken Sie auf "Löschen", um sie aus der Liste zu entfernen.


AUTOEXEC

Geben Sie die Zeile ein, die zur AUTOEXEC.BAT-Datei des Benutzers hinzugefügt werden soll. Sie können in dieser Zeile Verzeichnis-Platzhalter verwenden.


CONFIG

Geben Sie die Zeile ein, die zur CONFIG.SYS-Datei des Benutzers hinzugefügt werden soll. Sie können in dieser Zeile Verzeichnis-Platzhalter verwenden.


EXE starten (Register)
Register EXE starten
Verwenden von SETUPMGR.EXE

Verwenden Sie dieses Register, um Befehle anzugeben, die beim Abschluß des Installationsvorgangs ausgeführt werden sollen. Sie können z.B. eine LESEN.EXE-Datei öffnen. Befehle können mit bestimmten Komponenten verbunden werden, so daß der Befehl nur ausgeführt wird, wenn der Benutzer die entsprechende Komponente zur Installation auswählt.

Sie können beliebig viele Befehle nach der Installation ausführen (bis zu insgesamt 1000 Zeichen in den Befehlszeilen). Der erste Befehl wird ausgeführt, sobald die Installation abgeschlossen ist. Jeder darauffolgende Befehl wird ausgeführt, sobald der Benutzer mit dem vorhergehenden Befehl fertig ist.


Verwenden von SETUPMGR.EXE

.INF-Datei

Register Konfiguration

Register Disketten erstellen

Register Dateien

Register Allgemein

Register PM-Symbole


Befehlszeilen nach der Installation ausführen

Eine Liste der Befehlszeilen, die ausgeführt werden sollen. Befehlszeilen werden in der Reihenfolge ausgeführt, in der sie hier aufgelistet werden. Zum Ändern der Reihenfolge klicken Sie auf eine Befehlzeile und ziehen Sie sie an eine neue Position in der Liste.


Befehl

Geben Sie den Befehl ein, der ausgeführt werden soll. Sie können in der Befehlszeile einen Verzeichnis-Platzhalter verwenden.


Aktion nach der Installation

Klicken Sie auf ein Optionsfeld, damit der Befehl eine ausführbare Datei startet oder ein Meldungsfeld anzeigt.


Befehlszeile löschen

Wählen Sie eine Befehlszeile aus und klicken Sie dann auf "Entfernen", um sie aus der Liste zu entfernen.


Mit Komponente installiert

Gibt an, wann die Befehlszeile für die Aktion ausgeführt werden soll. Wenn Sie "Immer installieren" wählen, wird der Befehl auf jeden Fall ausgeführt, gleichgültig, welche Komponenten der Benutzer zur Installation wählt. Wenn Sie eine bestimmte Komponente auswählen, wird der Befehl nur dann ausgeführt, wenn diese Komponente installiert wurde.


Meldungsfeld-Text

Geben Sie den Text ein, der im Meldungsfeld erscheinen soll. Die Meldung kann bis zu 32 KB von Zeichen enthalten.


Disketten erstellen (Register)
Register Disketten erstellen
Verwenden von SETUPMGR.EXE

Verwenden Sie dieses Register, um die Installationsdateien auf Disketten zu kopieren.

Der ersten komprimierten Installationsdatei wird der Name der .INF-Datei mit der Erweiterung .001 zugewiesen. Falls mehrere .INF-Dateien erstellt werden, werden darauffolgenden Dateien derselbe Name mit der Erweiterung .002, 003 usw. zugewiesen. Wenn die .INF-Datei z.B. den Namen KARTEN.INF hat, erhält die erste, komprimierte Installationsdatei den Namen KARTEN.001, die zweite den Namen KARTEN.002 usw. Diese Namen sind nicht die Namen, die die Anwendungsdateien erhalten, wenn diese dekomprimiert und auf der Festplatte des Benutzers gespeichert werden.


Verwenden von SETUPMGR.EXE

.INF-Datei

Register Konfiguration

Register Dateien

Register Allgemein

Register EXE starten

Register PM-Symbole


Laufwerk und Verzeichnis der Installationsdateien

Gibt den Pfad und Namen des Verzeichnisses an, in dem SETUPMGR.EXE die Installationsdateien speichern soll.


Dateigröße der komprimierten Installationsdatei

Wählen Sie die Größe für die Installationsdateien aus (normalerweise entspricht dies der Größe des Datenträgers, auf dem die Anwendung ausgeliefert wird). Die Voreinstellung ist "Verfügbarer Plattenspeicher"; d.h. daß SETUPMGR.EXE die Diskette vollschreibt und, falls nötig, weitere Disketten anfordert. Wenn Sie eine bestimmte Größe auswählen, schränkt SETUPMGR.EXE alle Dateien auf diese Größe ein.

Wenn Sie Ihre Anwendung auf CD-ROM vertreiben wollen, wählen Sie "Verfügbarer Speicher" und verwenden Sie eine Festplatte (mit genügendem Plattenspeicher frei) als Zieldatenträger. Daraufhin erscheint eine große Datei, die Sie dann zum Herstellen der CD-ROMs verwenden können.


Komprimierte Installationsdatei erstellen

Klicken Sie auf die se Schaltfläche, um die Installationsdateien zu erstellen. SETUPMGR.EXE komprimiert die Installationskomponenten und schreibt sie in das von Ihnen angegebene Ziellaufwerk.


Komprimierte Installationsdateien auf Disketten kopieren

Klicken Sie auf diese Schaltfläche, um eine Kopie der Installationsdateien (einschließlich SETUP.EXE, der.INF-Datei und der Installations-Bitmaps) auf Disketten zu kopieren. Das System fordert Sie nach Bedarf zum Einlegen neuer Disketten auf.


Laufwerk und Verzeichnis auswählen (Schaltfläche)
Schaltfläche "Laufwerk und Verzeichnis auswählen"

Klicken Sie auf "Laufwerk und Verzeichnis auswählen", um ein Dialogfeld zu öffnen, in dem Sie ein Laufwerk und Verzeichnis für die Installationsdateien auswählen können.


Komponente

Ein Teil der Anwendung, den der Benutzer wahlweise installieren oder nicht installieren kann. Wenn der Benutzer wählt, eine Komponente nicht zu installieren, müssen Sie sicherstellen, daß die Anwendung auch ohne die ausgelassene Komponente richtig funktioniert.


Tips zum Vertreiben von Runtime ToolBook mit Ihren Anwendungen
Einführung in das Asymetrix-Installationswerkzeug

Befolgen Sie die nachfolgenden Richtlinien, um die besten Ergebnisse beim Vertrieb von Runtime ToolBook mit Ihren Anwendungen zu erzielen:

Verwenden Sie die Runtime ToolBook-Standardkomponente in einem gemeinsamen (allgemeinen) Verzeichnis, um zu gewährleisten, daß Ihre ToolBook-Anwendung mit anderen Runtime ToolBook-Anwendungen funktioniert, die evtl. auf dem System des Endbenutzers bereits installiert sind. Dadurch wird auch die Installation von Duplikaten der Runtime ToolBook-Dateien verhindert, was Plattenspeicher auf dem System der Endbenutzer spart.

Bei Verwendung der Standardkomponente für Runtime ToolBook verwenden Sie all die vorprogrammierten Änderungen der Standard-.INI-Datei. Dadurch wird gewährleistet, daß Ihre ToolBook-Anwendung mit anderen, bereits installierten ToolBook-Anwendung richtig funktioniert.

Ändern Sie den Wert von startupSysBooks in der TOOLBOOK.INI-Datei nicht, da Sie dadurch die Ausführung anderer ToolBook-basierten Anwendungen beeinträchtigen können. Wenn Ihre Anwendung bestimmte Systembücher benötigt, fügen Sie sie in einer enterApplication-Behandlungsroutine mit dem push-Befehl zur sysBooks-Eigenschaft hinzu.


Verwenden von SETUPMGR.EXE

Hinzufügen der Runtime ToolBook-Komponente

Installieren von Runtime ToolBook (allgemein)