Java Platform, Standard Editionツール・リファレンス
目次前次

javafxpackager

注意: このツールの名前はjavapackagerに変更されています。javafxpackager.exeファイルは、将来のリリースで削除される可能性があります。javapackagerを使用するように、スクリプトを更新してください。

JavaおよびJavaFXアプリケーションのパッケージ化と署名に関連するタスクを実行します。

形式

javapackager command [options]

command: 実行するタスク。
options: 空白で区切られた1つ以上のコマンド・オプション。

コマンド

次のいずれかのコマンドを指定できます。コマンドの後にオプションを指定します。

-createbss: CSSファイルをバイナリ形式に変換します。
-createjar: 他のパラメータに従ってJARアーカイブを生成します。
-deploy: 再配布用のアプリケーション・パッケージを構築します。デプロイ・タスクでは、デフォルトでベース・アプリケーション・パッケージが生成されますが、指定すれば自己完結型アプリケーション・パッケージも生成できます。
-makeall: 1つの呼出しで、ほとんどの引数が事前定義されたコンパイル、createjarおよびdeployステップを実行し、すべての該当する自己完結型アプリケーション・パッケージの生成を試行します。ソース・ファイルはsrcというフォルダに配置する必要があり、生成されるファイル(JAR、JNLP、HTMLおよび自己完結型アプリケーション・パッケージ)はdistというフォルダに出力されます。このコマンドは、最小限の構成のみが可能で、可能なかぎり自動化されます。
-signjar: 指定された証明書でJARファイルを署名します。

createbssコマンドのオプション

-outdir dir: 生成された出力ファイルを受け取るディレクトリの名前。
-srcdir dir: パッケージ化するファイルのベース・ディレクトリ。
-srcfiles files: -srcdirオプションで指定されたディレクトリに含まれるファイルのリスト。省略すると、(その場合は必須の引数となる)ディレクトリ内のすべてのファイルが使用されます。リスト内のファイルは、空白で区切る必要があります。

createjarコマンドのオプション

-appclass app-class

実行するアプリケーション・クラスの修飾名。

-argument arg

JNLPファイルに<fx:argument>要素として挿入する名前なし引数。

-classpath files

依存するJARファイルの名前のリスト。

-manifestAttrs manifest-attributes

追加のマニフェスト属性の名前と値のリスト。構文:

"name1=value1,name2=value2,name3=value3"

-nocss2bin

パッケージャは、CSSファイルをバイナリ形式に変換せずにJARにコピーします。

-outdir dir

生成された出力ファイルを受け取るディレクトリの名前。

-outfile filename

生成されるファイルの(拡張子なしの)名前。

-paramfile file

デフォルトの名前付きアプリケーション・パラメータが含まれるプロパティ・ファイル。

-preloader preloader-class

実行するJavaFXプリローダー・クラスの修飾名。このオプションは、JavaFXアプリケーションにのみ使用します。ヘッドレス・アプリケーションを含むJavaアプリケーションには使用しないでください。

-srcdir dir

パッケージ化するファイルのベース・ディレクトリ。

-srcfiles files

-srcdirオプションで指定されたディレクトリに含まれるファイルのリスト。省略すると、(その場合は必須の引数となる)ディレクトリ内のすべてのファイルが使用されます。リスト内のファイルは、空白で区切る必要があります。

deployコマンドのオプション

-allpermissions: 指定した場合、アプリケーションはJNLPファイル内のすべてのセキュリティ権限を必要とするようになります。
-appclass app-class: 実行するアプリケーション・クラスの修飾名。
-argument arg: JNLPファイル内の<fx:argument>要素に挿入する名前なし引数。
-Bbundler-argument=value

makeallコマンドのオプション

-appclass app-class: 実行するアプリケーション・クラスの修飾名。
-classpath files: 依存するJARファイルの名前のリスト。
-height height: アプリケーションの高さ。
-name name: アプリケーションの名前。
-preloader preloader-class: 実行するJavaFXプリローダー・クラスの修飾名。このオプションは、JavaFXアプリケーションにのみ使用します。ヘッドレス・アプリケーションを含むJavaアプリケーションには使用しないでください。
-width width: アプリケーションの幅。

