Prerequisites

(These are prerequisites to build NDN-CPP. To do development of NDN-CPP code and update the build system, see Development Prerequisites.)

Required: libcrypto
Optional: libsqlite3 (for key storage)
Optional: OSX Security framework (for key storage)
Optional: Protobuf (for the ProtobufTlv converter and ChronoSync)
Optional: log4cxx (for debugging and log output)
Optional: Doxygen (to make documentation)

Following are the detailed steps for each platform to install the prerequisites.

OS X 10.8.4

Install Xcode. In Xcode Preferences > Downloads, install "Command Line Tools".

Optional: To install Protobuf, install MacPorts from http://www.macports.org/install.php . In a new terminal, enter:

sudo port install protobuf-cpp

Optional: To install log4cxx, install MacPorts from http://www.macports.org/install.php . In a new terminal, enter:

sudo port install log4cxx

Optional: To install Doxygen, install MacPorts from http://www.macports.org/install.php . In a new terminal, enter:

sudo port install doxygen

OS X 10.9.5, OS X 10.10.2

Install Xcode. (Xcode seems to already have the Command Line Tools.)

Optional: To install Protobuf, install MacPorts from http://www.macports.org/install.php . In a new terminal, enter:

sudo port install protobuf-cpp

Optional: To install log4cxx, install MacPorts from http://www.macports.org/install.php . In a new terminal, enter:

sudo port install log4cxx

Optional: To install Doxygen, install MacPorts from http://www.macports.org/install.php . In a new terminal, enter:

sudo port install doxygen

Ubuntu 12.04 (64 bit and 32 bit), Ubuntu 14.04 (64 bit and 32 bit)

In a terminal, enter:

sudo apt-get install build-essential
sudo apt-get install libssl-dev

Optional: To install libsqlite3, in a terminal, enter:

sudo apt-get install libsqlite3-dev

Optional: To install Protobuf, in a terminal, enter:

sudo apt-get install libprotobuf-dev

Optional: To install log4cxx, in a terminal, enter:

sudo apt-get install liblog4cxx10-dev

Optional: To install Doxygen, in a terminal, enter:

sudo apt-get install doxygen

Odroid Ubuntu

Optional: To use boost, you may need to manually install it since apt-get doesn't seem to install the library files.

Windows Cygwin

Cygwin is tested on Windows 7 64-bit.

In the Cygwin installer, select and install the "Devel" packages at the top level of the installer. (The "Devel" packages include libcrypto and libsqlite3.)

Build

(These are instructions to build NDN-CPP. To do development of NDN-CPP code and update the build system, see Development.)

To build in a terminal, change directory to the NDN-CPP root. Enter:

./configure
make
sudo make install

NDN-CPP uses NDN-TLV as the default wire format: http://named-data.net/doc/ndn-tlv/tlv.html . To revert to Binary XML (ndnb) as the default wire format, instead of ./configure, use:

./configure --enable-binary-xml=yes

To run the unit tests, in a terminal enter:

make check

To make documentation, in a terminal enter:

make doxygen-doc

The documentation output is in doc/html/index.html. (If you already did ./configure before installing Doxygen, you need to do ./configure again before make doxygen-doc.)

Files

This makes the following libraries:

.libs/libndn-c.a: The core C code for encoding and communication.
.libs/libndn-cpp.a: The C++ library API. (If linking to libndn-cpp, don't link to libndn-c since it is included.)

This makes the following example programs:

bin/test-get-async: Connect to one of the NDN testbed hubs, express an interest and display the received data.
bin/test-publish-async-nfd: Connect to the local NFD hub, accept interests with prefix /testecho and echo back a data packet. See test-echo-consumer.
bin/test-echo-consumer: Prompt for a word, send the interest /testecho/word to the local hub which is echoed by test-publish-async-nfd (or test-publish-async-ndnx).
bin/test-encode-decode-interest: Encode and decode an interest, testing interest selectors and the name URI.
bin/test-encode-decode-data: Encode and decode a data packet, including signing the data packet.
bin/test-encode-decode-fib-entry: Encode and decode a sample Protobuf message using ProtobufTlv.
bin/test-chrono-chat: A command-line chat application using the ChronoSync2013 API, compatible with ChronoChat-js.

Running make doxygen-doc puts code documentation in doc/html.

Development Prerequisites

These steps are only needed to do development of NDN-CPP code and update the build system. First follow the Prerequisites above for your platforms.

Mac OS X 10.7.3, Mac OS X 10.8.4, Mac OS X 10.9

Install MacPorts from http://www.macports.org/install.php . In a terminal, enter:

sudo port install automake autoconf libtool doxygen

Ubuntu 12.04 (64 bit and 32 bit), Ubuntu 13.04 (64 bit)

In a terminal, enter:

sudo apt-get install automake libtool doxygen

Development

Follow Development Prerequisites above for your platform. Now you can add source code files and update Makefile.am. After updating, change directory to the NDN-CPP root and enter the following to build the Makefile:

./autogen.sh

To build again, follow the instructions above (./configure, make, etc.)