Wrapperバージョン3.3.7のリリースで、 Wrapperは、リソースのいくつかを変更したり、 Windows上で外観をカスタマイズしたり、などの機能提供を開始しました。
Wrapperバイナリ「wrapper.exe」、 コンソールレス版「wrapperW.exe」 をカスタマイズするとき、「--customize」コマンドで指定された新しいリソースで新しいバージョンのバイナリが作成されます。 その結果となるバイナリはロックされ、もはやカスタマイズはできなくなります。
新しいカスタマー・バイナリ(例:MyApp.exe)を作成するとき、次の引数を結合できます。 引数 「--target {target.exe}」は、常に必要です。
全てのファイル名のパスが、呼び出し元への相対的な配置場所である必要はなく、 Wrapperバイナリの配置場所への相対であることに注意してください。 例えば、次のコマンドでは、「wrapperW.exe」 バイナリが配置してある同じディレクトリーにターゲット・ファイルを作成し、同様に、そのディレクトリーに新しいアイコンや スプラッシュ・スクリーンを探すことになります:
bin\wrapperw.exe --customize --target myapp.exe --icon myicon.ico --splash mysplash.bmp
Wrapperバージョン3.5.7から、弊社タヌキソフトウェアからの純正なバイナリであることを認証するために、Windowsバイナリ版が協調設計されました。 しかしながら、バイナリをカスタマイズすると、そのバイナリから証明書が削除されることになります。
Wrapperバイナリがカスタマイズされるとき、 常に、カスタマイズ・バージョン用に、新しい ファイル名を指定する必要があります。 既に同じファイル名が存在する場合には、Wrapperは常にそのファイルを上書きします。
wrapperw.exe --target myapp.exe
全てまとめてパラメータを置くと、このような コマンドラインとなります:
bin\wrapperw.exe --customize --icon MyIcon.ico --splash MySplash.bmp --target MyApp.exe
このコマンドは、「wrapperW.exe」 バイナリが配置してある同じディレクトリーに、カスタマイズされたアイコンや スプラッシュ・スクリーンと共に、 新しい実行ファイル「MyApp.exe」を作成します。
この機能を利用するためには、 Java Service Wrapperのスタンダード版あるいはプロフェッショナル版をご利用ください。
Wrapperは、デフォルト・アイコンを同梱して配布されていますが、 しかしながら、Wrapperを同梱している商品のアイコンで置き換えたいというディベロッパー(開発者)の希望のために、 Wrapperは、「素晴らしいアプリケーション・ランチャーでもある」という役目も提供しています。
アイコン・ファイルは、標準のマルチ・レイヤー・アイコン・ファイルであり、 サポートされる必要がある全ての解像度やアイコン・サイズを含んでいます。
wrapperw.exe --target myapp.exe --icon myicon.ico
次のは、複製で名前変更された3つの Java Service Wrapper 版 と、そのデフォルト・アイコンを持つ、 カスタマイズされた「MyApp.exe」を含んでいるディレクトリーのスクリーンショットです。
Wrapperバイナリのコンソールレス版「wrapperW.exe」 は、デフォルトで、スタート時にスプラッシュ・スクリーンを表示します。 このスプラッシュ・スクリーンは、Wrapperを同梱している商品に合わせたイメージ画像で置き換えることでカスタマイズすることができます。
Wrapperバイナリ「wrapper.exe」では、 スプラッシュ・スクリーンを表示しないため、このスクリーンのカスタマイズは無効です。
Java内部からではなく、Wrapperにスプラッシュ・スクリーンを表示させる設定は、 アプリケーション・スタートアップ時に瞬時に画面が反応するので利点があります。 つまり、スプラッシュ・スクリーンはJVM起動前に表示され、 Javaアプリケーションのクラスがロード(読み込み)されて初期化されるまで、視覚的なスクリーン状態を維持します。
[wrapper.splashscreen.mode] プロパティを使って、スプラッシュ・スクリーンの動作についてコントロールすることができます。
wrapperw.exe --target myapp.exe --splash mysplash.bmp
現在のところ、唯一、ビットマップ (*.bmp) ファイルをサポートしています。 画像サイズやビット深さの制限はありません。
Java Service Wrapper プロフェッショナル版のデフォルト・スプラッシュ・スクリーン:
Java Service Wrapper スタンダード版のデフォルト・スプラッシュ・スクリーン:
カスタム・スプラッシュ・スクリーンの例:
もしコンフィギュレーション・ファイルを指定せずにWrapperバイナリが呼び出されたとき、 Wrapperは、デフォルトで、実行ファイルが配置されているのと同じディレクトリーにある デフォルトのコンフィギュレーション・ファイルを利用するものとします。 実行ファイル名をベースにした名前「{MyApp}」から、 そのコンフィギュレーション・ファイル名は「{MyApp}.conf」です。 例えば: もし実行ファイル名が「test.exe」であるなら、 Wrapperは「test.conf」を開こうとします。
wrapperw.exe --target myapp.exe --conf ../conf/myconf.conf
このオプションは、後述の「--passthrough」オプションで使われるとき、特に重宝します。
相対パスは、Wrapper実行ファイルの配置場所に対して相対でなければなりません。
このオプションは、Wrapperバージョン3.5.5で追加されました。
デフォルトで、Wrapperはパラメータを解釈します。 JVMアプリケーションへ引き渡されるはずのパラメータは [wrapper.app.parameter.<n>]プロパティで 定義されていなければなりません。 Wrapperバージョン3.5.2で、 JVMアプリケーションへ簡単に引き渡しできるように「--」コマンドが追加されましたが、 この新しいオプションでアプリケーションをカスタマイズするには、 実際にWrapperをバックグランドに置き、実行ファイルを — かなりネイティブWindowsアプリケーションのように— 主権を有するWindowsアプリケーションのように見せかけます
この機能性を有効にするには、Wrapper実行ファイルをカスタマイズするコマンドに 「--passthrough」パラメータを追加すればよく、 その新しい実行ファイルは簡単にこれ一つでJavaアプリケーションを開始します。
Wrapperは全てのパラメータをJVMへ引き渡すため、コマンドラインを通して コンフィギュレーション・ファイルを指定することはできません。 新しい実行ファイルは、むしろデフォルトのコンフィギュレーション・ファイルの利用を試みます。 デフォルトのコンフィギュレーション・ファイルを変更するためには、 前述の「--conf」オプションの利用を検討してください。
wrapperw.exe --target myapp.exe --passthrough
コマンドラインからの入力をWrapperに無視させ、全体のコマンドラインがJVMへ引き渡されます。 これは、また、 Windowsサービスとしてアプリケーションをインストールするために、 カスタマイズされた実行ファイルを利用する機能も引き継ぎます。
Wrapperバイナリでは、バージョン情報リソースを定義させ、 バージョン番号、著作権情報、ファイル説明、製造業者などの基本ファイル情報を設定します。 製造メーカーのアプリケーションにWrapperを同梱して配布する際に、 Wrapperバイナリで表示される製造会社情報として、 弊社「タヌキ ソフトウェア(株)」の代わりに、各製造会社の情報を表示したいと希望されることも多いでしょう。 下記のように、製造業者をカスタマイズすることができます。
wrapperw.exe --target myapp.exe --manufacturer "My Example Company"
このオプションは、Wrapperバージョン3.5.10で追加されました。