signjarコマンドのオプション

-alias: キーの別名。
-keyPass: キーを復元するためのパスワード。
-keyStore file: キーストア・ファイルの名前。
-outdir dir: 生成された出力ファイルを受け取るディレクトリの名前。
-srcdir dir: 署名されるファイルのベース・ディレクトリ。
-srcfiles files: -srcdirオプションで指定されたディレクトリに含まれるファイルのリスト。省略すると、(その場合は必須の引数となる)ディレクトリ内のすべてのファイルが使用されます。リスト内のファイルは、空白で区切る必要があります。
-storePass: キーストアの整合性を確認したり、ロックを解除したりするためのパスワード
-storeType: キーストアのタイプ。デフォルト値は"jks"です。

自己完結型アプリケーション・バンドラの引数

自己完結型アプリケーションの作成に使用されるバンドラの引数を指定するには、-deployコマンドの-Bオプションを使用します。各バンドラ・タイプに、独自の引数セットがあります。

一般的なバンドラ引数

appVersion=version

アプリケーション・パッケージのバージョン。一部のバンドラでは、バージョン文字列の形式が制限されます。

classPath=path

アセンブルされたアプリケーション・ディレクトリへの相対的なクラス・パス。一般的に、パスはJARファイル・マニフェストから抽出され、他のjavapackagerコマンドを使用している場合は設定する必要はありません。

icon=path

起動ツールおよびその他の支援ツールに使用されるデフォルト・アイコンの場所。OS Xの場合、形式は.icnsである必要があります。Linuxの場合、形式は.pngである必要があります。

identifier=value

mac.CFBundleIdentifierなど、他のプラットフォーム固有の値に使用されるデフォルト値。DNS順序の反転をお薦めします(例: com.example.application.my-application)。

jvmOptions=option

アプリケーションの実行時にJVMに渡されるオプション。javaコマンドに有効なオプションを使用できます。複数のオプションを渡すには、次の例に示すように-Bオプションの複数インスタンスを使用します。

-BjvmOptions=-Xmx128m -BjvmOptions=-Xms128m

jvmProperties=property=value

アプリケーションの実行時にVMに渡されるJavaシステム・プロパティ。javaコマンドの-Dオプションに有効なプロパティを使用できます。プロパティ名とそのプロパティの値の両方を指定します。複数のプロパティを渡すには、次の例に示すように-Bオプションの複数インスタンスを使用します。

-BjvmProperties=apiUserName=example -BjvmProperties=apiKey=abcdef1234567890

mainJar=filename

アプリケーションのメイン・クラスを含むJARファイルの名前。一般的に、ファイル名はJARファイル・マニフェストから抽出され、他のjavapackagerコマンドを使用している場合は設定する必要はありません。

preferencesID=node

ユーザーがオーバーライドできるJVMオプションを確認するために調べるプリファレンス・ノード。指定したノードは、オプション-Dapp.preferences.idとして実行時にアプリケーションに渡されます。この引数は、userJVMOptions引数とともに使用されます。

runtime=path

パッケージ・バンドルに含めるJREまたはJDKの場所。JDKまたはJREのルート・フォルダへのファイル・パスを指定します。システム・デフォルトJREを使用するには、次の例に示すようにパスを指定しないでください。

-Bruntime=

userJvmOptions=option=value

ユーザーがオーバーライドできるJVMオプション。javaコマンドに有効なオプションを使用できます。オプション名とそのオプションの値の両方を指定します。複数のオプションを渡すには、次の例に示すように-Bオプションの複数インスタンスを使用します。

-BuserJvmOptions=-Xmx=128m -BuserJvmOptions=-Xms=128m

OS Xアプリケーション・バンドラ引数

