Installation

Basically, you copy the source code of nana (which is a tiny - 0.7 MB - .zip file) and tell your build system where it is.

General instructions: 📚

Get Nana

• GitHub: fork , clone or download and unzip (but recommended: from the latest hotfix branch)
• Sourceforge: download and unzip:

You have to compile the library (configure and build to generate the binary libs) before you can link it to your projects. This can be made with tools for build-automation or from an IDE. Cmake may help to create the files for those build systems. These are the general steps to install the library:

Installing

Some terms for this instruction:

• NanaPath: The path where Nana's files are located.
• IDEName: The name of a certain Integrated Development Environments. Such as vc2017.
• NanaStatic: The generated Nana static linkage file. Example: a *.lib or a *.a file.

Step One:

Start the IDE you use, set C++ include path and library path.

• Include Path: NanaPath/include
• Library Path: NanaPath/extrlib (Configuration of optional Third Party Libraries for Nana) , NanaPath/build/bin/IDEName (to save the nana lib).

Step Two:

Create a static linkage library solution within a IDE/build system you use, and add all the files which are placed in NanaPath/source and in all its sub directories to the project. Then compile the solution and you will get a static linkage file NanaStatic in a path similar to NanaPath/build/bin/IDEName.

Step Three:

Write a program that use Nana to create a GUI, and compile it with the NanaStatic file linked. Make sure to enable the compiler supports for RTTI, MultiThreading and exception.

Specific instructions:

by OS:

- Windows

• MS Visual Studio: VS2019, VS2017, XP
• CMake
• MinGW
• Code::Blocks
• CLion QuickStart(with CMake and MinGW or Cygwin)

- Linux

• CMake
• gcc
• Code::Blocks

- MacOS

• MacOS based on X11 through XQuartz pull #81
• CMake

by build tools:

• CMake - possible project file for CLion and MS Visual Studio.

• make 🚧

• bakefile 🚧

  • See also: CMake vs Make

• Support for CI build test:

  • Linux on Travis: (including all demos compilation)

  • Windows on AppVeyor

    • What is Conan? {Conan is a Python program } Nana-Conan
    • What is Travis?, First time?
    • What is AppVeyor?
    • What is Make?{GNU Make is a c program , here the Makefile Conventions}
    • What is CMake?{CMake is a C++ program , here the VARIABLES}
    • What is Bakefile? {Bakefile is a Python program }
    • What is 💡 TeamCity?
    • What is 💡 Coverity Scan? Find and fix defects in your open source project. Example (doxygen)
    • More about continuous integration services.

by compilers:

• gcc, CMake
• MinGW-gcc, CMake
• MS Visual Studio: VC2019, VC2017, CMake
• CLang: Compiling Nana with Clang 8.0, using CMake

by IDE:

• MS Visual Studio: VS2019, VS2017, XP, CLang, CMake
• CLion, QuickStart, (with CMake and GCC/G++ or Clang on OS X and Linux, MinGW, Cygwin or VC on Windows)
• Code::Blocks
• Eclipse