Kompatibel :	3.3.7
Editionen :
Betriebssysteme :

Mit dem Release der Wrapper Version 3.3.7, bietet der Wrapper die Fähigkeit an, einige seiner Ressourcen und seine Erscheinung unter Windows zu ändern.

Mit dem Anpassen der konsolenfreien Version der Wrapper-Programmdatei "wrapper.exe" wird eine neue Version der Programmdatei (Beispiel: MyApp.exe) mit den angegebenen Ressourcen via des "--customize" Befehls spezifiziert. Die resultierende Programmdatei wird gesperrt, das bedeutet, es ist nicht länger möglich, diese anzupassen.

Wenn Sie eine neue Kunden-Programmdatei erstellen, kann jede der folgenden Argumente miteinander kombiniert werden. Das "--target {target.exe}" Argument ist immer vonnöten.

Bitte beachten Sie, dass die Pfadangaben aller Dateinamen relativ zum Speicherort der Wrapper-Programmdatei sind, nicht notwendigerweise zum Pfad, von wo aus die Programmdatei aufgerufen wird. Zum Beispiel wird der folgende Befehl die Zieldatei in demselben Verzeichnis wie die "wrapperW.exe" Programmdatei erstellen und erwartet das neue Icon und den Startbildschirm im gleichen Verzeichnis:

bin\wrapperw.exe --customize --target myapp.exe --icon myicon.ico --splash mysplash.bmp

Wenn die Wrapper-Programmdatei angepasst wird, ist es stets notwendig eine neuen Dateinamen für die angepasste Version anzugeben. Der Wrapper wird stets die Datei überschreiben, wenn sie bereits existieren würde.

wrapperw.exe --customize --target myapp.exe

Die Kombination aller Parameter kombinieren würde folgende Befehlszeile als Ergebnis haben:

bin\wrapperw.exe --customize --icon MyIcon.ico --splash MySplash.bmp --target MyApp.exe

Dieser Befehl erstellt eine neue MyApp.exe Programmdatei in demselben Verzeichnis, in dem sich die "wrapperW.exe" befindet, mit einem angepassten Icon und Startbildschirm.

Beim Anpassen von wrapperw.exe, erscheint ein Dialogsfeld, welches die Logausgabe anzeigt. Dies ist nützlich, um zu bestätigen, ob die Anpassung erfolgreich oder mit ein paar Fehlern abgeschlossen wurde. Jedoch, in manchen Fällen, z.B. das Starten der Anpassung von einem Skript, kann die Anzeige eines Dialogsfelds den Vorgang blockieren, da es eine menschliche Interaktion erfordert, um das Fenster zu schliessen. Aus diesem Grund wurde ein '--silent' Parameter der Wrapper-Version 3.5.34 hinzugefügt, damit der Logdialog niemals beim Anpassen der wrapperw.exe angezeigt wird. Bitte beachten Sie, dass die Eigenschaft wrapper.logdialog.enable, welche steuert, ob der Logdialog beim Beenden, wenn der Wrapper normal ausgeführt wird, angezeigt werden soll, nicht beim Anpassen der Binärdateien genutzt werden kann, weil die Konfigurationsdatei nicht während des Anpassungsprozess geladen wird.

wrapperw.exe --customize --silent --target myapp.exe

Die Icon-Datei ist eine Standard-Multilayer-Icondatei, die alle Auflösungs- und Icongrößen enthält, die unterstützt werden.

wrapperw.exe --customize --target myapp.exe --icon myicon.ico

Im folgenden sehen Sie den Screenshot eines Verzeichnisses, der die angepasste MyApp.exe Datei zusammen mit den umbenannten Kopien der drei Java Service Wrapper Editionen und ihrer Standard-Icons enthält.

Die konsolenfreie Version der Wrapper Programmdatei, "wrapperW.exe", wird standardmäßig einen Startbildschirm beim Starten anzeigen. Dieser Startbildschirm kann mit einem Bild angepasst werden, welches das Produkt darstellt, mit welchem der Wrapper benutzt wird.