mac.category=category: アプリケーションのカテゴリ。カテゴリは、Apple Developer Webサイトにあるカテゴリ・リスト内に含まれている必要があります。
mac.CFBundleIdentifier=value: CFBundleIdentifierの情報plistに格納されている値。この値は、グローバルに一意である必要があり、文字、数字、ドットおよびダッシュのみを含む必要があります。DNS順序の反転をお薦めします(例: com.example.application.my-application)。
mac.CFBundleName=name: OS Xメニュー・バーに表示されるアプリケーションの名前。16文字未満の名前をお薦めします。デフォルトは名前属性です。
mac.CFBundleVersion=value: アプリケーションのバージョン番号は内部的に使用されます。値は1つ以上3つ以下の整数である必要があり、1.3や2.0.1のようにピリオド(.)で区切ります。値は、appVersion引数の値と異なる可能性があります。appVersion引数が有効な値で指定され、mac.CFBundleVersion引数が指定されていない場合、appVersion値が使用されます。どちらの引数も指定されていない場合、100がバージョン番号として使用されます。
mac.signing-key-developer-id-app=key: 開発者IDまたはGatekeeper署名に使用する署名キーの名前。Apple Developer Webサイトから標準のキーをインポートした場合、そのキーがデフォルトで使用されます。キーを識別できない場合、アプリケーションは署名されません。
mac.bundle-id-signing-prefix=prefix: plistまたは既存の署名がないバイナリがバンドル内に見つかった場合に署名済バイナリに適用される接頭辞。

OS X DMG (ディスク・イメージ)バンドラ引数

ディスク・イメージがマウント可能になる前に、OS X DMGインストーラは、licenseFileによって指定されているライセンス・ファイル(指定されている場合)を表示します。

licenseFile=path: バンドラによって表示または記録される使用許諾契約(EULA)の場所。パスは、パッケージ・アプリケーション・リソースに相対的です(例: -BlicenseFile=COPYING)。
systemWide=boolean: 使用対象のドラッグしてインストールするターゲットを示すフラグ。アプリケーション・フォルダを表示するには、trueに設定します。デスクトップ・フォルダを表示するには、falseに設定します。デフォルトはtrueです。
mac.CFBundleVersion=value: アプリケーションのバージョン番号は内部的に使用されます。値は1つ以上3つ以下の整数である必要があり、1.3や2.0.1のようにピリオド(.)で区切ります。値は、appVersion引数の値と異なる可能性があります。appVersion引数が有効な値で指定され、mac.CFBundleVersion引数が指定されていない場合、appVersion値が使用されます。どちらの引数も指定されていない場合、100がバージョン番号として使用されます。
mac.dmg.simple=boolean: AppleScriptコードの実行に依存するDMGカスタマイズ手順をスキップするかどうかを示すフラグ。trueに設定して、手順をスキップします。trueに設定されている場合、ディスク・ウィンドウにバックグラウンド・イメージがないため、アイコンが所定の位置に移動しません。systemWide引数もtrueに設定されている場合、ルート・アプリケーション・フォルダのシンボリック・リンクがDMGファイルに追加されます。systemWide引数がfalseに設定されている場合、アプリケーションのみがDMGファイルに追加され、デスクトップのリンクは追加されません。

OS X PKGバンドラ引数

OS X PKGインストーラは、ウィザードを示し、licenseFileによって指定されているライセンス・ファイルをウィザード内のページに表示します。ユーザーはアプリケーションをインストールする前に条件に同意する必要があります。

licenseFile=path: バンドラによって表示または記録される使用許諾契約(EULA)の場所。パスは、パッケージ・アプリケーション・リソースに相対的です(例: -BlicenseFile=COPYING)。
mac.signing-key-developer-id-installer=key: 開発者IDまたはGatekeeper署名に使用する署名キーの名前。Apple Developer Webサイトから標準のキーをインポートした場合、そのキーがデフォルトで使用されます。キーを識別できない場合、アプリケーションは署名されません。
mac.CFBundleVersion=value: アプリケーションのバージョン番号は内部的に使用されます。値は1つ以上3つ以下の整数である必要があり、1.3や2.0.1のようにピリオド(.)で区切ります。値は、appVersion引数の値と異なる可能性があります。appVersion引数が有効な値で指定され、mac.CFBundleVersion引数が指定されていない場合、appVersion値が使用されます。どちらの引数も指定されていない場合、100がバージョン番号として使用されます。

