[C言語] Makefileの書き方その1(基礎編)

はじめに

今回の記事は、テーマにもある通りC言語で作成したプログラムをコンパイル、ビルドする時に使用するMakefileについてのメモ書きです。

以下に該当する人は是非読んで見てね

Makefileってなに？

まずは、Makefileとは？というところから。
もちろんそんなことは知ってますという人は読み飛ばして下さい。

manコマンドを使って確認した内容を一部抜粋します。

To prepare to use make,
you must write a file called the makefile that describes the relationships among files in your program,
and the states the commands for updating each file.

man makeコマンドのドキュメントから抜粋

引用した文章によると、Makefileはmakeコマンドを利用する時に使われるファイルとのこと。
そのMakefileの中身に何を記載するのかというと、利用する各ファイルの関係性やファイルを更新するためのルール的なものを記載するものと書かれています。

結局Makefikeって…

Makefileを使ってC言語のプログラムをコンパイル＆ビルド

さっそく、C言語のプログラムをgccを使ってコンパイル＆ビルドする時のMakefileについて確認していきます。

想定しているディレクトリ構造

まずは、今回想定しているディレクトリ構造から。
中間ファイルや実行ファイルの出力先、ソースコードの置き場所など以下のように考えています。

次からMakefileの書き方を確認していきます。

簡単なmain.cファイルだけでビルドする

まずは、何も考えずにmain.cファイルだけをコンパイル＆ビルドする方法から。
なるべく不要なものを記述しないようにします。

まずは、bin,inlucde,lib,obj,srcディレクトリを作成して、
srcフォルダの直下にmain.cファイルを作成してみよう。

main.cファイルを作成したら、お決まりの「hello world」を返すプログラムを記述

#include <stdio.h>

int main() {
    printf("hello World\n");
    return 0;
}

次にsrcフォルダの直下にMakefileを作成

記述するMakefileはなるべく不要なものは記述しないようします。

CC 				= gcc
CFLAGS 			= -g -Wall -O2
INCLUDE			= -I ../include
TARGET			= ../bin/hello
OBJDIR			= ../obj

SOURCE			= main.c

OBJECTS 		= $(addprefix $(OBJDIR)/, $(SOURCE:.c=.o))

$(TARGET)		: $(OBJECTS)
	mkdir -p $(dir $@)
	$(CC) $^ -o $(TARGET)

$(OBJDIR)/%.o	: %.c
	mkdir -p $(dir $@)
	$(CC) $(CFLAGS) $(INCLUDE) -o $@ -c $<

all				: $(TARGET)

clean			:
	rm -rf $(OBJECTS) $(TARGET)

基本的なことは既に紹介されている記事もあるので触れませんが、記号であったり使用している関数については少しだけ解説を加えておきます。

これで、あとはmakeコマンドを使うだけ。

srcディレクトリで「make all」と入力すれば、
中間ディレクトリであるobjディレクトリにmain.oファイルが作成され、binディレクトリには実行ファイルであるhelloファイルが作成されるはずです。
あとは、binディレクトリにあるhelloでプログラムを実行できるはずです。

「make clean」と入力すれば自動で作成された実行ファイルや中間ファイルを削除できます。

もちろん、mainファイルだけであればわざわざ手間をかけてMakefileなんて用意する必要ないんですけどね…

まとめ

これで、基本的なMakefileの書き方はメモできました。
もちろん、実際に使用するときにはもっとたくさんのことを記述する必要があります。

• 他のソースファイルやヘッダファイルを追加する場合
• ライブラリをリンクする場合

それたについてもいずれまとめたいと思ったのですが、想定していたより長くなったのでとりあえずここまで。

追記：以下のページ追記しました。

[C言語] Makefileの書き方その2(応用)

はじめに 今回の記事では、Makefileの書き方について紹介していきます。以前にMakefileの基本的な話は忘れないようにメモ書きしたので、次はもう少し実践的な使い方について確認しておきます。 以前に、Makefileの基本について書き...

myhobbybook.net

2024.06.12