Visual Studio 2012でライブラリを追加・設定する方法を徹底解説

Visual Studio 2012で外部ライブラリをプロジェクトに組み込むには、大きく分けて2つの方法があります。1つ目はプロジェクトのプロパティから手動で設定する方法、2つ目はソースコード内でコンパイラディレクティブを使って指定する方法です。

ここでは、それぞれの手順を順番に詳しく見ていきましょう。

方法1：手動でライブラリを設定する（5つのステップ）

ライブラリを正しく認識させるには、以下の5つのステップを実行します。

ステップ1：必要なヘッダーファイルを#include文で読み込む

使用するライブラリの宣言が含まれるヘッダーファイルを、ソースコードの先頭でインクルードします。

#include "library.h"

ステップ2：インクルードディレクトリを追加する

コンパイラがヘッダーファイルを見つけられるよう、インクルードディレクトリのパスを登録します。

• [構成プロパティ] → [VC++ ディレクトリ] → [インクルードディレクトリ] を開く
• 「編集」をクリックし、新しいエントリとしてライブラリのヘッダーフォルダのパスを追加する

ステップ3：ライブラリディレクトリを追加する

*.lib ファイルが格納されているフォルダへのパスを設定します。

• 上部メニューの [プロジェクト] → [プロパティ] → [構成プロパティ] → [VC++ ディレクトリ] → [ライブラリディレクトリ] を開く
• 「編集」をクリックし、*.lib ファイルのあるフォルダのパスを新規追加する

ステップ4：*.lib ファイルをリンカーに登録する

実際にリンク対象となるライブラリファイルを指定します。

• [構成プロパティ] → [リンカー] → [入力] → [追加の依存ファイル] を開く
• 使用したい *.lib ファイル名を追記する

ステップ5：*.dll ファイルを適切な場所に配置する

動的リンクライブラリ（DLL）を使用する場合は、実行時にプログラムが参照できる場所へ配置する必要があります。

• 最終的な実行ファイル（.exe）と同じフォルダに置く
• または、Windows のシステムフォルダ（Windows/System32）に置く

※ 開発環境と実行環境が異なる場合、DLL の配置忘れは実行時エラーの典型的な原因となります。配布時には DLL を実行ファイルと一緒に同梱するのが安全です。

方法2：コードからライブラリを追加する

もう1つの方法は、ソースコード内で #pragma ディレクティブを使用するやり方です。この方法なら、リンカー設定を手動で変更することなく、*.lib ファイルを直接リンクできます。

#pragma comment(lib, "library.lib")

この1行をソースファイルに記述しておくだけで、ビルド時に自動的に指定したライブラリがリンクされます。小規模なプロジェクトや、特定のソースファイルでのみライブラリが必要な場合に便利です。

まとめ

Visual Studio 2012でのライブラリ追加は、「ヘッダーのインクルード」「ディレクトリ設定」「リンカー設定」「DLLの配置」という流れが基本です。設定漏れがあると「ファイルが開けません」や「未解決の外部シンボル」などのエラーが発生するため、上記の手順を一つずつ確認しながら進めるとトラブルを防げます。