Visual Studio で NuGet にあるパッケージを活用してアプリケーションを作成した場合、DLL ファイルを実行ファイル( EXE ファイル)があるフォルダに含める必要があります。
![](https://marunaka-blog.com/wp-content/uploads/2021/10/fcfe283063670f81af0f30d70ddca524-1.png)
DLL ファイルが含まれていないと、実行ファイルが起動しない・正常に動作しない等の不具合が発生する可能性があります。
不具合が発生しないようにアプリケーションをユーザーに配布する場合は、ファイルの数は少なくした方が好ましいでしょう。究極的には実行ファイル1つだけ配布したいものです。
Visual Studio の標準機能では、上記に記したことを実現できません。
そこで「Costura.Fody」を利用することで、アプリケーションを実行するのに必要な複数の DLL ファイルを1つの EXE ファイルにまとめることが可能になります。
\ Costura.Fodyサイトへ /
DLLをまとめる便利なライブラリ!!
本記事では Costura.Fody を用いて、DLL ファイルを実行ファイルに埋め込む方法を紹介します。
環境
項目 | 内容 |
---|---|
OS | Windows10 |
IDE | Visual Studio 2017 |
フレームワーク | .NET Framework 4.8 |
UIフレームワーク | WPFアプリ |
![](https://marunaka-blog.com/wp-content/uploads/2021/11/csharp-recommend-reference-book-5-300x168.webp)
オススメの参考書
C#の使い方が丁寧に解説しており、「基礎からしっかりと学びたい」という初心者の方にオススメの一冊です。サンプルコードも記載してあり、各章の最後に復習問題があるので理解度を確認しながら読み進めることができます。新しい C# のバージョンにも対応している書籍です。
Costura.Fodyのインストール
![](https://marunaka-blog.com/wp-content/uploads/2022/03/091184bcda645b76415dad025b422929.jpg)
Microsoft Visual Studio から任意のプロジェクトを開きます。
ソリューションエクスプローラーの中にあるプロジェクト名を選択して右クリックをすると、表示される項目の中にある「NuGetパッケージの管理(N)…」をクリックします。
NuGetパッケージマネージャーが開くので、検索欄に「Fody」と入力して検索します。検索結果一覧の中にある「Costura.Fody」を選択して、パッケージをインストールします。
![](https://marunaka-blog.com/wp-content/uploads/2021/10/da3e0af3a346acf8e96de4c2d93b7683-1-1024x698.png)
インストールする際、IDE(Visual Studio2017 もしくは Visual Studio2019)に応じてバージョンを選択する必要があります。
IDE | Costura.Fodyのバージョン |
---|---|
Visual Studio2017 | 3.3.3以下 |
Visual Studio2019 | 4.0.0以降 |
IDE によって MSBuild のバージョンが異なり、これが原因でビルドした時にエラーが発生します。
「Fody is only supported on MSBuild 16 and above.Current version: 15.」
「Fody は、MSBuild 16 以降でのみサポートされています。現在のバージョン:15。」
![](https://marunaka-blog.com/wp-content/uploads/2021/10/7f1a8effd12c0a17c62586947468a3af.png)
上図は Visual Studio 2017 で Costura.Fody のバージョン4.0.0以上をインストールした時のエラー写真です。
Costura.Fodyをインストールすると、依存関係にある「Fody」が自動的にインストールされます。
![](https://marunaka-blog.com/wp-content/uploads/2021/10/abc216aff05fa6111b2ca9c86634d99e-1024x705.png)
Costura.Fodyの使い方
![](https://marunaka-blog.com/wp-content/uploads/2022/03/2ba5cbb657d2e1599edd30d8fa258ed4-1024x358.jpg)
使い方はビルドするだけなのでとても簡単です。さっそくビルドしてみましょう。
下図は「Costura.Fody」を使用する前と使用した後を比較した画像です。使用後のフォルダにはDLLファイルがなくなっていることが分かります。
![](https://marunaka-blog.com/wp-content/uploads/2021/10/21a105ca2e9f3f62e6b752b481ee975a.png)
ファイルサイズも比較してみましょう。使用前と比較してファイルサイズが約4110KB程度増えています。これは DLL ファイルが実行ファイルに埋め込まれた為ですね。
![](https://marunaka-blog.com/wp-content/uploads/2021/10/c2d6d66da3cfa6dd009af950b3bea0c6.png)
オプション設定
Costura.Fody は特定の DLL ファイルを除外して、実行ファイルに埋め込みを行うことできます。上記に記載した設定を行うにはプロジェクトに「FodyWeavers.xml」という名前で新規のファイルを作成します。
![](https://marunaka-blog.com/wp-content/uploads/2021/10/00d6a15c9be48711f9924bd6bb747b52.png)
先ほど作成したファイルに以下のコードを記述します。このCosturaタブに追加したいオプションを記述します。
<?xml version="1.0" encoding="utf-8" ?>
<Weavers>
<Costura/>
</Weavers>
特定のDLLファイルを除外
例えば「NLog.dll」というファイルは埋め込みしたくない場合は、以下のように記述をします。
ここで注意しなければならないのは、除外したいDLLファイルの拡張子(.dll)をつけずにファイル名のみで指定する必要があります。
<?xml version="1.0" encoding="utf-8"?>
<Weavers>
<Costura>
<ExcludeAssemblies>
NLog
</ExcludeAssemblies>
</Costura>
</Weavers>
これを実行すると、先ほど除外した DLL ファイルだけ埋め込みされていないことが分かります。
![](https://marunaka-blog.com/wp-content/uploads/2021/10/c6a264e7379f44bd2bc48099622de674.png)
特定のDLLファイルを埋め込み
先ほどとは逆に「NLog.dll」というファイルは埋め込みたい場合は、以下のように記述をします。
同様に埋め込みたいDLLファイルの拡張子(.dll)をつけずにファイル名のみで指定する必要があります。
<?xml version="1.0" encoding="utf-8"?>
<Weavers>
<Costura>
<IncludeAssemblies>
NLog
</IncludeAssemblies>
</Costura>
</Weavers>
これを実行すると、先ほど指定したDLLファイルだけ埋め込みされていることが分かります。
![](https://marunaka-blog.com/wp-content/uploads/2021/10/5356e379d4998b07836c1e9d86cdf823.png)
まとめ
![](https://marunaka-blog.com/wp-content/uploads/2023/04/c35f903f10ed2371757ca77d9f41dce9-1024x358.png)
DLL ファイルを実行ファイルに埋め込む方法は、Microsoft が提供しているツール「ILMerge」でも実現することができます。ただ、ビルドイベントにコマンドを追加する必要があったりと手間がかかることがあります。
個人的には、Costura.Fody は ILMerge より使い勝手がいいと思うので、代替のパッケージとして利用することをおススメします。
![](https://marunaka-blog.com/wp-content/uploads/2022/11/csharp-visual-studio-2022-install-step-300x168.webp)
![](https://marunaka-blog.com/wp-content/uploads/2022/03/2f5a8ba6b1682610f773da3b2f1516f9-300x169.jpg)
![](https://marunaka-blog.com/wp-content/uploads/2022/09/1c0278efd52188a8154c18b8b21f1be2-300x169.jpg)
以上、最後まで読んでいただきありがとうございました。