チュートリアル: スタティックライブラリを作成して使用する

[アーティクル]
02/28/2022

このチュートリアルでは、C++ アプリケーションに使用するスタティックライブラリ (.lib ファイル) を作成する方法について説明します。スタティックライブラリを使用すると、コードを有効に再利用できます。機能を必要とするアプリケーションごとに同じルーチンを再実装するのではなく、ルーチンを 1 度スタティックライブラリに記述しておき、アプリからそれを参照します。スタティックライブラリからリンクされたコードは、アプリの一部になります。コードを使用するために別の — ファイルをインストールする必要はありません。

このチュートリアルでは、次の作業について説明します。

スタティックライブラリプロジェクトを作成する
スタティックライブラリにクラスを追加する
スタティックライブラリを参照する C++ コンソールアプリを作成する
アプリ内でスタティックライブラリの機能を使用する
アプリを実行する

必須コンポーネント

C++ 言語の基本の理解。

スタティックライブラリプロジェクトを作成する

プロジェクトを作成する手順は、お使いの Visual Studio のバージョンによって異なります。優先するバージョンの Visual Studio のドキュメントを表示するには、 [バージョン] セレクターコントロールを使用します。このページの目次の一番上にあります。

Visual Studio でスタティックライブラリプロジェクトを作成するには

メニューバーで[ファイル] [新しいファイル]Projectクリックして、[新しいファイルの作成] ダイアログ Project開きます。
ダイアログの上部で、[言語]を[C++]に設定し、[プラットフォーム] を [Windows] に設定しProjectを [ライブラリ] に設定します。
フィルター処理されたプロジェクトタイプの一覧から、 [Windows デスクトップウィザード] を選択して、 [次へ] を選択します。
[新しいプロジェクトの構成] ページで、 [プロジェクト名] ボックスに「MathLibrary」と入力して、プロジェクトの名前を指定します。 [ソリューション名] ボックスに「StaticMath」と入力します。 [作成] ボタンを選択して、 [Windows デスクトッププロジェクト] ダイアログを開きます。
[Windows デスクトッププロジェクト] ダイアログの [アプリケーションの種類] の下で、 [スタティックライブラリ (.lib)] を選択します。
[追加オプション] で、 [プリコンパイル済みヘッダー] チェックボックスがオンになっている場合は、オフにします。 [空のプロジェクト] ボックスをオンにします。
[OK] を選択して、プロジェクトを作成します。

Visual Studio 2017 でスタティックライブラリプロジェクトを作成するには

メニューバーで、[ファイル][新規作成][プロジェクト] の順に選択します。
[新しいデスクトップProject]ダイアログボックスで、 [デスクトップにインストールVisual C++Windows選択します。中央のウィンドウで、 [Windows デスクトップウィザード] を選択します。
[名前] ボックスに、プロジェクトの名前 ——— など) を—します。ソリューションの名前 ([ソリューション名] ボックスに ————します。 [OK] を選択します。
[Windows デスクトッププロジェクト] ダイアログの [アプリケーションの種類] の下で、 [スタティックライブラリ (.lib)] を選択します。
[追加オプション] で、 [プリコンパイル済みヘッダー] チェックボックスがオンになっている場合は、オフにします。 [空のプロジェクト] ボックスをオンにします。
[OK] を選択して、プロジェクトを作成します。

Visual Studio 2015 でスタティックライブラリプロジェクトを作成するには

メニューバーで、[ファイル][新規作成][プロジェクト] の順に選択します。
[新しいテンプレートのProject]ダイアログボックスで、Win32 のインストール済み テンプレートVisual C++選択します。中央のウィンドウで [Win32 コンソールアプリケーション] をクリックします。
[名前] ボックスに、プロジェクトの名前 ——— など) を—します。ソリューションの名前 ([ソリューション名] ボックスに ————します。 [OK] を選択します。
[Win32 アプリケーションウィザード] で、 [次へ] を選択します。
[アプリケーションの設定] ページの [アプリケーションの種類] で、 [スタティックライブラリ] を選択します。 [追加オプション] で、 [プリコンパイル済みヘッダー] チェックボックスをオフにします。 [完了] を選択して、プロジェクトを作成します。

スタティックライブラリにクラスを追加する

スタティックライブラリにクラスを追加するには

新しいクラスのヘッダーファイルを作成するには、右クリックしてソリューションエクスプローラーでMathLibraryプロジェクトのショートカットメニューを開き、[新しい項目の追加] を選択します。
[新しい項目の追加] ダイアログボックスで、[コード] Visual C++選択します。中央のウィンドウで、 [ヘッダーファイル (.h)] をクリックします。ヘッダーファイルの名前 ——など) を指定し、[ — 追加] ボタン—します。ほとんど空白のヘッダーファイルが表示されます。

