8 jrecreateを使用したJREの作成

jrecreateの実行

ホスト・コンピュータでjrecreateを実行してから、結果のJREを埋込みデバイスにコピーする必要があります。

jrecreateコマンドの構文

jrecreate --dest host-destination-directory [options]

jrecreateオプション

オプションは任意の順序で指定できます。 必要なオプションは1つのみで、jrecreateがJREを書き込むディレクトリです。

二重ハイフンは、すべてのオプションの長い形式の前にあります。

-h

--help

オプション。 コマンドライン・オプションのサマリーが必要な場合、唯一のオプションとして使用します。

-d path

--dest path

必須です。 JREイメージおよび関連ファイルを書き込むディレクトリ。 存在していないディレクトリを指定する必要があります。

-p profile

--profile profile

オプション。 デフォルト: 完全なJRE API。

APIが指定されたプロファイル(「コンパクト・プロファイルについて」を参照してください)に基づくJREを作成します。 有効な値は次のいずれかです:

• compact1

• compact2

• compact3

--vm jvm

オプション。 --vmも--profileも指定されていない場合、使用可能なすべてのJVMがJREに含まれます。

特定のJava Virtual Machine (JVM)またはすべてのJVMを持つJREを作成します。 「Oracle Java SE Embedded JVMについて」を参照してください。 有効な値は次のいずれかです:

• minimal

• client

• server (ターゲット・コンピュータで使用可能な場合)

• all (ターゲット・コンピュータで使用可能なすべて)

複数のJVMが使用可能な場合にjavaプログラム・ランチャがJVMを選択する方法については、「javaランチャ・ツールを使用したアプリケーションの起動」を参照してください。

--vmオプションを指定しない場合、jrecreateコマンドは、次のように--profileオプションの値を使用してJVMを選択します:

• compact1: minimal

• compact2: minimal

• compact3: client

-x extension [,extension ...]

--extension extension [, extension ... .]

オプション。 デフォルト: 拡張機能なし

JREにオプションのコンポーネントを追加します。 次に示す例外を除き、すべてのプロファイルおよびJVMと任意の組合せでコンポーネントを使用できます。

次のいずれかの方法で複数の拡張を指定できます:

• 複数オプション・インスタンス:
  --extension sunec \
--extension sunpkcs11

• extensions:
  --extension sunec,sunpkcs11のカンマ区切りリスト

有効な--extension値

• fx:graphics: Oracle Java SE EmbeddedのJavaFXコンポーネントで説明されているように、ヘッドフル・アプリケーション用のJavaFXグラフィックス・コンポーネントおよびベース・コンポーネントをインストールします。

• fx:controls: JavaFX Controlsコンポーネント、グラフィック・コンポーネント、ベース・コンポーネント、およびヘッドフル・アプリケーション用のFXMLコンポーネントをインストールします(Oracle Java SE EmbeddedのJavaFXコンポーネントを参照)。 fx:controlsを指定する場合、値としてfx:graphicsを追加する必要はありません。

• sunec: 楕円曲線暗号(ECC)のセキュリティ・プロバイダ。 「暗号化サービス・プロバイダ」を参照してください。

• sunpkcs11: 暗号トークン・インタフェース標準PKCS#11のセキュリティ・プロバイダ。 「暗号化サービス・プロバイダ」を参照してください。

• locales: デフォルトのUS-Englishのかわりに、すべてのJava SEロケールを含めます。 「ロケール」を参照してください。

• charsets: 拡張文字エンコーディング・セットを含めます。 「文字エンコーディング」を参照してください。

• nashorn: Nashorn JavaScriptエンジンを含めます。 「Nashorn JavaScriptエンジン」を参照してください。

-g

--debug

オプション。 デフォルト: デバッグがサポートされていません。

デバッグ・サポートを含むJREを作成します。これには、アプリケーションの検査および制御のためのJava Virtual Machineツール・インタフェース(JVMTI)サポートが含まれます。

--debugコンポーネントのノート:

• このオプションは、最小限のJVMでは無効です。 その組合せが指定されている場合、jrecreateコマンドはクライアントJVMを選択します。

• 一部のデバッグ機能では、javaコマンドを-XX:+UsePerfDataフラグを指定して実行する必要があります。 Oracle Java SE Embeddedでは、このフラグはデフォルトでオフになっています。

-k

--keep-debug-info

オプション。 デフォルト: デバッグ情報がありません。

クラスおよび署名されていないJARファイルからデバッグ情報を削除しません。 このオプションでは、デバッグを容易にするために一部のJREファイルのサイズを増やします。

--no-compression

オプション。 デフォルト: JARファイルの圧縮。

署名されていないJARファイルが非圧縮形式で作成されるJREを作成します。 このオプションは、起動時間が改善される可能性があるため、増加したフットプリントを取引します。 オプションがご使用の環境に有益かどうか試してみてください。

