アプリケーションを保護するために、PreEmptive Protection™ DashO™ はまずそのバイトコードとリソースを分析する必要があります。この記事では、プロジェクトの入力、サポート クラスパス、非クラス ファイル、および入力オプションを構成する方法について説明します。DashO は、標準モードと Android モードで入力の処理方法が異なります。
| モード | DashO による入力の管理方法 |
| 標準モード | DashO が処理するファイルは、ユーザー自身が管理します。 |
| Android モード | DashO は、Gradle ビルドで生成されるパスの割り当て(Path Map)から、アプリのコンポーネントを自動的に識別します。 |
必要条件
- 標準モードまたは Android モードの DashO プロジェクト。
- Android モードの場合:現在のコンピューター上で実行された、現在の構成のビルド。
標準モードでの入力の構成
標準モードでは、DashO が処理するファイルを手動で管理します。
Jars and Classes
- [Input]ページに移動します。
- 次のいずれかの方法で入力を追加します。
- [Add]をクリックして、ファイル システムから JAR、WAR、ZIP ファイル、単一の APK ファイル、またはクラスのディレクトリを選択します。
- [New]をクリックして、パスを入力します。パスにプロパティ参照が含まれている場合は、このオプションを使用します。
- パスを入力した場合は、クラス ツリーを更新します。
- プロジェクトを保存します。
詳細については、<inputpath> 要素を参照してください。
Supporting Classpath
DashO は、Java または Android ランタイムと、アプリケーションが使用するサードパーティ製ライブラリにアクセスする必要があります。DashO は分析のためにここで参照されるクラスを必要としますが、それらを処理することはありません。
- [Input]>[Support]に移動します。
- 次のいずれかの方法でサポートを追加します。
- [Add]をクリックして、エントリを選択します。
- [New]をクリックして、エントリを入力します。
- JDK 設定を構成します。詳細については、設定を参照してください。
- プロジェクトを保存します。
設定
| 設定 | 説明 |
| Include JDK(JDK の導入) |
サポートとして指定した JDK ホーム ディレクトリによって提供される、すべてのブートストラップ クラスおよび拡張クラスを導入します。 Android API または J2ME を使用するプロジェクトでは、JDK を導入しないでください。このようなプロジェクトには、 既定値である 場所の例: Windows: macOS: |
| Set JDK_HOME and JAVA_HOME properties(JDK_HOME および JAVA_HOME プロパティの設定) | [Include JDK]が有効になっていることを前提として、JDK_HOME および JAVA_HOME プロパティを指定された JDK の値に設定します。 |
詳細については、<classpath> 要素を参照してください。
Included Non-Class Files
[Included Non-Class Files]ページでは、最終パッケージに含める必要があるイメージ、プロパティ ファイル、XML 構成ファイルなどのリソースを指定します。
- [Input]>[Non-Class Files]に移動します。
- 次のいずれかの方法でエントリを追加します。
- [Add]をクリックして、ディレクトリ、個々のファイル、または JAR ファイルを選択します。
- [New]をクリックして、エントリを入力します。ディレクトリ エントリでは、* ワイルドカードを使用して、特定のファイルの種類を選択できます。
- プロジェクトを保存します。
DashO は、ディレクトリ、ZIP、JAR、および WAR ソースから非クラス ファイルを出力にコピーし、それらの相対的な内部ディレクトリを保持します。ディレクトリおよび JAR ファイルの場合は、すべての非クラス ファイルをコピーします。
DashO が入力の非クラス ファイルをどのように処理するかは、入力をマージするかどうかによって決まります。
| 入力 | 入力 JAR 内の非クラス ファイル | 入力ディレクトリ内の非クラス ファイル |
| マージされない | 自動的にコピーされます | コピーされません。このページで追加します。 |
| マージされる | [Auto Copy]をオンにするか、このページで追加します。 | |
詳細については、<includenonclassfiles> 要素と Auto Copy を参照してください。
Options
[Input]>[Options]ページでは、DashO が入力クラスの分析中に使用する基本的なオプションを制御します。
- ナビゲーション ツリーで[Input]>[Options]を選択します。
-
必要なオプションを選択します。
オプション 説明 Ignore Missing Classes(不足クラスを無視) 呼び出されたクラスが見つからない場合でも、DashO に分析を続行するよう指示します。
Ignore Missing Members(不足メンバーを無視) 参照されるメソッドまたはフィールドが見つからない場合でも、DashO にビルドを続行するよう指示します。
Ignore Missing Entry Points(不足エントリ ポイントを無視) DashO が見つけられないエントリ ポイントに対して、エラーでビルドを停止するのではなく、警告を生成します。既定では、構成された Java プロジェクトのエントリ ポイントが見つからない場合、ビルドはエラーで停止します。
複数のエントリ ポイントが不足している大規模なプロジェクトでは、このオプションを使用することで、1 つのエントリ ポイントを解決または削除するたびにビルドが繰り返し停止するのを防ぐことができます。
Exclude classes having a method larger than 64K(64K よりも大きいメソッドがあるクラスを除外) 難読化後にコード サイズが 65,535 バイトを超えるメソッドを含むクラスを自動的に除外し、ビルドの失敗を防ぎます。このオプションを有効にしている場合、DashO はそのようなクラスを自動的に「Global Processing Exclusions」(グローバルな処理の対象除外)リストに追加します。
これにより、それらのクラス内のすべてのメソッドが、より小さなメソッドであっても難読化の対象から除外されます。
Bypass DashO Processing(DashO 処理を回避) DashO が処理を一切行わず、入力をそのまま出力先へコピーするように構成します。このオプションは、マージされていないディレクトリまたは APK に出力する場合にサポートされます。 Reflection Halts Build(リフレクションによるビルド中止) DashO がリフレクションを検出した際にビルドを停止することにより、リフレクションの使用状況を把握し、ターゲットを識別しやすくします。
Determine Reflected Classes(リフレクション クラスの特定) リフレクションのターゲットを自動的に検出し、最終出力に確実に反映されるようにします。
Rename Reflected Classes(リフレクション クラスを名前変更) リフレクションを介してアクセスされるクラスの名前を変更できるようにします。既定では、リフレクションのターゲットは元の名前を保持します。 - 変更を適用するには、プロジェクトを保存してビルドします。
Android モードでの入力の構成
Android モードでは、DashO は自動入力管理(AIM)を使用して、Gradle ビルド中に生成された Path Map に基づいてアプリケーションのコンポーネントを識別します。
Android モードの[Input]ページは、次の場合にのみ表示されます。
- 現在の DashO 構成を使用して、現在のコンピューター上でビルドが実行された。
- 関連ファイルがディスク上に残っている。
保存された Android モード構成の入力を DashO が見つけられない場合、次のメッセージが表示されます。
Your inputs could not be located. Please run a build and refresh the path map.
| 項目 | 説明 |
| Current Build Variant(現在のビルド バリアント) |
直近にビルドされた Android プロジェクトのバリアント名を表示します。Android モード プロジェクトを読み込むか、そのパスの割り当て(Path Map)を更新すると、DashO はそのバリアントの入力、依存関係、クラス、およびリソースを読み込みます。別のバリアントを表示するには、そのバリアントだけをクリーンアップしてビルドし、その後パスの割り当てを更新します。 バリアントをクリーンしてビルドする例: gradlew clean assembleSomeFlavorRelease
|
| Cache Directory(キャッシュ ディレクトリ) |
Android モード プロジェクトで使用されるパスの割り当ての場所を DashO がキャッシュするディレクトリへの完全なパスを表示します。 [directory of DashO configuration]/.dasho/[configuration file name].cache
|
| Path Map(パスの割り当て) |
DashO GUI がプロジェクトの入力や依存関係を特定するために現在使用しているパスの割り当てファイルへのパスを表示します。 詳細については、パスの割り当てリファレンスを参照してください。 |
| Inputs(入力) |
現在のパスの割り当てファイルに記述されている JAR ファイルとディレクトリを表示します。DashO はこれらのエントリを使用して、他の GUI ページのクラス一覧を作成します。該当する場合、プロジェクト コードには <Project Classes> というラベルが付けられます。JAR ファイルやディレクトリのツール ヒントには、それらの完全なパスが表示されます。
|
| Dependencies(依存関係) | DashO が処理は行わないものの、入力クラスを解釈するために読み込む JAR ファイルやディレクトリを表示します。これには、Android SDK の JAR ファイルや、Androidアプリケーションまたはライブラリのコードに含まれていないその他のライブラリが含まれます。 |
制限事項とトラブルシューティング
| 問題 | 原因と解決策 |
| Superclass Class Not Found エラーでビルドが失敗します。 | DashO は外部依存関係からスーパークラスを見つけることができません。DashO は、アプリケーションが拡張または実装しているクラスの不足を無視できないため、[Ignore Missing Classes]を選択しても解決しません。[Input]>[Support]ページで、スーパークラスを含む JAR ファイルを追加してください。詳細については、「Superclass Class Not Found」エラーの解決を参照してください。 |
| DashO が構成されたサポート エントリを見つけられないため、ビルドが失敗します。 |
そのエントリを修正するか、削除してください。エラーではなく警告を表示するには、ユーザー プロパティ WARN_ON_MISSING_SUPPORT_ENTRY を true に設定します。
|
| 入力したパスがクラス ツリーに表示されません。 | クラス ツリーを更新してください。DashO は、手動で入力された名前については自動的に更新しません。 |
| エントリ ポイントが見つからないため、ビルドが繰り返し停止します。 | [Ignore Missing Entry Points]を選択すると、代わりに警告が表示されるようになります。 |
| 難読化後にメソッドのサイズが 64K を超えるため、ビルドが失敗します。 | [Exclude classes having a method larger than 64K]を選択してください。DashO はそれらのクラス全体を難読化の対象から除外します。 |
| Reflection Halts Build が、DashO 独自のチェック コードで停止します。 | このオプションを使用している間は、チェックを無効にしてください。 |
Android モードで次のように表示されます。Your inputs could not be located. Please run a build and refresh the path map.
|
DashO は、保存された構成の入力を見つけることができません。このコンピューター上でビルドを実行してから、パスの割り当てを更新してください。 |
| Android モードで間違ったビルド バリアントが表示されます。 | 必要なバリアントのみをクリーンしてビルドし、その後パスの割り当てを更新してください。詳細については、別のビルド バリアントの表示を参照してください。 |
「Superclass Class Not Found」エラーの解決
Maven および Spring Boot アプリケーションは、多くの場合、外部の JAR ファイルに依存しています。クラスのいずれかが、DashO で見つけられない外部 JAR のクラスを拡張している場合、ビルドは Superclass Class Not Found エラーで失敗します。DashO は、アプリケーションが拡張または実装しているクラスの不足を無視できないため、[Ignore Missing Classes]を選択しても解決しません。代わりに、JAR ファイルをサポートとして追加してください。
- Maven または Spring Boot アプリケーションをビルドします。
- ローカルの
.m2リポジトリで、必要な JAR ファイルを探します。 - [Input]>[Support]ページで、JAR ファイルを追加します。詳細については、Supporting Classpath を参照してください。
- [Build]をクリックします。
- 保護されたアプリケーションを検証します。
java -jar <難読化されたアプリケーション>.war
ビルドは Superclass Class Not Found エラーが発生することなく完了し、保護されたアプリケーションが実行されます。
別のビルド バリアントの表示
- 表示したいバリアントのみをクリーンしてビルドします。
gradlew clean assembleSomeFlavorRelease - パスの割り当てを更新します。
関連記事