加算、減算、乗算、除算などの一般的な数値演算を行うための、Arithmetic という名前のクラスの宣言を追加します。コードは次のようになります。

// MathLibrary.h
#pragma once

namespace MathLibrary
{
    class Arithmetic
    {
    public:
        // Returns a + b
        static double Add(double a, double b);

        // Returns a - b
        static double Subtract(double a, double b);

        // Returns a * b
        static double Multiply(double a, double b);

        // Returns a / b
        static double Divide(double a, double b);
    };
}

新しいクラスのソースファイルを作成するには、のMathLibraryプロジェクトのショートカットメニューをソリューションエクスプローラー開き、 [新しい項目の追加] を選択します。
[新しい項目の追加] ダイアログボックスの中央のペインで、 [C++ ファイル (.cpp)] を選択します。ソースファイルの名前 ——など) を指定し、[ — 追加] ボタン—します。空白のソースファイルが表示されます。

このソースファイルを使って、Arithmetic クラスの機能を実装します。コードは次のようになります。

// MathLibrary.cpp
// compile with: cl /c /EHsc MathLibrary.cpp
// post-build command: lib MathLibrary.obj

#include "MathLibrary.h"

namespace MathLibrary
{
    double Arithmetic::Add(double a, double b)
    {
        return a + b;
    }

    double Arithmetic::Subtract(double a, double b)
    {
        return a - b;
    }

    double Arithmetic::Multiply(double a, double b)
    {
        return a * b;
    }

    double Arithmetic::Divide(double a, double b)
    {
        return a / b;
    }
}

スタティックライブラリをビルドするには、メニューバーの [ビルドソリューションのビルド] を選択します。ビルドを行うと、他のプログラムで使用できるスタティックライブラリ MathLibrary.lib が作成されます。

注意

