Building Toy
This tutorial assumes you’re using git, GCC, and make.
To embed toy into your program, simply clone the git repository into a submodule - here we’ll assume you called it Toy
.
Toy’s makefile uses the variable TOY_OUTDIR
to define where the output of the build command will place the result. You MUST set this to a value, relative to the Toy directory.
export LIBDIR = lib
export TOY_OUTDIR = ../$(LIBDIR)
Next, you’ll want to run make the from within Toy’s source
, assuming the output directory has been created. There are two options for building Toy - library
(default) or static
; the former will create a shared library (and a .dll file on windows), while the latter will create a static library.
toy: $(LIBDIR)
$(MAKE) -C Toy/source
$(LIBDIR):
mkdir $(LIBDIR)
Finally, link to the outputted library, and specify the source directory to access the header files.
all: $(OBJ)
$(CC) $(CFLAGS) -o $(OUT) $(OBJ) -L../$(LIBDIR) $(LIBS)
Here’s a quick example makefile template you can use:
CC=gcc
export OUTDIR = out
export LIBDIR = lib
export TOY_OUTDIR = ../$(LIBDIR)
IDIR+=. ./Toy/source
CFLAGS+=$(addprefix -I,$(IDIR))
LIBS+=-ltoy
ODIR=obj
SRC=$(wildcard *.c)
OBJ=$(addprefix $(ODIR)/,$(SRC:.c=.o))
OUT=./$(OUTDIR)/program
all: toy $(OUTDIR) $(ODIR) $(OBJ)
$(CC) $(CFLAGS) -o $(OUT) $(OBJ) -L$(LIBDIR) $(LIBS)
cp $(LIBDIR)/*.dll $(OUTDIR) # for shared libraries
toy: $(LIBDIR)
$(MAKE) -C Toy/source
$(OUTDIR):
mkdir $(OUTDIR)
$(LIBDIR):
mkdir $(LIBDIR)
$(ODIR):
mkdir $(ODIR)
$(ODIR)/%.o: %.c
$(CC) -c -o $@ $< $(CFLAGS)