Скопировано из вики-поста, который я написал для аспирантов по физике.
Так как это для unix, исполняемые файлы не имеют расширений.
Следует отметить, что root-config
- это утилита, которая обеспечивает правильные флаги компиляции и компоновки; и правильные библиотеки для создания приложений против root. Это просто деталь, относящаяся к исходной аудитории этого документа.
Make Me Baby
или ты никогда не забудешь первый раз, когда тебя сделали
Вводное обсуждение make и как написать простой make-файл
Что такое Марка? И почему я должен волноваться?
Инструмент под названием make является менеджером зависимостей сборки. Таким образом, он заботится о том, чтобы знать, какие команды необходимо выполнить и в каком порядке взять ваш программный проект из коллекции исходных файлов, объектных файлов, библиотек, заголовков и т. Д. И т. Д. - некоторые из которых могли недавно измениться --- и превращаем их в правильную актуальную версию программы.
На самом деле вы можете использовать make и для других вещей, но я не буду об этом говорить.
Тривиальный Makefile
Предположим, что у вас есть каталог, содержащий: tool
tool.cc
tool.o
support.cc
support.hh
и support.o
, которые зависят от root
и должны быть скомпилированы в программу с именем tool
и предположим, что вы взламывали исходные файлы (что означает, что существующий tool
устарел) и хотите скомпилировать программу.
Чтобы сделать это самостоятельно, вы могли бы
1) проверить, является ли support.cc
или support.hh
новее, чем support.o
, и, если это так, выполнить команду типа
g++ -g -c -pthread -I/sw/include/root support.cc
2) проверить, являются ли support.hh
или tool.cc
более новыми, чем tool.o
, и, если это так, выполнить команду типа
g++ -g -c -pthread -I/sw/include/root tool.cc
3) проверить, является ли tool.o
новее, чем tool
, и, если это так, выполнить команду типа
g++ -g tool.o support.o -L/sw/lib/root -lCore -lCint -lRIO -lNet -lHist -lGraf -lGraf3d -lGpad -lTree -lRint \
-lPostscript -lMatrix -lPhysics -lMathCore -lThread -lz -L/sw/lib -lfreetype -lz -Wl,-framework,CoreServices \
-Wl,-framework,ApplicationServices -pthread -Wl,-rpath,/sw/lib/root -lm -ldl
Уф! Что за хлопоты! Здесь есть что вспомнить и несколько шансов ошибиться. (Кстати, особенности представленных здесь командных строк зависят от нашей программной среды. Эти работают на моем компьютере.)
Конечно, вы можете просто запускать все три команды каждый раз. Это бы сработало, но плохо масштабируется до существенного программного обеспечения (такого как DOGS, которое компилируется с нуля на моем MacBook более 15 минут).
Вместо этого вы можете написать файл с именем makefile
, например:
tool: tool.o support.o
g++ -g -o tool tool.o support.o -L/sw/lib/root -lCore -lCint -lRIO -lNet -lHist -lGraf -lGraf3d -lGpad -lTree -lRint \
-lPostscript -lMatrix -lPhysics -lMathCore -lThread -lz -L/sw/lib -lfreetype -lz -Wl,-framework,CoreServices \
-Wl,-framework,ApplicationServices -pthread -Wl,-rpath,/sw/lib/root -lm -ldl
tool.o: tool.cc support.hh
g++ -g -c -pthread -I/sw/include/root tool.cc
support.o: support.hh support.cc
g++ -g -c -pthread -I/sw/include/root support.cc
и просто введите make
в командной строке. который автоматически выполнит три шага, показанных выше.
Здесь строки с отступом имеют вид "target: dependencies" и говорят make, что соответствующие команды (строки с отступом) должны выполняться, если какая-либо из зависимостей новее, чем цель. То есть строки зависимости описывают логику того, что нужно перестраивать, чтобы приспособить изменения в различных файлах. Если support.cc
изменяется, это означает, что support.o
необходимо перестроить, но tool.o
можно оставить в покое. Когда support.o
изменяется, tool
необходимо перестроить.
Команды, связанные с каждой строкой зависимостей, обозначены вкладкой (см. Ниже), которая должна изменить цель (или, по крайней мере, коснуться ее, чтобы обновить время модификации).
Переменные, встроенные правила и другие полезности
На этом этапе наш make-файл просто запоминает работу, которую нужно выполнить, но нам все еще приходилось разбираться и вводить все необходимые команды целиком. Так не должно быть: make - это мощный язык с переменными, функциями манипулирования текстом и целым рядом встроенных правил, которые могут сделать это для нас намного проще.
Сделать переменные
Синтаксис для доступа к переменной make: $(VAR)
.
Синтаксис для назначения переменной make: VAR = A text value of some kind
(или VAR := A different text value but ignore this for the moment
).
Вы можете использовать переменные в правилах, например, в этой улучшенной версии нашего make-файла:
CPPFLAGS=-g -pthread -I/sw/include/root
LDFLAGS=-g
LDLIBS=-L/sw/lib/root -lCore -lCint -lRIO -lNet -lHist -lGraf -lGraf3d -lGpad -lTree -lRint \
-lPostscript -lMatrix -lPhysics -lMathCore -lThread -lz -L/sw/lib -lfreetype -lz \
-Wl,-framework,CoreServices -Wl,-framework,ApplicationServices -pthread -Wl,-rpath,/sw/lib/root \
-lm -ldl
tool: tool.o support.o
g++ $(LDFLAGS) -o tool tool.o support.o $(LDLIBS)
tool.o: tool.cc support.hh
g++ $(CPPFLAGS) -c tool.cc
support.o: support.hh support.cc
g++ $(CPPFLAGS) -c support.cc
, который немного более читабелен, но все же требует много ввода
Создать функции
GNU make поддерживает множество функций для доступа к информации из файловой системы или другим командам в системе. В этом случае нас интересует $(shell ...)
, который расширяется до вывода аргумента (ов), и $(subst opat,npat,text)
, который заменяет все экземпляры opat
на npat
в тексте.
Воспользовавшись этим, мы получим:
CPPFLAGS=-g $(shell root-config --cflags)
LDFLAGS=-g $(shell root-config --ldflags)
LDLIBS=$(shell root-config --libs)
SRCS=tool.cc support.cc
OBJS=$(subst .cc,.o,$(SRCS))
tool: $(OBJS)
g++ $(LDFLAGS) -o tool $(OBJS) $(LDLIBS)
tool.o: tool.cc support.hh
g++ $(CPPFLAGS) -c tool.cc
support.o: support.hh support.cc
g++ $(CPPFLAGS) -c support.cc
, который легче набирать и гораздо удобнее читать.
Обратите внимание, что
- Мы все еще явно указываем зависимости для каждого объектного файла и конечного исполняемого файла
- Нам пришлось явно ввести правило компиляции для обоих исходных файлов
Неявные и шаблонные правила
Как правило, мы ожидаем, что все исходные файлы c ++ должны обрабатываться одинаково, и make предоставляет три способа указать это
- суффиксные правила (считаются устаревшими в GNU make, но сохраняются для обратной совместимости)
- неявные правила
- шаблон правил
Неявные правила встроены, и некоторые из них будут обсуждаться ниже. Правила шаблонов указываются в виде, подобном
%.o: %.c
$(CC) $(CFLAGS) $(CPPFLAGS) -c $<
, что означает, что объектные файлы генерируются из исходных файлов c с помощью показанной команды, где «автоматическая» переменная $<
расширяется до имени первой зависимости.
Встроенные правила
Make имеет целый набор встроенных правил, которые означают, что очень часто проект может быть скомпилирован очень простым make-файлом.
В GNU make встроено правило для исходных файлов c, представленное выше. Точно так же мы создаем объектные файлы из исходных файлов c ++ с правилом вроде $(CXX) -c $(CPPFLAGS) $(CFLAGS)
Отдельные объектные файлы связаны с помощью $(LD) $(LDFLAGS) n.o $(LOADLIBES) $(LDLIBS)
, но в нашем случае это не сработает, потому что мы хотим связать несколько объектных файлов.
Переменные, используемые встроенными правилами
Встроенные правила используют набор стандартных переменных, которые позволяют вам указывать информацию о локальной среде (например, где искать включаемые файлы ROOT) без переписывания всех правил. Наиболее вероятными для нас являются:
CC
- компилятор c для использования
CXX
- компилятор c ++ для использования
LD
- компоновщик для использования
CFLAGS
- флаг компиляции для исходных файлов c
CXXFLAGS
- флаги компиляции для исходных файлов c ++
CPPFLAGS
- флаги для препроцессора c (обычно включают пути к файлам и символы, определенные в командной строке), используемые c и c ++
LDFLAGS
- флаги компоновщика
LDLIBS
- библиотеки для ссылки
Основной Makefile
Используя преимущества встроенных правил, мы можем упростить наш make-файл до:
CC=gcc
CXX=g++
RM=rm -f
CPPFLAGS=-g $(shell root-config --cflags)
LDFLAGS=-g $(shell root-config --ldflags)
LDLIBS=$(shell root-config --libs)
SRCS=tool.cc support.cc
OBJS=$(subst .cc,.o,$(SRCS))
all: tool
tool: $(OBJS)
$(CXX) $(LDFLAGS) -o tool $(OBJS) $(LDLIBS)
tool.o: tool.cc support.hh
support.o: support.hh support.cc
clean:
$(RM) $(OBJS)
distclean: clean
$(RM) tool
Мы также добавили несколько стандартных целей, которые выполняют специальные действия (например, очистка исходного каталога).
Обратите внимание, что когда make вызывается без аргумента, он использует первую цель, найденную в файле (в данном случае все), но вы также можете назвать цель для получения, которая заставляет make clean
удалять объектные файлы в это дело.
У нас все еще есть жестко запрограммированные зависимости.
Некоторые загадочные улучшения
CC=gcc
CXX=g++
RM=rm -f
CPPFLAGS=-g $(shell root-config --cflags)
LDFLAGS=-g $(shell root-config --ldflags)
LDLIBS=$(shell root-config --libs)
SRCS=tool.cc support.cc
OBJS=$(subst .cc,.o,$(SRCS))
all: tool
tool: $(OBJS)
$(CXX) $(LDFLAGS) -o tool $(OBJS) $(LDLIBS)
depend: .depend
.depend: $(SRCS)
$(RM) ./.depend
$(CXX) $(CPPFLAGS) -MM $^>>./.depend;
clean:
$(RM) $(OBJS)
distclean: clean
$(RM) *~ .depend
include .depend
Обратите внимание, что
- Больше нет строк зависимостей для исходных файлов!?!
- Есть какая-то странная магия, связанная с .depend и зависимость
- Если вы сделаете
make
, то ls -A
вы увидите файл с именем .depend
, который содержит вещи, которые выглядят как линии создания зависимости
Другое чтение
Знайте ошибки и исторические заметки
Язык ввода для make чувствителен к пробелам. В частности строки действий, следующие за зависимостями, должны начинаться с вкладки . Но ряд пробелов может выглядеть одинаково (и действительно есть редакторы, которые будут молча преобразовывать вкладки в пробелы или наоборот), в результате чего файл make выглядит правильно и все еще не работает. Это было определено как ошибка на ранней стадии, но ( история идет ) не было исправлено, потому что уже было 10 пользователей.