プログラムを Visual Studio のコマンドラインからビルドする場合、2 つの処理によってビルドする必要があります。最初に、 cl /c /EHsc MathLibrary.cpp を実行してコードをコンパイルし cl /c /EHsc MathLibrary.cppという名前のオブジェクトファイルを作成します。(この cl コマンドはコンパイラを呼び出Cl.exe、オプションはリンクせずに /c コンパイルを指定します。詳細については、「/c (リンクなしでコンパイルする)」を参照してください。次に、 lib MathLibrary.obj を実行してコードをリンクし、スタティックライブラリ lib MathLibrary.obj。 (lib コマンドは、Lib.exe ライブラリマネージャーを起動します。詳細については、「 LIB Reference」を参照してください)。

スタティックライブラリを参照する C++ コンソールアプリを作成する

Visual Studio でスタティックライブラリを参照する C++ コンソールアプリを作成するには

ソリューションエクスプローラーで、最上位ノードであるソリューション 'StaticMath' を右クリックし、ショートカットメニューを開きます。 [Add New Project]を選択して、[Add a New Project]を開きます。
ダイアログの上部で、 [プロジェクトタイプ] フィルターを [コンソール] に設定します。
フィルター処理されたプロジェクトタイプの一覧から、 [コンソールアプリ] を選択して、 [次へ] を選択します。次のページで、 [名前] ボックスに「MathClient」と入力してプロジェクトの名前を指定します。
[作成] ボタンを選択してクライアントプロジェクトを作成します。
コンソールアプリケーションを作成すると、空のプログラムが作成されます。ソースファイルの名前は、前の処理で付けた名前と同じになります。この例では、それには MathClient.cpp という名前が付いています。

Visual Studio 2017 でスタティックライブラリを参照する C++ コンソールアプリを作成するには

ソリューションエクスプローラーで、最上位ノードであるソリューション 'StaticMath' を右クリックし、ショートカットメニューを開きます。 [Add New Project]を選択して、[Adda New Project]ダイアログボックスを開きます。
[新しいパッケージの追加Project]ダイアログボックスで、 [デスクトップにインストールVisual C++Windows選択します。中央のウィンドウで、 [Windows デスクトップウィザード] を選択します。
[名前] ボックスに、プロジェクトの名前 ——— など)—します。 [OK] を選択します。
[Windows デスクトッププロジェクト] ダイアログの [アプリケーションの種類] の下で、 [コンソールアプリケーション (.exe)] を選択します。
[追加オプション] で、 [プリコンパイル済みヘッダー] チェックボックスがオンになっている場合は、オフにします。
[OK] を選択して、プロジェクトを作成します。
コンソールアプリケーションを作成すると、空のプログラムが作成されます。ソースファイルの名前は、前の処理で付けた名前と同じになります。この例では、それには MathClient.cpp という名前が付いています。

Visual Studio 2015 でスタティックライブラリを参照する C++ コンソールアプリを作成するには

ソリューションエクスプローラーで、最上位ノードであるソリューション 'StaticMath' を右クリックし、ショートカットメニューを開きます。 [Add New Project]を選択して、[Adda New Project]ダイアログボックスを開きます。
[新しいファイルの追加Project]ダイアログボックスで、Win32 の [ インストール済みVisual C++選択します。中央のウィンドウで [Win32 コンソールアプリケーション] をクリックします。
[名前] ボックスに、プロジェクトの名前 ——— など)—します。 [OK] を選択します。
[Win32 アプリケーションウィザード] ダイアログで、 [次へ] を選択します。
[アプリケーションの設定] ページの [アプリケーションの種類] で、 [コンソールアプリケーション] が選択されていることを確認します。 [追加オプション] で、 [プリコンパイル済みヘッダー] をオフにしてから、 [空のプロジェクト] チェックボックスをオンにします。 [完了] を選択して、プロジェクトを作成します。
空のプロジェクトにソースファイルを追加するには、右クリックしてソリューションエクスプローラーでMathClientプロジェクトのショートカットメニューを開き、 [新しい項目の追加] を選択します。
[新しい項目の追加] ダイアログボックスで、[コード] Visual C++選択します。中央のウィンドウで、 [C++ ファイル (.cpp)] をクリックします。ソースファイルの名前 ——など) を指定し、[ — 追加] ボタン—します。空白のソースファイルが表示されます。

アプリ内でスタティックライブラリの機能を使用する

アプリケーションでのスタティックライブラリの機能を使用するには

スタティックライブラリの数値演算ルーチンを使用するには、それを参照する必要があります。のMathClientプロジェクトのショートカットメニューを開ソリューションエクスプローラー参照の追加]を選択します。
[参照の追加] ダイアログボックスには、参照できるライブラリが表示されます。 [プロジェクト] タブでは、現在のソリューション内のプロジェクトと、それらによって参照されるすべてのライブラリが一覧表示されます。 [プロジェクト] タブを開き、MathLibrary のチェックボックスをオンにし、 [OK] ボタンを選択します。
MathLibrary.h ヘッダーファイルを参照するには、含まれるディレクトリパスを変更する必要があります。 ソリューションエクスプローラーで MathClient を右クリックし、ショートカットメニューを開きます。 [プロパティ] を選択して、 [MathClient プロパティページ] ダイアログボックスを開きます。
[MathClient プロパティページ] ダイアログボックスで、 [構成] ドロップダウンを [すべての構成] に設定します。 [プラットフォーム] ドロップダウンを [すべてのプラットフォーム] に設定します。
[構成プロパティ][C/C++ 全般]プロパティページを選択します。 [追加のインクルードディレクトリ] プロパティで、MathLibrary ディレクトリへのパスを指定するか、参照します。

