PreEmptive Protection™ DashO™ の除去は、DashO ユーザー インターフェイスにある次の 4 つのページから構成します。ページは Removal - Options、Removal - Exclude、Removal - Classes、および Method Call Removal です。これらを使用して、未使用のコードや不要な属性を除去したり、特定の項目を保持したり、特定のクラスを除去したり、特定のメソッドへの呼び出しを除去したりできます。
除去の仕組みについては、除去およびメソッド呼び出しの除去を参照してください。
必要条件
- 標準 モードの DashO プロジェクト。[Removal]ページは標準モードでのみ使用できます。
除去オプションの構成
- ナビゲーション ツリーで[Removal]を選択します。
- [Unused Classes]では、DashO が使用されていないクラスを除去する方法を選択します。
- [Unused Members]では、DashO が使用されていないメソッドとフィールドを除去する方法を選択します。
- [Debug Information]で、除去する項目を選択します。
- [Attributes]で、除去する項目を選択します。
- 変更を適用するには、プロジェクトを保存してビルドします。
除去オプション設定
| 設定 | 説明 | プロジェクト ファイル要素 |
| Unused Classes | 未使用のクラスをすべて除去する(Remove)か、public または protected 修飾子を持たない未使用のクラスのみを除去する(Remove if not public)、または除去を実行しません(Do not remove)。 | <removal> |
| Unused Members | 未使用のメソッドとフィールドをすべて除去する(Remove)か、パブリックでない未使用のメソッドとフィールドのみを除去する(Remove if not public)、または除去を実行しません(Do not remove)。 | <removal> |
| Debug Information | コンパイラが挿入するデバッグ情報のうち、選択された情報を除去します。 | <debug> |
| Attributes | 選択された追加属性を除去します。 | <attributes> |
非推奨メタデータの除去
[Attributes]で[Deprecated]を選択した場合、DashO は JVM の Deprecated 属性と java.lang.Deprecated アノテーションの両方を除去します。その他のアノテーションは変更されません。
アノテーションを保持するには、プロジェクト ファイルの <attributes> 要素で preserveDeprecatedAnnotation="true" を設定します。既定値は false です。
<attributes
types="Deprecated"
preserveDeprecatedAnnotation="true"/>除去対象から項目を除外
個々のメソッド、フィールド、クラス、またはパッケージ全体を除去の対象から除外するには、[Removal - Exclude]ページを使用します。このページでは DashO の規則エディターを使用します。規則の作成、編集、プレビューの詳細については、規則エディターを参照してください。
- ナビゲーション ツリーで[Removal]>[Exclude]を選択します。
- DashO に保持させたい項目に対する規則を作成します。詳細については、規則エディターを参照してください。
- 変更を適用するには、プロジェクトを保存してビルドします。
特定のクラスの除去
コードで使用されているかどうかにかかわらず、単体テストやサンプルなどのクラスを除去するには、[Removal - Classes]ページを使用します。
- ナビゲーション ツリーで[Removal]>[Classes]を選択します。
- 除去するクラスまたはパッケージに対する規則を作成します。詳細については、規則エディターを参照してください。
- 変更を適用するには、プロジェクトを保存してビルドします。
メソッド呼び出しの除去の構成
特定のメソッドへの呼び出しを除去するには、[Method Call Removal]ページを使用します。メソッド呼び出しの除去の仕組みと、プログラムの動作がどのような変わるかについては、メソッド呼び出しの除去を参照してください。
- ナビゲーション ツリーで[Removal]>[Method Calls]を選択します。
- 呼び出しを除去したい各メソッドに対して規則を追加します。クラス名、メソッド名、および署名を入力します。
- 変更を適用するには、プロジェクトを保存してビルドします。
例とユースケース
| 目的 | ページ | 対処方法 |
| アプリケーションから未使用のコードを除去する | Removal - Options | [Unused Classes]および[Unused Members]を Remove に設定します。 |
| 判読可能なスタック トレースを保持する | Removal - Options | [Debug Information]の[Line Number Table]および[Source File]のチェックをオフにします。 |
| コードがリフレクションを介して読み込むクラスを保持する | Removal - Exclude | クラスに対象除外規則を追加します。 |
| 出力から単体テストを除去する | Removal - Classes | テスト パッケージに規則を追加します。 |
| ログ呼び出しを除去する | Method Call Removal | ログ メソッドごとに規則を追加します。 |
制限事項とトラブルシューティング
| 問題 | 解決策 |
| [Removal]のページが表示されません。 | それらのページは標準モードでのみ使用できます。Android モードでは、除去は R8 が処理します。 |
| 除外されたクラスも除去されます。 | [Removal - Classes]から一致する規則を削除します。それらの規則は対象除外規則より優先されます。 |
| メソッド呼び出しの除去規則が一致しません。 | 正規表現はサポートされていません。正確なクラス名、メソッド名、および署名を入力してください。 |
@Deprecated を読み取るコードが動作しなくなります。
|
preserveDeprecatedAnnotation="true" を設定してください。非推奨メタデータの除去を参照してください。
|
関連記事