難読化
難読化プロジェクトは、保護するアセンブリ、その依存関係、それぞれの設定をまとめたものです。Babel Desktop はプロジェクトをキャンバス上のグラフまたはグリッドの表として表示し、Babel Obfuscator のエンジンで実行します。
Babel Desktop は、プロジェクトを .babel ファイルとして保存します。これは MSBuild タスクが使用する MSBuild プロジェクト形式です。Babel Desktop で保存したプロジェクトは MSBuild でビルドでき、既存の .babel プロジェクトは Babel Desktop で開けます。
バージョン 12.1.1 以降では、MSBuild タスクがインストールされているコンピューターで保存したプロジェクトは、そのインストール先のファイルからタスクを読み込みます。アセンブリ名とバージョンでタスクを指定している既存のプロジェクトは、保存時に変換されます。MSBuild タスクを参照してください。
Babel Desktop は、コメント、カスタムプロパティ、カスタム MSBuild タスクなど、.babel ファイルのうち自身が編集しない部分をそのまま保持します。MSBuild のインポート、条件、カスタムタスクは評価しないため、これらに依存するプロジェクトは MSBuild でビルドする必要があります。ただし、Babel タスクの UsingTask 要素は例外で、上記のとおり変換されます。
ターゲット、依存関係、フロー
プロジェクトは、いくつかの種類の要素で構成されます。このセクションのほかのページでは、次の用語を次の意味で使用します。
| 用語 | 意味 |
|---|---|
| ターゲット | エンジンが難読化し、専用の出力ファイルに書き出すアセンブリです。ターゲットはそれぞれ独自の設定を持ちます。プライマリターゲットとも呼ばれます。 |
| 依存関係 | ターゲットにマージされるアセンブリ、ターゲットに埋め込まれるアセンブリ、またはターゲットの参照を解決するためだけに使われるアセンブリです。依存関係は 1 つのターゲットに属し、独自の設定は持ちません。依存関係を参照してください。 |
| マップリンク | 2 つのターゲット間の接続です。先のターゲットが XML のリネームマップを書き出し、後のターゲットがそれを読み込むため、両者でパブリックシンボルの新しい名前が一致します。実行順序を参照してください。 |
| フロー | 依存関係、マップリンク、実行順序によって結び付けられたターゲットのグループです。フロー内のターゲットは、ステップの順に 1 つずつ実行されます。 |
プロジェクトの作成
プロジェクトは、アセンブリの追加から最初の実行まで、4 つの手順で作成します。
アセンブリを追加する
スタート画面の「アセンブリを追加」か、ツールバーの「+ アセンブリを追加」(Ctrl+Shift+A、macOS では Cmd+Shift+A)をクリックします。ファイルマネージャーから .NET アセンブリをキャンバスにドラッグすることもできます。追加したアセンブリは、それぞれターゲットになります。ターゲットは、キャンバス上ではノード、グリッドでは行として表示されます。
依存関係を接続する
ターゲットにマージするアセンブリ、埋め込むアセンブリ、ターゲットが参照するアセンブリを追加します。手順は依存関係で説明しています。一緒に配布する一連のアセンブリでは、互いのパブリック API を使用するターゲット同士をマップリンクで接続します。
各ターゲットを設定する
ターゲットを選択してプロパティパネルを開き、設定と XML ルールを編集します。グリッドでは、複数のターゲットをまとめて編集することもできます。ターゲットの設定とプロジェクトのグリッドを参照してください。
保存して実行する
「ファイル > 保存」(Ctrl+S、macOS では Cmd+S)でプロジェクトを保存し、「プロジェクトを実行」(Ctrl+Enter、macOS では Cmd+Enter)をクリックします。プロジェクトの実行を参照してください。
最もよくある 2 つのケースでは、セットアップコマンドが 2 番目と 3 番目の手順をまとめて実行します。ライブラリをマージした 1 つのアプリケーションと、パブリックシンボルをリネームする一連のライブラリです。どちらの手順も代表的なワークフローで説明しています。
プロジェクトのオープンと保存
プロジェクトは .babel ファイルとして保存されます。プロジェクトのコマンドの多くは「ファイル」メニューにあり、キーボードショートカットも割り当てられています。
| 操作 | 方法 |
|---|---|
| 新しいプロジェクト | 「ファイル > 新しいプロジェクト」、Ctrl+N(macOS では Cmd+N)、コマンドパレットの「プロジェクト: 新規作成」、またはツールバー左端の「新しいプロジェクト」ボタン |
| プロジェクトを開く | 「ファイル > プロジェクトを開く…」、Ctrl+O(macOS では Cmd+O)、スタート画面の「プロジェクトを開く…」ボタン、またはグリッドにドロップした .babel ファイル |
| 最近使用したプロジェクトを開く | コマンドパレットの「プロジェクト: 最近使用したプロジェクトを開く…」 |
| 保存 | 「ファイル > 保存」、Ctrl+S(macOS では Cmd+S) |
| 別の名前で保存 | 「ファイル > 名前を付けて保存…」、Ctrl+Shift+S(macOS では Cmd+Shift+S) |
「保存」は開いている .babel ファイルに書き込み、ファイル名を尋ねるのは新しいプロジェクトの場合だけです。「プロジェクトを開く」ダイアログは、最後に開いたプロジェクトのフォルダーから始まります。現在のプロジェクトに未保存の変更がある場合、Babel Desktop は別のプロジェクトを作成したり開いたりする前に、変更を破棄するかどうかを確認します。ウィンドウを閉じる前にも同じように確認します。ジョブの実行中は、その完了を待ってから別のプロジェクトを開いてください。
また、Babel Desktop は、プロジェクトを最後にキャンバスとグリッドのどちらで表示したかを、このコンピューター上に記憶します。ビューを切り替えても、プロジェクトファイルは変更されません。
入力の置き換え
設定を失わずに、ターゲットをアセンブリの新しいビルドに向けるには、ターゲットを選択して、コマンドパレットから「アセンブリ: 設定を保持して入力を置換…」を実行します。「アセンブリ: 選択したターゲットを削除」、またはノードや行のメニューの「ターゲットを削除」は、ターゲットをその依存関係と接続ごと削除します。
このセクションのページ
以下のページでは、プロジェクトの 2 つのビュー、ターゲットの接続と実行順序、ターゲットの設定、実行とその結果を説明し、最後に完全な例を紹介します。
- プロジェクトのキャンバス:グラフのビュー、ノード、ノードのメニュー、表示位置の移動。
- 依存関係:マージ、埋め込み、参照の依存関係と、ターゲットを別のターゲットにマージする方法。
- 実行順序:フロー、ステップ、フローエッジ、マップリンク。
- プロジェクトのグリッド:表のビュー、多数のターゲットの一括編集、実行順序、各ターゲットの詳細。
- ターゲットの設定:プロパティパネル、マップファイル、XML ルール、エンジンプラグイン、セットアップコマンド、保護レベル。
- プロジェクトの実行:出力ファイル、「アクティビティ」パネル、警告、フローの並列実行。
- 実行結果:各実行の難読化スコアと保護の統計。
- 代表的なワークフロー:単一のアプリケーション、ライブラリをマージしたアプリケーション、パブリック難読化を適用する一連のライブラリ。
保護されたアプリケーションの難読化されたスタックトレースを、XML マップファイルを使って元の名前に戻すには、スタックデコーダーを使用します。