Die Wrapper-Programmdatei wrapper.exe zeigt keinen Startbildschirm an; deshalb wird das Argument für die Anpassung des Startbildschirms nicht benötigt.

Den Wrapper einen Startbildschirm anzeigen zu lassen statt dies innerhalb Javas zu tun, hat den Vorteil, den Startvorgang der Anwendung aktiv erscheinen zu lassen. Dies ist aus dem Grunde, weil der Startbildschirm bereits angezeigt wird, bevor die JVM gestartet wird und kann sichtbar bleiben, wenn die Klassen der Java-Anwendung geladen und initialisiert werden.

Die Art und Weise, wie sich der Startbildschirm darstellt, kann via der wrapper.splashscreen.mode-Eigenschaft kontrolliert werden.

wrapperw.exe --customize --target myapp.exe --splash mysplash.bmp

Aktuell werden nur Bitmap-Dateien (*.bmp) unterstützt. Es gibt keine gesetzten Größen- oder Farbtiefen-Beschränkungen.

Der standardmäßige Java Service Wrapper Professional Edition Startbildschirm:

Der standardmäßige Java Service Wrapper Standard Edition Startbildschirm:

Beispiel angepasster Startbildschirm

Standardmäßig, wenn die Wrapper-Programmdatei aufgerufen wird, ohne dass irgendeine Konfigurationsdatei angegeben wurde, wird der Wrapper die Standard-Konfigurationsdatei im gleichen Verzeichnis, in dem sich die Programmdatei befindet, benutzen. Es gibt eine Datei mit Namen {MyApp}.conf, wobei der Name {MyApp} auf den Dateinamen der ausführbaren Datei basiert. Zum Beispiel: Wenn die ausführbare Datei "test.exe" bezeichnet wird, wird der Wrapper versuchen, "test.conf" zu öffnen.

wrapperw.exe --customize --target myapp.exe --conf ../conf/myconf.conf

Diese Option ist insbesondere bei Nutzung der unten beschriebenen der "--passthrough"-Option praktisch.

Standardmäßig interpretiert der Wrapper Parameter selbst. Jedwede Parameter, die der JVM-Anwendung übergeben werden, müssen via die wrapper.app.parameter.<n> Eigenschaft definiert werden. In der Wrapper Version 3.5.2, wurde "--" hinzugefügt, um die Übergabe an einer JVM-Anwendung zu vereinfachen. Jedoch wird die Anpassung Ihrer Anwendung mit dieser neuen Option dazu führen, dass der Wrapper nicht mehr angezeigt wird und Ihre Anwendung wie eine native Windows-Anwendung erscheint.

Um diese Funktion zu aktivieren, ist es nur notwendig, den "--passthrough" Parameter im Befehl zur Anpassung Ihrer Wrapper-Programmdatei hinzufügen. Die neue Programmdatei wird Ihre Java-Anwendung direkt starten.

Da der Wrapper alle Parameter an die JVM übergibt, ist es dann nicht mehr möglich, die Konfigurationsdatei durch die Befehlszeile zu unterbrechen. Die neue Programmdatei wird stattdessen versuchen, die Standard-Konfigurationsdatei zu nutzen. Um die Standard-Konfigurationsdatei zu ändern, achten Sie bitte darauf die "--conf" Option, so wie oben beschrieben, zu nutzen.

wrapperw.exe --customize --target myapp.exe --passthrough

Die Wrapper-Programmdatei hat eine Versionsinfo-Ressource definiert, die grundlegende Dateiinformationen wie Versionsnummer, Copyright, Dateibeschreibung, Hersteller etc. festlegt. Distributoren, die ihre Anwendung mit dem Wrapper bündeln und möchten, dass ihre eigene Firmeninformation vor der eigentlichen Programmdatei erscheint, möchten ggf. den Herstellernamen der Programmdatei von "Tanuki Software, Ltd." durch Ihren eigenen Firmennamen ersetzen.

wrapperw.exe --customize --target myapp.exe --manufacturer "Ihr Firmenname"