Mac App Storeバンドラ引数

mac.app-store-entitlements=path: アプリケーションが動作する資格を含むファイルの場所。ファイルは、Appleによって指定されている形式である必要があります。ファイルへのパスは、絶対条件で指定することも、javapackagerの呼出しに対して相対的に指定することもできます。資格を指定しない場合、アプリケーションは、通常のアプレット・サンドボックスよりもより厳しいサンドボックスで動作し、ネットワーク・ソケットおよびすべてのファイルへのアクセスが拒否されます。
mac.signing-key-app=key: Mac App Storeのアプリケーション署名キーの名前。Apple Developer Webサイトから標準のキーをインポートした場合、そのキーがデフォルトで使用されます。キーを識別できない場合、アプリケーションは署名されません。
mac.signing-key-pkg=key: Mac App Storeのインストーラ署名キーの名前。Apple Developer Webサイトから標準のキーをインポートした場合、そのキーがデフォルトで使用されます。キーを識別できない場合、アプリケーションは署名されません。
mac.CFBundleVersion=value: アプリケーションのバージョン番号は内部的に使用されます。値は1つ以上3つ以下の整数である必要があり、1.3や2.0.1のようにピリオド(.)で区切ります。値は、appVersion引数の値と異なる可能性があります。appVersion引数が有効な値で指定され、mac.CFBundleVersion引数が指定されていない場合、appVersion値が使用されます。どちらの引数も指定されていない場合、100がバージョン番号として使用されます。

Linux Debianバンドラ引数

licenseFileによって指定されているライセンス・ファイルは、すべてのケースにおいてユーザーに示されませんが、ファイルはアプリケーション・メタデータに含まれています。

category=category

Linux RPMバンドラ引数

category=category

非推奨のオプション

次のオプションは、パッケージ化ツールで使用されておらず、存在していても無視されます。

-runtimeversion version: JavaFXランタイムの必須バージョン。非推奨。
-noembedlauncher: 指定した場合、パッケージャはJavaFX起動クラスをJARファイルに追加しません。非推奨。

注

-vオプションは、任意のタスク・コマンドで詳細出力を有効にするために使用できます。
コマンドに-srcdirオプションを指定できる場合は、このオプションを複数回使用できます。-srcfilesオプションを指定した場合は、その引数に指定したファイルが、先行するsrcdirオプションに指定した場所で検索されます。-srcdirが-srcfilesの前に指定されていない場合は、javapackagerコマンドが実行されるディレクトリが使用されます。

例

例1 - -createjarコマンドの使用: javapackager -createjar -appclass package.ClassName -srcdir classes -outdir out -outfile outjar -v

classesディレクトリの内容をoutjar.jarにパッケージ化し、アプリケーション・クラスをpackage.ClassNameに設定します。
例2 - -deployコマンドの使用: 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に生成します。
例3 - -makeallコマンドの使用: javapackager -makeall -appclass brickbreaker.Main -name BrickBreaker -width 600 -height 600

コンパイル、createjarおよびdeployを含むすべてのパッケージ化作業を実行します。
例4 - -signjarコマンドの使用: javapackager -signJar --outdir dist -keyStore sampleKeystore.jks -storePass **** -alias duke -keypass **** -srcdir dist

distディレクトリ内のすべてのJARファイルに署名し、指定された別名、keyStoreおよびstorePassを使って証明書を添付し、署名されたJARファイルをdistディレクトリに再び配置します。
例5 - バンドラ引数を伴う-deployコマンドの使用: javapackager -deploy -native deb -Bcategory=Education -BjvmOptions=-Xmx128m -BjvmOptions=-Xms128m -outdir packages -outfile BrickBreaker -srcdir dist -srcfiles BrickBreaker.jar -appclass brickbreaker.Main -name BrickBreaker -title "BrickBreaker demo"

自己完結型アプリケーションとしてBrickBreakerアプリケーションを実行するためのネイティブLinux Debianパッケージを生成します。

目次前次

連絡先