Dotfuscator Professional のインストール

この記事を使用して、開発用コンピューターまたはビルド環境に Dotfuscator Professional をインストールします。

Dotfuscator Professional は 2 つのインストール方法をサポートしています。

• Windows 環境：Windows インストーラー。
• Mac または Linux：NuGet パッケージ。 

選択するインストール方法は、オペレーティング システム、開発環境、ワークフローによって異なります。

Dotfuscator Professional をインストールする前に、次のことを行います。

1. お使いのアプリケーション フレームワークと開発ツールがサポートされていることを確認する。
2. Dotfuscator を実行するコンピューターがシステム要件を満たしていることを確認する。

詳細については、サポートされているフレームワークと開発ツールおよびシステム要件を参照してください。

インストール方法の選択

Windows インストーラーを使用したインストール

Windows インストーラーは、Dotfuscator Professional を Windows にインストールするもので、Dotfuscator 構成エディターが含まれています。

Windows インストーラーを使用して Dotfuscator Professional をインストールするには、以下の手順を実行します。

1. Dotfuscator ダウンロード ページに移動します。
2. Dotfuscator Professional インストーラーをダウンロードします。
3. 開発用コンピューター上で、管理者権限でインストーラーを実行します。
4. 「使用許諾契約書」セクションの条項を確認して同意します。
5. インストールの種類を選択します。
   • すべての機能をインストールするには、［完全］インストールを選択します。

   • 特定の機能のみを選択します。

     メモ：部分的なインストールを選択する場合は、［MSBuild コンポーネント］機能を有効にしてください。ほとんどのプロジェクトが、Dotfuscator を使用するときに MSBuild コンポーネントも使用します。

6. 続行して［インストール］を選択します。
7. インストールが完了するまで待ちます。
8. ［完了］を選択してインストール ウィザードを閉じます。

コンピューター上の Dotfuscator がまだアクティブ化されていない場合は、アクティブ化ツールが自動的に起動します。 

インストール後、Dotfuscator Professional はローカル コンピューターで使用可能になり、サポートされている Visual Studio プロジェクトやビルド プロセスと統合することができます。

詳細については、アクティブ化を参照してください。 

インストールされるコンポーネント

Windows インストーラーは以下のコンポーネントを配置します。

ここで、

• $(MSBuildProgramFiles32) は予約済みの MSBuild プロパティで、Windows の C:\Program Files (x86) ディレクトリ（64 ビット版）および C:\Program Files ディレクトリ（32 ビット版）を指します。
• {app dir} は、Dotfuscator Professional をインストールするディレクトリです。

詳細については、予約済みおよび既知のプロパティを参照してください。

DOTFUSCATOR_HOME 変数

Windows インストーラーは、システム環境変数 DOTFUSCATOR_HOME を追加します。この変数には、Dotfuscator のインストール ディレクトリが含まれています。

また、インストーラーは、PATH 変数が長すぎる場合を除き、%DOTFUSCATOR_HOME% を PATH 環境変数に追加します。インストール中にこの状況に該当する場合は、PATH 変数の長さを短くしてから、手動で %Dotfuscator_home% を追加します。

サイド バイ サイド インストールの場合、Dotfuscator_home は最後にインストールされた Dotfuscator バージョンを参照します。インストールされている別のバージョンを使用するには、そのバージョンのインストール ディレクトリを指すようにシステム環境変数を更新します。

Dotfuscator をアンインストールすると、インストーラーは DOTFUSCATOR_HOME 変数を削除し、そのパスがアンインストール対象のバージョンと一致する場合にのみ、それを PATH から削除します。ほかにもインストールされている Dotfuscator のバージョンがある場合は、使用するバージョンを指すように DOTFUSCATOR_HOME を再設定します。

NuGet パッケージを使用したインストール

PreEmptive は、macOS および Linux の開発用コンピューターに Dotfuscator Professional をインストールするための NuGet パッケージをプライベートで配布しています。

この方法は Windows の開発環境に対しても使用できますが、Windows 開発用コンピューターでは通常、Windows インストーラーをお勧めします。

NuGet パッケージについて

Dotfuscator NuGet パッケージの動作は、一般的なプロジェクトの依存関係とは異なります。Dotfuscator NuGet パッケージの主な特徴は以下のとおりです。

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