-n

--dry-run

オプション。 デフォルト: JREを作成します。

JREイメージを作成せずに説明レポートを生成します。

-v

--verbose

オプション。 デフォルト: terse出力。

jrecreateコマンドが起動するコマンドを含め、詳細な出力を表示します。 このオプションはデバッグに役立ちます。

--ejdk-home path

オプション。 デフォルト: EJDK_HOME環境変数の値(設定されている場合)、それ以外の場合は/ejdk <version>

カスタムJREで使用するOracle Java SE Embeddedランタイム・コンポーネントを含むディレクトリ。 このオプションは、複数のOracle Java SE Embeddedインストールがあり、installation1でjrecreateコマンドを実行して、installation2のコンポーネントを含むJREを構築する場合に使用します。 たとえば、installation1にARMコンポーネントが含まれ、installation2にx86コンポーネントが含まれる場合があります。

jrecreateコマンドの例

次の例は、jrecreateオプションを使用していくつかの共通カスタムJREを作成する方法を示しています。

installDir変数は、Oracle Java SE Embeddedがインストールされているホスト・ディレクトリを表します。

例1   

最小のJRE: ヘッドレス、compact1プロファイル、最小限のJVM (compact1のデフォルト)。

% installDir/ejdk<version>/bin/jrecreate.sh \
--profile compact1 \
--dest /tmp/defaultJRE/

例2   

compact2プロファイル。デバッグをサポートするクライアントJVM。

% installDir/ejdk<version>/bin/jrecreate.sh \
    --dest /tmp/exampleJRE1/ \
    --profile compact2 \
    --vm client \ 
    --keep-debug-info \
    --debug

例3   

JavaFXコントロールと、サーバーJVMおよびcompact3プロファイルに追加されたJava SEロケール。

% installDir/ejdk<version>/bin/jrecreate.sh \
    --dest /tmp/exampleJRE2 \
    --profile compact3 \
    --vm server \
    --extension fx:controls \
    --extension locales 

例4   

完全なJRE API、すべてのJVM (デフォルト)。

% installDir/ejdk<version>/bin/jrecreate.sh \
    --dest /tmp/exampleJRE3 

jrecreateコマンドの出力

実行を開始すると、jrecreateコマンドによって、JREの構築に使用されるオプションのサマリーが表示されます。たとえば:

Building JRE using options Options {
    ejdk-home: /home/xxxx/ejdk/ejdk<version>
    dest: /tmp/testjre
    target: linux_i586
    vm: minimal
    runtime: compact1 profile
    debug: false
    keep-debug-info: false
    no-compression: false
    dry-run: false
    verbose: false
    extension: []
}

JREディレクトリ

コマンドの完了後、ホスト上の宛先(--dest)ディレクトリには、JREに含まれるコンポーネントに応じて次のディレクトリを含めることができます:

• bin/: java JREアプリケーション・ランチャを含め、ターゲット・ネイティブ・コマンド。 ツールの補完は、--profileオプションの値によって異なります。

• lib/: クラス、JVM、タイムゾーン情報、その他のリソースなど、JREのコアを構成するファイル。

• release: Javaバージョン、プロファイル名(該当する場合)、オペレーティング・システム名、CPUアーキテクチャなど、生成されたJREの属性を取得するためにツールが読み取ることができるテキスト・ファイル。

• bom: JREの作成方法(jrecreateコマンド・オプション、コマンドで使用したファイルなど)を示すテキスト・ファイル。

• COPYRIGHT, LICENSE, README, THIRDPARTYLICENSEREADME.txt: 法律およびその他の文書。 --profileが(完全なJRE API)に指定されていない場合にのみ存在します。

Swing/AWTヘッドフル・アプリケーション用のJREの構成

Swing/AWTアプリケーションを実行する必要がある場合、Oracle Java SE EmbeddedのARM AWT/Swing構成では、SwingおよびAWTグラフィックAPIがサポートされます。 ヘッドフルSwing/AWTアプリケーションをサポートするプラットフォームについては、「Oracle Java SE Embeddedのシステム要件」を参照してください。

Swing/AWT APIをインストールするには、--profileオプションを指定せずにjrecreateコマンドを使用して完全なJREを作成する必要があります。 完全なJREでは、クライアントVM (--vm clientオプション)、サーバーVM (--vm serverオプション)または(--vm allオプションを指定するか、--vmオプションを指定しないままにします)の両方をインストールできます。 最小VMはサポートされていません。

AWT/SwingとJavaFXの両方のアプリケーションを、AWT/SwingとJavaFXの両方をサポートするターゲットで実行する場合は、fx:graphicsまたはfx:controlsを指定して--extensionオプションを追加することで、JavaFX APIを追加できます。 フットプリントを小さく保つには、JavaFXアプリケーションを実行していることがわかっている場合にのみ、JavaFX APIをインストールします。