注意: このツールの名前はjavapackager
に変更されています。javafxpackager.exe
ファイルは、将来のリリースで削除される可能性があります。javapackager
を使用するように、スクリプトを更新してください。
JavaおよびJavaFXアプリケーションのパッケージ化と署名に関連するタスクを実行します。
次のいずれかのコマンドを指定できます。コマンドの後にオプションを指定します。
CSSファイルをバイナリ形式に変換します。
他のパラメータに従ってJARアーカイブを生成します。
再配布用のアプリケーション・パッケージを構築します。デプロイ・タスクでは、デフォルトでベース・アプリケーション・パッケージが生成されますが、指定すれば自己完結型アプリケーション・パッケージも生成できます。
1つの呼出しで、ほとんどの引数が事前定義されたコンパイル、createjar
およびdeploy
ステップを実行し、すべての該当する自己完結型アプリケーション・パッケージの生成を試行します。ソース・ファイルはsrc
というフォルダに配置する必要があり、生成されるファイル(JAR、JNLP、HTMLおよび自己完結型アプリケーション・パッケージ)はdist
というフォルダに出力されます。このコマンドは、最小限の構成のみが可能で、可能なかぎり自動化されます。
指定された証明書でJARファイルを署名します。
生成された出力ファイルを受け取るディレクトリの名前。
パッケージ化するファイルのベース・ディレクトリ。
-srcdir
オプションで指定されたディレクトリに含まれるファイルのリスト。省略すると、(その場合は必須の引数となる)ディレクトリ内のすべてのファイルが使用されます。リスト内のファイルは、空白で区切る必要があります。
実行するアプリケーション・クラスの修飾名。
JNLPファイルに<fx:argument>
要素として挿入する名前なし引数。
依存するJARファイルの名前のリスト。
追加のマニフェスト属性の名前と値のリスト。構文:
"name1=value1,name2=value2,name3=value3"
パッケージャは、CSSファイルをバイナリ形式に変換せずにJARにコピーします。
生成された出力ファイルを受け取るディレクトリの名前。
生成されるファイルの(拡張子なしの)名前。
デフォルトの名前付きアプリケーション・パラメータが含まれるプロパティ・ファイル。
実行するJavaFXプリローダー・クラスの修飾名。このオプションは、JavaFXアプリケーションにのみ使用します。ヘッドレス・アプリケーションを含むJavaアプリケーションには使用しないでください。
パッケージ化するファイルのベース・ディレクトリ。
-srcdir
オプションで指定されたディレクトリに含まれるファイルのリスト。省略すると、(その場合は必須の引数となる)ディレクトリ内のすべてのファイルが使用されます。リスト内のファイルは、空白で区切る必要があります。
指定した場合、アプリケーションはJNLPファイル内のすべてのセキュリティ権限を必要とするようになります。
実行するアプリケーション・クラスの修飾名。
JNLPファイル内の<fx:argument>
要素に挿入する名前なし引数。
自己完結型アプリケーションのパッケージ化に使用するバンドラへの情報を指定します。各バンドラの引数については、「自己完結型アプリケーション・バンドラの引数」を参照してください。
生成後のHTMLでのユーザー・コールバック方式を指定します。形式は次のとおりです。
"name1:value1,name2:value2,..."
アプリケーションの説明。
指定した場合、JNLPファイルに証明書が埋め込まれます。
指定した場合、HTMLドキュメントにJNLPファイルが埋め込まれます。
アプリケーションの高さ。
生成されるアプリケーションをブラウザ内で実行するときのパラメータが含まれるプロパティ・ファイル。
指定した場合、srcfiles
は拡張ファイルとして処理されます。
アプリケーションの名前。
自己完結型アプリケーション・バンドルを生成します(可能な場合)。-B
オプションを使用して、使用されているバンドラへの引数を指定します。typeを指定した場合、このタイプのバンドルのみが作成されます。タイプを指定しない場合、all
が使用されます。
typeには、次の値が有効です。
all
: 実行されているプラットフォームのインストーラをすべて実行し、そのアプリケーションのディスク・イメージを作成します。typeが指定されていない場合、この値が使用されます。
installer
: 実行されているプラットフォームのインストーラをすべて実行します。
image
: アプリケーションのディスク・イメージを作成します。Windowsでは、イメージはインストールされるディレクトリです。
exe
: Windows .exe
パッケージを生成します。
msi
: Windowsインストーラ・パッケージを生成します。
生成された出力ファイルを受け取るディレクトリの名前。
生成されるファイルの(拡張子なしの)名前。
デフォルトの名前付きアプリケーション・パラメータが含まれるプロパティ・ファイル。
実行するJavaFXプリローダー・クラスの修飾名。このオプションは、JavaFXアプリケーションにのみ使用します。ヘッドレス・アプリケーションを含むJavaアプリケーションには使用しないでください。
パッケージ化するファイルのベース・ディレクトリ。
-srcdir
オプションで指定されたディレクトリに含まれるファイルのリスト。省略すると、(その場合は必須の引数となる)ディレクトリ内のすべてのファイルが使用されます。リスト内のファイルは、空白で区切る必要があります。
テンプレート処理を行うアプリケーションのアプリケーションID。
HTMLテンプレート・ファイルの名前。プレースホルダの形式は次のとおりです。
#XXXX.YYYY(APPID)#
ここで、APPIDはアプリケーションの識別子、XXXは次のいずれかです。
DT.SCRIPT.URL
配備ツールキット内のdtjava.jsの場所。デフォルトの場所は次のとおりです
http://java.com/js/dtjava.js
DT.SCRIPT.CODE
配備ツールキットのdtjava.jsを組み込むスクリプト要素。
DT.EMBED.CODE.DYNAMIC
アプリケーションを特定のプレースホルダに埋め込むコード。コードをfunction()
メソッド内にラップすることが期待されます。
DT.EMBED.CODE.ONLOAD
onload
フックを使用してアプリケーションをWebページに埋め込むために必要なすべてのコード(dtjava.jsの組込みを除く)。
DT.LAUNCH.CODE
アプリケーションを起動するために必要なコード。コードをfunction()
メソッド内にラップすることが期待されます。
テンプレートから生成されるHTMLファイルの名前。
アプリケーションのタイトル。
アプリケーションのベンダー。
アプリケーションの幅。
JNLPファイルの更新モードを設定します。
実行するアプリケーション・クラスの修飾名。
依存するJARファイルの名前のリスト。
アプリケーションの高さ。
アプリケーションの名前。
実行するJavaFXプリローダー・クラスの修飾名。このオプションは、JavaFXアプリケーションにのみ使用します。ヘッドレス・アプリケーションを含むJavaアプリケーションには使用しないでください。
アプリケーションの幅。
キーの別名。
キーを復元するためのパスワード。
キーストア・ファイルの名前。
生成された出力ファイルを受け取るディレクトリの名前。
署名されるファイルのベース・ディレクトリ。
-srcdir
オプションで指定されたディレクトリに含まれるファイルのリスト。省略すると、(その場合は必須の引数となる)ディレクトリ内のすべてのファイルが使用されます。リスト内のファイルは、空白で区切る必要があります。
キーストアの整合性を確認したり、ロックを解除したりするためのパスワード
キーストアのタイプ。デフォルト値は"jks"です。
自己完結型アプリケーションの作成に使用されるバンドラの引数を指定するには、-deploy
コマンドの-B
オプションを使用します。各バンドラ・タイプに、独自の引数セットがあります。
アプリケーション・パッケージのバージョン。一部のバンドラでは、バージョン文字列の形式が制限されます。
アセンブルされたアプリケーション・ディレクトリへの相対的なクラス・パス。一般的に、パスはJARファイル・マニフェストから抽出され、他のjavapackager
コマンドを使用している場合は設定する必要はありません。
起動ツールおよびその他の支援ツールに使用されるデフォルト・アイコンの場所。Windowsの場合、形式は.ico
である必要があります。
mac.CFBundleIdentifier
など、他のプラットフォーム固有の値に使用されるデフォルト値。DNS順序の反転をお薦めします(例: com.example.application.my-application
)。
アプリケーションの実行時にJVMに渡されるオプション。java
コマンドに有効なオプションを使用できます。複数のオプションを渡すには、次の例に示すように-B
オプションの複数インスタンスを使用します。
-BjvmOptions=-Xmx128m -BjvmOptions=-Xms128m
アプリケーションの実行時にVMに渡されるJavaシステム・プロパティ。java
コマンドの-D
オプションに有効なプロパティを使用できます。プロパティ名とそのプロパティの値の両方を指定します。複数のプロパティを渡すには、次の例に示すように-B
オプションの複数インスタンスを使用します。
-BjvmProperties=apiUserName=example -BjvmProperties=apiKey=abcdef1234567890
アプリケーションのメイン・クラスを含むJARファイルの名前。一般的に、ファイル名はJARファイル・マニフェストから抽出され、他のjavapackager
コマンドを使用している場合は設定する必要はありません。
ユーザーがオーバーライドできるJVMオプションを確認するために調べるプリファレンス・ノード。指定したノードは、オプション-Dapp.preferences.id
として実行時にアプリケーションに渡されます。この引数は、userJVMOptions
引数とともに使用されます。
パッケージ・バンドルに含めるJREまたはJDKの場所。JDKまたはJREのルート・フォルダへのファイル・パスを指定します。システム・デフォルトJREを使用するには、次の例に示すようにパスを指定しないでください。
-Bruntime=
ユーザーがオーバーライドできるJVMオプション。java
コマンドに有効なオプションを使用できます。オプション名とそのオプションの値の両方を指定します。複数のオプションを渡すには、次の例に示すように-B
オプションの複数インスタンスを使用します。
-BuserJvmOptions=-Xmx=128m -BuserJvmOptions=-Xms=128m
アプリケーションのコピーライト文字列。文字列は、100文字未満の単一行である必要があります。この引数は、様々な実行ファイルおよびレジストリ・メタデータで使用されます。
バンドラによって表示または記録される使用許諾契約(EULA)の場所。パスは、パッケージ・アプリケーション・リソースに相対的です(例: -BlicenseFile=COPYING
)。
ショートカットがスタート・メニューまたはスタート画面にインストールされているかどうかを示すフラグ。ショートカットをインストールするには、true
に設定します。デフォルトはtrue
です。
ショートカットがデスクトップに配置されているかどうかを示すフラグ。ショートカットをデスクトップに追加するには、true
に設定します。デフォルトはfalse
です。
アプリケーションがプログラム・ファイルまたはユーザーのホーム・ディレクトリ内の標準の場所にインストールされているかどうかを示すフラグ。アプリケーションをプログラム・ファイルにインストールするには、true
に設定します。アプリケーションをユーザーのホーム・ディレクトリにインストールするには、false
に設定します。デフォルトはfalse
です。
menuHint
がtrue
の場合に、アプリケーションをインストールするメニュー・グループ。menuHint
がfalse
の場合に、この引数は無視されます。
アプリケーションを提供する会社、組織または個人。この引数は、様々な実行ファイルおよびレジストリ・メタデータで使用されます。
ショートカットがスタート・メニューまたはスタート画面にインストールされているかどうかを示すフラグ。ショートカットをインストールするには、true
に設定します。デフォルトはtrue
です。
ショートカットがデスクトップに配置されているかどうかを示すフラグ。ショートカットをデスクトップに追加するには、true
に設定します。デフォルトはfalse
です。
アプリケーションがプログラム・ファイルまたはユーザーのホーム・ディレクトリ内の標準の場所にインストールされているかどうかを示すフラグ。アプリケーションをプログラム・ファイルにインストールするには、true
に設定します。アプリケーションをユーザーのホーム・ディレクトリにインストールするには、false
に設定します。デフォルトはtrue
です。
menuHint
がtrue
の場合に、アプリケーションをインストールするメニュー・グループ。menuHint
がfalse
の場合に、この引数は無視されます。
アプリケーションを提供する会社、組織または個人。この引数は、様々な実行ファイルおよびレジストリ・メタデータで使用されます。
次のオプションは、パッケージ化ツールで使用されておらず、存在していても無視されます。
JavaFXランタイムの必須バージョン。非推奨。
指定した場合、パッケージャはJavaFX起動クラスをJARファイルに追加しません。非推奨。
-v
オプションは、任意のタスク・コマンドで詳細出力を有効にするために使用できます。
コマンドに-srcdir
オプションを指定できる場合は、このオプションを複数回使用できます。-srcfiles
オプションを指定した場合は、その引数に指定したファイルが、先行するsrcdir
オプションに指定した場所で検索されます。-srcdir
が-srcfiles
の前に指定されていない場合は、javapackager
コマンドが実行されるディレクトリが使用されます。
javapackager -createjar -appclass package.ClassName -srcdir classes -outdir out -outfile outjar -v
classes
ディレクトリの内容をoutjar.jar
にパッケージ化し、アプリケーション・クラスをpackage.ClassName
に設定します。
javapackager -deploy -outdir outdir -outfile outfile -width 34 -height 43 -name AppName -appclass package.ClassName -v -srcdir compiled
package.ClassName
によって起動され、34 x 43ピクセルの寸法を持つアプリケーションAppName
のために、outfile.jnlp
ファイルおよび対応するoutfile.html
ファイルをoutdir
に生成します。
javapackager -makeall -appclass brickbreaker.Main -name BrickBreaker -width 600 -height 600
コンパイル、createjar
およびdeploy
を含むすべてのパッケージ化作業を実行します。
javapackager -signJar --outdir dist -keyStore sampleKeystore.jks -storePass **** -alias duke -keypass **** -srcdir dist
dist
ディレクトリ内のすべてのJARファイルに署名し、指定された別名、keyStore
およびstorePass
を使って証明書を添付し、署名されたJARファイルをdist
ディレクトリに再び配置します。
javapackager -deploy -native exe -BsystemWide=true -BjvmOptions=-Xmx128m -BjvmOptions=-Xms128m -outdir packages -outfile BrickBreaker -srcdir dist -srcfiles BrickBreaker.jar -appclass brickbreaker.Main -name BrickBreaker -title "BrickBreaker demo"
自己完結型アプリケーションとしてBrickBreakerアプリケーションを実行するためのネイティブWindows EXEパッケージを生成します。