ディレクトリパスを参照するには、次のようにします。
1. [追加のインクルードディレクトリ] プロパティ値のドロップダウンリストを開き、 [編集] を選択します。
2. [追加のインクルードディレクトリ] ダイアログボックスで、テキストボックスの上部をダブルクリックします。次に、行の末尾にある省略記号ボタン ( [...] ) を選択します。
3. [ディレクトリの選択] ダイアログボックスで、1 レベル上に移動し、MathLibrary ディレクトリを選択します。次に、 [フォルダーの選択] ボタンを選択して、選択内容を保存します。
4. [追加のインクルードディレクトリ] ダイアログボックスで、 [OK] ボタンを選択します。
5. [プロパティページ] ダイアログボックスで、 [OK] ボタンを選択してプロジェクトへの変更を保存します。

これで、コードに #include "MathLibrary.h" ヘッダーを含めることによって、このアプリで Arithmetic クラスを使用できるようになりました。 MathClient.cpp の内容を次のコードに置き換えます。

// MathClient.cpp
// compile with: cl /EHsc MathClient.cpp /link MathLibrary.lib

#include <iostream>
#include "MathLibrary.h"

int main()
{
    double a = 7.4;
    int b = 99;

    std::cout << "a + b = " <<
        MathLibrary::Arithmetic::Add(a, b) << std::endl;
    std::cout << "a - b = " <<
        MathLibrary::Arithmetic::Subtract(a, b) << std::endl;
    std::cout << "a * b = " <<
        MathLibrary::Arithmetic::Multiply(a, b) << std::endl;
    std::cout << "a / b = " <<
        MathLibrary::Arithmetic::Divide(a, b) << std::endl;

    return 0;
}

実行可能ファイルをビルドするには、メニューバーの [ビルドソリューションのビルド] を選択します。

アプリを実行する

アプリケーションを実行するには

MathClient が既定のプロジェクトとして選択されていることを確認します。これを選択するには、ソリューションエクスプローラーで MathClient を右クリックしてショートカットメニューを開き、 [スタートアッププロジェクトに設定] を選択します。
プロジェクトを実行するには、メニューバーで [デバッグ][デバッグなしで開始] の順にクリックします。出力は次のようになります。
```
a + b = 106.4
a - b = -91.6
a * b = 732.6
a / b = 0.0747475
```

チュートリアル: スタティック ライブラリを作成して使用する

必須コンポーネント

スタティック ライブラリ プロジェクトを作成する

Visual Studio でスタティック ライブラリ プロジェクトを作成するには

Visual Studio 2017 でスタティック ライブラリ プロジェクトを作成するには

Visual Studio 2015 でスタティック ライブラリ プロジェクトを作成するには

スタティック ライブラリにクラスを追加する

スタティック ライブラリにクラスを追加するには

スタティック ライブラリを参照する C++ コンソール アプリを作成する

Visual Studio でスタティック ライブラリを参照する C++ コンソール アプリを作成するには

Visual Studio 2017 でスタティック ライブラリを参照する C++ コンソール アプリを作成するには

Visual Studio 2015 でスタティック ライブラリを参照する C++ コンソール アプリを作成するには

アプリ内でスタティック ライブラリの機能を使用する

アプリケーションでのスタティック ライブラリの機能を使用するには