マルチ リリース JAR ファイルを保護するには、PreEmptive Protection™ DashO™ New Project Wizard を使用します。この記事では、JAR ファイル用の DashO プロジェクトの作成、入力と保護設定の確認、JAR 署名の構成、および保護された JAR ファイルのビルドを実行する手順をひととおり示します。
必要条件
- DashO がインストールされている。
- 保護するマルチ リリース JAR ファイル。
- マルチ リリース JAR ファイルが必要とする Java バージョンに対応した JDK インストール。
- ライブラリに必要なサポート JAR ファイル。
- キーストア ファイルとその種類、パスワード、署名キーのエイリアス、およびキー パスワード。
マルチ リリース JAR ファイルを保護する
ステップ 1:New Project Wizard を起動する
- DashO を開きます。
- [File]>[New Project]を選択します。New Project Wizard が開きます。
- [Select Application Type]ページで、[Library]を選択します。
- [Next]をクリックします。
ステップ 2:ライブラリおよび JDK を選択する
- [Select Library]ページで、[Enter the location of your library]の[Browse]をクリックして、マルチ リリース JAR ファイルを選択します。
- [Enter your JDK's location]の[Browse]をクリックして、マルチ リリース JAR ファイルの Java バージョンに対応する JDK のインストール ディレクトリを選択します。
- [Next]をクリックします。
ステップ 3:jar ファイルを追加する
- [Add Jars]ページで、[Input]リストに jar ファイルが表示されていることを確認します。
- (任意)[Support jars]の下にある[Add]をクリックして、ライブラリに必要なサポート jar ファイルを追加します。
- [Missing classes]リストを確認します。リストにクラスが表示されている場合は、それらを含む jar ファイルをサポートとして追加します。
- [Next]をクリックします。
ステップ 4:エントリ ポイントを確認する
- [Select Entry Points]ページで、DashO が検出したエントリ ポイントを確認します。サンプル リストについては、例とユースケースを参照してください。
- ライブラリに必要なクラスとメソッドが選択されていることを確認します。既定のままにするか、必要に応じて調整します。
- [Next]をクリックします。
ステップ 5:アノテーションのエントリ ポイントを確認する
- [Select Annotation Entry Points]ページで、アノテーション ベースのエントリ ポイント オプションを確認します。
- (任意)アプリケーションで必要な場合にのみ、[Generate Entry Point rules based on Hibernate annotations]をオンにします。
- (任意)エントリ ポイントとして構成するアノテーションを選択します。
- [Next]をクリックします。
ステップ 6:プロジェクト ファイルを作成する
- [Select Project File]ページの[Enter the DashO project file to be created]で、作成する
.doxプロジェクト ファイルの場所と名前を入力するか、または[Browse]をクリックします。 - [Finish]をクリックします。DashO は新しいプロジェクトを開きます。
ステップ 7:入力を確認する
- ナビゲーション ツリーで[Input]を選択します。Input - Jars and Classes ページが開きます。
- マルチ リリース JAR ファイルがリストされていることを確認します。
- クラス ツリーで読み込まれたクラスを確認します。
- [Input]>[Support]を選択し、必要なサポート jar ファイルがすべてリストされていることを確認します。
詳細については、入力の管理を参照してください。
ステップ 8:保護設定を確認する
ウィザードは既定で以下の保護を有効にします。
ステップ 9:JAR 署名を構成する
- ナビゲーション ツリーで[Output]>[Signing]を選択します。Output - Signing ページが開きます。
- [Sign Jars/WAR/APK/AAB]をオンにします。
- [Signing Tool]に、JDK の
binディレクトリ内にあるjarsignerなどの署名ツールのパスを入力するか、参照して指定します。 - [Key Store]で、[Location]の隣にある[Browse]をクリックし、キーストア ファイルを選択します。
- キーストアの[Type]と[Password]を入力します。
- [Signing Key]で、[Alias]と[Password]を入力します。
- (任意)[Options]で、[Signature File]、[Internal .SF]、[Sections Only]、または[Additional Arguments]を設定します。出力とビルド結果を参照してください。
ステップ 10:保護された JAR をビルドする
- プロジェクトを保存します。
- [Build]をクリックします。
- ビルドが完了したら、[Console]タブと[Problems]タブを調べ、エラーがないことを確認します。
- 構成された出力ディレクトリ内で、保護された jar ファイルを見つけます。出力とビルド結果を参照してください。
- 出力に期待されるクラスとマルチ リリース JAR 構造が含まれていることを確認します。
例とユースケース
Mrjar-sample-1.0.0.jar という名前のサンプル ライブラリの場合、ウィザードは次のエントリ ポイントを検出します。
-
mrjar-sample-1.0.0.jar(ライブラリとして) Main public static main(java.lang.String[])VersionTester public static main(java.lang.String[])
ビルド後、Results ページには、元のクラス名と新しいクラス名が表示されます。
制限事項とトラブルシューティング
| 問題 | 原因と解決策 |
保護された JAR ファイルが ClassNotFoundException またはその他のランタイム エラーをスローします。
|
JDK が、マルチ リリース JAR ファイルの Java バージョンと一致していません。[Select Library]ページまたは[Input]>[Support]ページで一致する JDK を選択して、再度ビルドします。 |
コンソールに次のように表示されます。Support for running on Java 8 is deprecated and will be removed in a future release.
|
DashO は Java 8 で実行されています。 |
関連記事