NuGet パッケージ

PreEmptive がプライベートで配布する NuGet パッケージを使用して、Dotfuscator Professional をインストールすることができます。 このインストール方法によって、macOS および Linux 開発環境で Dotfuscator を実行することができます。 このインストール方法は Windows 開発環境でも使用できますが、通常は Windows インストーラーの使用をお勧めします。

ビルド エージェントもインストールに NuGet パッケージを使用することができます。詳細については、ビルド エージェントを参照してください。

NuGet パッケージについて

NuGet を使用して nuget.org からサードパーティのライブラリをプロジェクトに追加することには慣れているかもしれませんが、Dotfuscator NuGet パッケージはまったく異なる動作をします。

• このパッケージは、一般的なプログラミング用にライブラリを公開していません。 代わりに、このパッケージにはビルド時に独立したツールとして使用できる Dotfuscator のさまざまなコンポーネントが含まれています。
• プロジェクトに Dotfuscator NuGet パッケージへの参照を追加しません。 代わりに、パッケージをディレクトリに直接インストールし、そのディレクトリに抽出されたコンポーネントをビルドに使用させます。
• このパッケージは、パブリック nuget.org フィードでは利用できません。 代わりに、パッケージは PreEmptive からプライベートで配布され、組織内のプライベート フィードでホストされる必要があります。

このパッケージ ID は PreEmptive.Protection.Dotfuscator.Pro です （Dotfuscator Professional 評価版を使用しているお客様の場合は、この ID の最後に .Eval を追加してください）。

このページでは、Dotfuscator 自体を含むプライベート NuGet パッケージについて説明します。 チェック属性を含む従来の NuGet パッケージもあり、nuget.org から入手できます。 プロジェクトでこの NuGet パッケージを参照し、提供された属性を使用してコードにアノテーションを付けることができます。 Dotfuscator は実行時に、コンパイルされたコード内のこれらの属性を認識し、適宜チェックを差し込みます。

システム要件

NuGet パッケージを使用する Dotfuscator をインストールするには、NuGet パッケージをローカル ディレクトリにインストールする方法が必要になります。 最も簡単な方法は NuGet コマンド ライン インターフェイス（nuget.exe）を使用することですが、別の NuGet インターフェイスや、ZIP ファイルを抽出できるツールであればどれでも使用できます。 詳細については、インストール手順を参照してください。

パッケージ自体には 2 つのコンポーネント セットがあり、これらは 2 つのサブディレクトリに分かれています。 各コンポーネント セットには個別のシステム要件があります。

• tools/msbuilddir には、Dotfuscator の MSBuild コンポーネントが含まれています。 これらのコンポーネントは、ほとんどの .NET プロジェクトの通常のビルド処理に統合されるため、ほとんどの開発者が使用する必要があります。 要件はこちらで読むことができます。
• tools/programdir/netcore には、.NET 6 バージョンのコマンド ライン インターフェイスが含まれています。 要件はこちらで読むことができます。

MSBuild のシステム要件

NuGet パッケージによってインストールされた MSBuild コンポーネントを実行するための要件は、次のとおりです。

• MSBuild - 以下のいずれか：
  • MSBuild（.NET Framework）：4.0 以降。.NET Framework 4.7.2.1 以降で実行
  • MSBuild（.NET Core）：16.0 以降。.NET 6（バージョン 6.0 以降）ランタイムがインストール済み
  • MSBuild（Mono）：16.0 以降。Mono 6.0 以降で実行

MSBuild コンポーネントは、NuGet パッケージを介してインストールされた場合には、Windows、macOS、および Linux で実行されるビルドで使用することができます。 ただし、.pdb ファイルの生成など特定の機能には、Windows でのみ使用できる完全な .NET Framework SDK（バージョン 1.1 以降）が必要です。

サポートされている開発ツール

次の表は、NuGet パッケージを使用した場合に Dotfuscator がサポートする開発ツールを示しています。

コマンド ライン インターフェイスのシステム要件

NuGet パッケージによってインストールされた コマンド ライン インターフェイスを実行するための要件は、次のとおりです。

• .NET ランタイム：.NET 6 以降
  • メモ：.NET 6 ランタイムの 6.0.0 以降がインストールされている必要があります。 .NET が使用するランタイムの選択方法の詳細については、こちらを参照してください。 この制限は、処理済みのアプリケーションやインストール済みの SDK で使用されるバージョンには適用されません。

コマンド ライン インターフェイスは、NuGet パッケージを介してインストールされた場合には、Windows、macOS、および Linux で実行することができます。 ただし、.pdb ファイルの生成など特定の機能には、Windows でのみ使用できる完全な .NET Framework SDK（バージョン 1.1 以降）が必要です。

インストール手順

組織によっては、Dotfuscator NuGet パッケージを既に内部でホストしている可能性があります。そうであれば、パッケージがホストされている NuGet フィード URL を書き留めておきます。

そうでない場合は、次の操作を行います。

1. NuGet パッケージを開発用コンピューターにダウンロードします。Dotfuscator のダウンロード用 Web ページで、Dotfuscator Professional の NuGet パッケージをダウンロードします。
2. ダウンロードした .nupkg を新しいディレクトリにコピーします。
3. このディレクトリのパスを NuGet フィード URL として書き留めておきます。

NuGet パッケージをホストするか、またはダウンロードしたら、開発用コンピューターにそれをプロビジョニングできます。 以下のタブに示すように、これを行う方法は複数あります。

nuget install PreEmptive.Protection.Dotfuscator.Pro[.Eval] -Version 7.2.1 -OutputDirectory "{out dir}" -ExcludeVersion -Source "{feed url}"

<!-- これは Dotfuscator の MSBuild コンポーネントを使用する、プロジェクト用の MSBuild プロパティ ファイルです。
     詳細については、<https://www.preemptive.com/dotfuscator/pro/userguide/ja/interfaces_msbuild.html#user> を参照してください。
-->
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <PropertyGroup>
        <!-- NuGet パッケージを使用して Dotfuscator の MSBuild コンポーネントがインストールされるパス -->
        <DotfuscatorMSBuildDir>{install dir}/tools/msbuilddir</DotfuscatorMSBuildDir>
        <!-- Dotfuscator のライセンス文字列。 -->
        <DotfuscatorLicense>{license string}</DotfuscatorLicense>
    </PropertyGroup>
</Project>