d94538e1bb
Phony target 'pre' forces rebuilds. This should not be default behavior of Makefile.pdlibbuilder. If one needs a pre-build target (phony or real file), declare it as prerequisite of $(all.objects) in the library makefile after inclusion of Makefile.pdlibbuilder. A pre-build target can have any name that isn't a target in Makefile.pdlibbuilder. |
||
|---|---|---|
| Makefile.pdlibbuilder | ||
| README.md | ||
Makefile.pdlibbuilder
Helper makefile for Pure Data external libraries. Written by Katja Vetter March-June 2015 for the public domain. No warranties. Inspired by Hans Christoph Steiner's Makefile Template and Stephan Beal's ShakeNMake.
GNU make version >= 3.81 required.
characteristics
- defines build settings based on autodetected OS and architecture
- defines rules to build Pd class- or lib executables from C or C++ sources
- defines rules for libdir installation
- defines convenience targets for developer and user
- evaluates implicit dependencies for non-clean builds
basic usage
In your Makefile, define your Pd lib name and class files, and include Makefile.pdlibbuilder at the end of the Makefile. Like so:
# Makefile for mylib
lib.name = mylib
class.sources = myclass1.c myclass2.c
datafiles = myclass1-help.pd myclass2-help.pd README.txt LICENSE.txt
include Makefile.pdlibbuilder
For files in class.sources it is assumed that class name == source file basename. The default target builds all classes as individual executables with Pd's default extension for the platform. For anything more than the most basic usage, read the documentation sections in Makefile.pdlibbuilder.
examples
Here are three projects using the Makefile.pdlibbuilder approach:
https://github.com/pure-data/helloworld
https://github.com/electrickery/pd-cyclone
https://github.com/pure-data/xeq
More examples will be referenced here when they are available.