パッケージ識別子

NuGet パッケージのインストール

パッケージをインストールするには、次のいずれかを実行します。

• NuGet コマンドライン インターフェイス、nuget.exe
• ZIP ファイルを展開できるあらゆるツール
• NuGet 復元

ビルド プロセスからアクセス可能なローカル ディレクトリにパッケージをインストールします。

1. Dotfuscator ダウンロード ページに移動します。
2. Dotfuscator Professional の NuGet パッケージをダウンロードします。
3. ダウンロードした .nupkg を新しいディレクトリにコピーします。
4. このディレクトリのパスを {feed url} として書き留めておきます。

5. パッケージを開発用コンピューターにプロビジョニングします。

   nuget.exe のインストール

   install コマンドを使用してパッケージをダウンロードし、特定のディレクトリ {out dir} に展開します。たとえば、次のコマンドを実行すると、Dotfuscator Professional バージョン 7.1.4が {out dir}/PreEmptive.Protection.Dotfuscator.Pro にインストールされます。

   nuget install PreEmptive.Protection.Dotfuscator.Pro -Version 7.1.4 -OutputDirectory 

   "{out dir}" -ExcludeVersion -Source "{feed url}"

   評価ライセンスの場合は、次のコマンドを使用します。

   nuget install PreEmptive.Protection.Dotfuscator.Pro.Eval -Version 7.1.4 

   -OutputDirectory "{out dir}" -ExcludeVersion -Source "{feed url}"

   メモ：install コマンドを使用するときは、正しい Dotfuscator Professional バージョンを指定していることを確認してください。

   詳細については、NuGet CLI リファレンスを参照してください。

   ZIP ファイルの展開

   NuGet パッケージ（.nupkg）ファイルは、実際には名前を変更した ZIP ファイルです。

   1. .nupkg ファイルを、拡張子 .zip を付けた新しいファイル名でコピーします。
   2. そのコピーを新しいディレクトリに解凍します。
   3. 解凍されたコンテンツのディレクトリを書き留めます。これがインストール ディレクトリです。  

   メモ：NuGet パッケージが組織内のアーティファクト リポジトリにホストされている場合は、リポジトリのドキュメントを参照して .nupkg ファイルをダウンロードしてください。

   NuGet 復元

   1. Dotfuscator NuGet パッケージを参照する、シンプルな「スタブ」.NET プロジェクトを作成します。
   2. >nuget restore コマンドを使用してパッケージをプロビジョニングします。
6. スクリプトの場所を引数として含め、chmod +x コマンドを使用して、含まれているシェル スクリプトを実行可能としてマークします。
7. ユーザー ディレクトリにファイルを作成し、.dotfuscator.user.props という名前を付けます。
8. 新しいファイルに次の内容を含めます。

<!-- これは 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>

ここで、 
 
{install dir} は、Dotfuscator インストール ディレクトリの絶対パスです。 
{license string} は、ライセンス文字列形式の Dotfuscator Professional ライセンス キーです。これにより、Dotfuscator のビルド統合は、実行するたびに自動的に自身をアクティブ化するようになります。

インストール後、Dotfuscator Professional がローカル コンピューターで使用可能になります。

メモ：Ubuntu 22 で Dotfuscator を使用してアプリケーションをビルドすると、System.attributeTargets.System.Runtime エラーが発生することがあります。このエラーの詳細と修正方法については、トラブルシューティングを参照してください。

インストールされるコンポーネント

Dotfuscator の NuGet パッケージには以下のコンポーネントが含まれています。

{install dir} は Dotfuscator のインストール ディレクトリです。

次のステップ

Dotfuscator Professional をインストールした後、次のことを行います。

1. ライセンスをアクティブ化する。
2. Dotfuscator がアプリを保護する方法を理解する。
3. 最初のアプリケーションを保護する
   • 構成エディターを使用
   • MSBuild を使用
   • コマンド ライン インターフェイスを使用
4. 利用可能な強化された保護機能を確認する。

関連記事

• システム要件
• サポートされているフレームワークと開発ツール
• アクティブ化
• MSBuild
• コマンド ライン インターフェイス
• 構成エディター
• 難読化属性リファレンス
• ［PreMark］エディター
• 改ざんチェック