CPP / C++ - CMake Building System

add_executable(SampleApp main.cpp source1.cpp source2.cpp)

add_executable( SampleApp 
                main.cpp 
                class1.cpp class2.hpp 
                class1.cpp lcass2.hpp
              )

 target_compile_definitions(SampleApp PRIVATE  
    VERBOSITY=100  # Same as #define VERBOSITY 100 
    Optimize       # Same as -DOptimize or #define Optimize
    foo=bar        # Same as -Dfoo=bar on (GGCC or Clang) or /Dfoo=bar on MSVC
   )
# In a single line 
 target_compile_definitions(SampleApp PRIVATE VERBOSITY=100 Optimize foo=bar)

# Similar to: g++ main.cpp src1.cpp ... -o app.bin -Isrc/include1 -I/home/user/include
target_include_directories(SampleApp PUBLIC src/include1 /home/usr/include)

link_directories(  
  # C:\Users\DummyUser\libs
  "C:\\Users\\DummyUser\\libs" # Windows paths with backward slash must be escaped with '\'
  "C:/libs/Graphics"           # Windows paths with forward slash 
  "/home/DummyUser/libs" 
)

$ g++ file1.cpp -c -o file1.o -LC:\Users\DummyUser\libs -LC:/libs/Graphics/ -L/home/DummyUser/libs

# Project shared library SampleSharedLib.so (Linux, Unix) or 
# SampleSharedLib.dll on Windows. 
add_library( SampleSharedLib SHARED  
             tools.cpp      tools.hpp 
             CShell.cpp     CShell.hpp 
             FileSystem.cpp FileSystem.hpp
           )
# Configuration of target SampleSharedLib
target_include_directories(SampleSharedLib PRIVATE src/lib/include1)

# Project static library 
add_library(StaticLibrary STATIC lib1.cpp lib2.cpp lib3.cpp)

target_link_libraries(SampleApp  
        GL blas opencv ole32 user32  # System libraries  /usr/lib/*.so files on Linux 
                                     # or *.lib files for MSVC VC++/Windows compiler and DLLs 
                                     # at C:\Windows\System32
        SampleSharedLib              # Project shared library 
        StaticLibrary                # Project static library 
)

if(NOT MSVC) 
   # Only for GCC or Clang 
   # (g) => Add debugging symbols 
   target_compile_options(SampleApp -g -Wall -Wpendantic -Wextra )
else()
   # MSVC (VC++) => "visual" C++
   target_compile_options(SampleApp /Zi /Wall /Yd)         
endif()

# Equivalent to compiling the target usign GCC with -std=c++14 (C++14 ISO Standard)
# Or /std:c++14 in MSVC VC++ 
target_compile_features(SomeExecutableTarget PRIVATE cxx_std_14)

# Equivalent to compiling the target usign GCC with -std=c++17 (C++17 ISO Standard)
# Or /std:c++17 in MSVC VC++ 
target_compile_features(SomeExecutableTarget PRIVATE cxx_std_17)

# Equivalent to compiling the target usign GCC with -std=c++20 - Experimental C++20
target_compile_features(SomeExecutableTarget PRIVATE cxx_std_20)

set_target_properties(SampleApp PROPERTIES 
    {PROPERTY1} {VALUE1}
    {PROPERTY2} {VALUE2}
    ... .... ... ... 
    {PROPERTYN} {VALUEN}
 )

if(UNIX)
   # When it is compiled, instead of generating the executable named as SampleApp, 
   # the program will be named as "SampleApp.bin". 
   set_target_properties(SampleApp PROPERTIES SUFFIX ".bin")
 endif()

add_library(WrapperLibrary SHARED src1.cpp src2.cpp ... srcN.cpp)
# ... omit configuration ... # 

set_target_properties(WrapperLibrary PROPERTIES
  # On Unix, it would add "lib" to beggining of the file name.
  # If prefix was not set to empty, the output file name would be
  # 'libAddinExtesion.xll'
  PREFIX       ""  

  # Change file name without changing prefix or extension (suffix)
  OUTPUT_NAME  "AddinExtension"

  # Change file extension 
  SUFFIX      ".xll"    

  # Makes all symbols hidden by default (compiles with by compiling
  # with flag -fvisibility=hidden on Unix-like Oses).  This setting
  # mimics the behavior of MSVC compiler extension
  # __declspec(dllexport)/__declspec(dllimport)
  CXX_VISIBILITY_PRESET hidden
)

add_library(WrapperLibrary SHARED src1.cpp src2.cpp ... srcN.cpp)
# ... omit configuration ... # 
set_target_properties(WrapperLibrary PROPERTIES PREFIX      "")
set_target_properties(WrapperLibrary PROPERTIES OUTPUT_NAME "AddinExtension")
set_target_properties(WrapperLibrary PROPERTIES SUFFIX      ".xll")  

add_executable(DocGenerator src/docgen/main.cpp src/docgen/src2.cpp ...)
# ... configuration of DocGenerator

add_executable(Display src/docgen/main.cpp src/docge/src2.cpp ...)

add_library(libCommon SHARED src/lib/src1.cpp src/lib/src2.cpp ...)

# .... configure targes .... #

 # ========= Global Configuration  ===============#
 # The global configuration is shared by all targets. 
 cmake_minimum_required(VERSION 3.9)

 project( SuperCADTool
          # Note: the following fields are optional 
          DESCRIPTION "Another CAD Computer Aided Design APP"
          VERSION     1.0 
          LANGUAGE    CXX 
        )

 set(CMAKE_CXX_STANDARD 17)     
 set(CMAKE_VERBOSE_MAKEFILE ON)

# AVOID! 
# Global compile definition
# Add compiled definition -DQT_QML_DEBUG for all target.s 
add_definitions(-DQT_QML_DEBUG)

# AVOID!
# Global includes added to all targets 
include_directories("C:\\boost\\v1.67\\include"  "/home/someone/includes")

# AVOID! 
# Global linking directories which contains static (*.a) or shared
# libraries (*.so or *.dll files)
link_directories(  
   # C:\Users\DummyUser\libs
   "C:\\Users\\DummyUser\\libs" # Windows paths with backward slash must be escaped with '\'
   "C:/libs/Graphics"           # Windows paths with forward slash 
   "/home/DummyUser/libs" 
 )

 # ======= Configuration per target =============#

 # Target: SampleApp executable 
 #---------------------------------------------------------
 add_executable(SampleApp src/main.cpp src/source1.cpp src/source2.cpp) 
 target_compile_definitions(SampleApp PRIVATE VERBOSITY=100 Optimize foo=bar)
 target_include_directories(SampleApp PUBLIC src/include1 /home/usr/include)

 target_link_libraries(SampleApp  
         GL blas opencv ole32 user32  # System libraries  /usr/lib/*.so files on Linux 
                                      # or *.lib files for MSVC VC++/Windows compiler and DLLs 
                                      # at C:\Windows\System32
         SampleSharedLib              # Project shared library 
         StaticLibrary                # Project static library 
 )

# Target: Executable2 - Add header files to make them visible in the IDE 
#-----------------------------------------------------------------
add_executable(Executable2 src/execMain.cpp 
                           src/source1.cpp src/source1.hpp 
                           src/source2.cpp src/source2.hpp 
               ) 

# Target: SampleShared - Shared library dll, so 
#-------------------------------------------------------------------
add_library(SampleSharedLib SHARED  lib/lib1.cpp lib/lib2.cpp lib/lib3.cpp)
target_include_directories(SampleSharedLib PRIVATE src/lib/include1)

# Install binaries locally during development.
# The binaries are installed in project's "${ROOT DIRECTORY}./bin" 
#----------------------------------------------------------------------

# During the development install ./bin dir.  in project's root directory 
# To install using CMAKE_INSTALL_PREFIX path, set this variable to 'OFF'
set(INSTALL_LOCAL ON) 

if(INSTALL_LOCAL ON)
  # Overrides the default default install location that would be 
  # ${CMAKE_INSTALL_PREFIX}/bin as ${CMAKE_CURRENT_LIST_DIR}/bin 
  #
  # Note: CMAKE_CURRENT_LIST_DIR is the directory where is CMakeLists.txt 
  install(TARGETS SampleApp Executable2 SampleSharedLib DESTINATION  ${CMAKE_CURRENT_LIST_DIR}/bin)
else()
  # Install binary to directory probvided by the variable CMAKE_INSTALL_PREFIX 
  install(TARGETS SampleApp Executable2 SampleSharedLib DESTINATION  bin)
endif()

# Use Ninja build system 
$ cmake -Bcache -H. -G Ninja 

# Use Makefile 
$ cmake -Bcache -H. -G Ninja 

$ cmake -Bcache -H. -G Ninja -DCMAKE_INSTALL_PREFIX=/home/dummy/Documents/myapp 

$ cmake --build cache --target  

$ cmake --build cache --target SampleApp

$ cmake --build cache --target Executable2 

$ cmake --build cache --target install 

 $ >> tree . 
.
├── app1.cpp
├── app2.cpp
├── build_msvc.bat
├── CMakeLists.txt
├── lib_tool
│   ├── CMakeLists.txt
│   ├── tool.cpp
│   └── tool.hpp
├── lib_util
│   ├── CMakeLists.txt
│   ├── util.cpp
│   └── util.hpp
├── LICENSE.txt
└── Makefile

2 directories, 12 files

cmake_minimum_required(VERSION 3.9)
project(CMake_With_Makefile)

#========== Global Configurations =============#
#----------------------------------------------#

set(CMAKE_CXX_STANDARD 17)     
set(CMAKE_VERBOSE_MAKEFILE ON)

# Export ALL DLLs symbols on Windows without __declspec(xxxx) annotations.
set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS true)

function(ADD_RUN_TARGET tname target)
    add_custom_target( ${tname}
        COMMAND ${target}
        DEPENDS ${target}
        WORKING_DIRECTORY ${CMAKE_PROJECT_DIR}
    )
endfunction()

# Fix DLL not found problem on Windows 
# Note: Windows shared libraries do not have RPATH or RUNPATH
# DLLs are searched first at current directories and then in directories 
# listed in $PATH variable.
if(WIN32)
    set(LIBRARY_OUTPUT_PATH    "${CMAKE_BINARY_DIR}")
    set(EXECUTABLE_OUTPUT_PATH "${CMAKE_BINARY_DIR}")
endif()


    #=============================================#
    #  T A R G E T S  C O N F I G U R A T I O N   #  
    #=============================================#


add_subdirectory(lib_util)
add_subdirectory(lib_tool)

       add_executable( app1 app1.cpp )
target_link_libraries( app1 lib::util lib::tool )


if(_WIN32)
    set_target_properties( lib::util PROPERTIES 
                                     OUTPUT_NAME Util 
                                     CLEAN_DIRECTORY_OUTPUT 1 )  
endif()

# Set RPATH in the executable for making it relocatable on Unix.
# It allows installing the application on any directory or 
# running the application from any directory without 
# 'symbol not found or library not found' errros. 
#
# Note: The variable $ORIGIN is the executable absolute directory
if(UNIX AND NOT APPLE)
    set_target_properties( app1 PROPERTIES INSTALL_RPATH "$ORIGIN:$ORIGIN/../lib")                       
elseif(APPLE)
    # For MacOSX (MacO - Binary Files)
    set_target_properties( app1 PROPERTIES INSTALL_RPATH "@executable_path/../lib")                       
endif()

       add_executable( app2 app2.cpp )
target_link_libraries( app2 lib::util lib::tool)
# set_target_properties( app2 PROPERTIES INSTALL_RPATH "$ORIGIN/../lib")                       


ADD_RUN_TARGET(run-app1 app1)
ADD_RUN_TARGET(run-app2 app2)

    #===========================================#
    #  I N S T A L  L    T A R G E T            #
    #===========================================#


install( TARGETS  app1 app2 util tool 
         # Executables and DLLs (Windows Only)
         RUNTIME  DESTINATION ${CMAKE_INSTALL_BINDIR}            
         # Shared libraries: *.so or *.dylib 
         LIBRARY  DESTINATION ${CMAKE_INSTALL_LIBDIR}          
         # Static libraries: *.a 
         ARCHIVE  DESTINATION ${CMAKE_INSTALL_LIBDIR}

)

install(FILES LICENSE.txt DESTINATION data)

# GNU Make file script for easier compilation from
# command line

all: help 

help:
        @echo "Build options "
        @echo " $ make debug                 => Debug build at _debug directory "
        @echo " $ make release               => Release build at _release directory "   
        @echo " $ make install prefix=<PATH> => Build in release mode and install app. at prefix path. "                

debug:
        @echo " =>> DEBUG build "
        # Only configs if '_debug' directory does not exist yet.
        [ ! -f _debug ] && cmake --config Debug -B_debug -H.    
        cmake --build _debug --target

release:
        @echo " =>> RELEASE build " && sleep 1 
        [ ! -f _release ] && cmake --config Release -B_release -H. 
        cmake --build _release --target

install:
        @echo " =>> INSTALL release" && sleep 1 
        cmake --config Release -B_install -H. -DCMAKE_INSTALL_PREFIX=${prefix}
        cmake --build _install --target install

run-app1:
        @echo " =>> Run app1 " && sleep 1
        [ ! -f _debug ] && cmake --config Debug -B_debug -H.    
        cmake --build _debug --target run-app1 

clean:
        rm -rfv ./_debug ./_release ./_install  

clean-debug:
        rm -rf -v ./_debug 

clean-release:
        rm -rf -v ./_release 

#include <iostream>

#include <util.hpp>
#include <tool.hpp>

 int main(int argc, char** argv)
 {
    std::cout << " [INFO] Application 1 Called Ok." << std::endl;

    util::util_function(100);
    tool::too_lib_function();

   #ifdef _WIN32
      std::cout << " Type RETURN to exit " << "\n";
      std::cin.get();
   #endif   

    return 0;
 }

#include <iostream>

#include <util.hpp>
#include <tool.hpp> 

int main(int argc, char** argv)
{
    std::cout << " [INFO] Application 2 Called Ok." << std::endl;

    util::util_function(20);
    tool::too_lib_function();

    #ifdef _WIN32
       std::cout << " Type RETURN to exit " << "\n";
       std::cin.get();
    #endif 

    return 0;
}

               add_library( tool STATIC tool.cpp tool.hpp )
target_include_directories( tool PUBLIC . )

add_library( lib::tool ALIAS tool )

#ifndef _UTIL_HPP_
#define _UTIL_HPP_

namespace util {
    void util_function(int n);
}

#endif 

#include "util.hpp"

#include <iostream> 

namespace util {

    void util_function(int n)
    {
        std::cout << " [TRACE] util_function() called with n = " << n << '\n';
    }
}

               add_library ( util SHARED util.cpp util.hpp)
target_include_directories ( util PUBLIC . )
               add_library ( lib::util ALIAS util )

#ifndef _TOOL_HPP_
#define _TOOL_HPP_

namespace tool {
    void too_lib_function();
};

#endif 

#include "tool.hpp"

#include <iostream> 

namespace tool {
    void too_lib_function()
    {
        std::cout << " [TRACE] Called tool_lib_function() OK. " << "\n";
    }
};

$ git clone https://github.com/caiorss/cmake-cpp-nested cnest 
$ cd cnest

 $ >> make debug 
 =>> DEBUG build 
# Only configs if '_debug' directory does not exist yet.
[ ! -f _debug ] && cmake --config Debug -B_debug -H.    
-- The C compiler identification is GNU 10.1.1
-- The CXX compiler identification is GNU 10.1.1
-- Check for working C compiler: /usr/bin/cc
 ... ... ... 

 $ >> ls _debug/
app1*  CMakeCache.txt  cmake_install.cmake  lib_util/
app2*  CMakeFiles/     lib_tool/            Makefile

 # Test executable app1 
 $ >> _debug/app1
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK. 

 # Test executable app2 
 ~/t/cnest
 $ >> _debug/app2
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK. 

$ cmake --config Release -H. -B_install -DCMAKE_INSTALL_PREFIX=$HOME/Applications/mycmake-app
$ cmake --build _install --target install 

$ make install prefix=$HOME/Applications/mycmake-app

 $ >> tree ~/Applications/mycmake-app
/home/user/Applications/mycmake-app
├── bin
│   ├── app1
│   └── app2
├── data
│   └── LICENSE.txt
└── lib
    ├── libtool.a
    └── libutil.so

3 directories, 5 files

 # Attempt to run executable app1 
 $ >> ~/Applications/mycmake-app/bin/app1 
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK. 


 # Attempt to run executable app2   
 $ >> ~/Applications/mycmake-app/bin/app2
 [INFO] Application 2 Called Ok.
/home/mxpkf8/Applications/mycmake-app/bin/app2: symbol lookup error: /home/mxpkf8/Applications/mycmake-app/bin/app2: undefined symbol: _ZN4util13util_functionEi

 $ >> env LD_LIBRARY_PATH=$HOME/Applications/mycmake-app/lib  ~/Applications/mycmake-app/bin/app2
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK. 

# [FAILURE] Attempt to run app1 from any directory 
$ app1
bash: app1: command not found

# Solution: Add the install directory to $PATH environment variable
# either in the shell or in the configuration files ~/.bashrc or ~/.profile
$ export PATH=$HOME/Applications/mycmake-app/bin:$PATH

$ app1
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK. 

$ app2
 [INFO] Application 1 Called Ok.
app2: symbol lookup error: app2: undefined symbol: _ZN4util13util_functionEi

# Not recommended 
$ export LD_LIBRARY_PATH=$HOME/Applications/mycmake-app/lib:$LD_LIBARY_PATH

$ app2
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK. 

$ ln -s ~/Applications/mycmake-app/bin/app1 /usr/local/bin/app1
$ ln -s ~/Applications/mycmake-app/bin/app2 /usr/local/bin/app2  

$ >> ldd  ~/Applications/mycmake-app/bin/app1
linux-vdso.so.1 (0x00007ffc945f6000)
libutil.so => /home/user/Applications/mycmake-app/bin/../lib/libutil.so (0x00007f6f95035000)
libstdc++.so.6 => /lib64/libstdc++.so.6 (0x00007f6f94e23000)
libm.so.6 => /lib64/libm.so.6 (0x00007f6f94cdd000)
libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007f6f94cc2000)
libc.so.6 => /lib64/libc.so.6 (0x00007f6f94af8000)
/lib64/ld-linux-x86-64.so.2 (0x00007f6f9503c000)

$ docker run -it --rm -v $PWD:/cwd -w /cwd --entrypoint=bash linux-build

$ cmake --config Release -H. -B_install 

$ cmake --build _install --target install
    ... ... ... ... ... ... ... ... 
    ... ... ... ... ... 
 Install the project...
 /hbb/bin/cmake -P cmake_install.cmake
 -- Install configuration: ""
 -- Installing: /usr/local/bin/app1
 -- Set runtime path of "/usr/local/bin/app1" to "$ORIGIN:$ORIGIN/../lib"
 -- Installing: /usr/local/bin/app2
 -- Set runtime path of "/usr/local/bin/app2" to ""
 -- Installing: /usr/local/lib/libutil.so
 -- Installing: /usr/local/lib/libtool.a
 -- Installing: /usr/local/data/LICENSE.txt

$ app1
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK. 

$ app2
 [INFO] Application 2 Called Ok.
app2: symbol lookup error: app2: undefined symbol: _ZN4util13util_functionEi
[root@5bf932c0a153 cwd]# 

 $ which app1
 /usr/local/bin/app1

 $ which app2
 /usr/local/bin/app2

$ ldd $(which app1)
   linux-vdso.so.1 =>  (0x00007ffe2752b000)
   libutil.so => /usr/local/bin/../lib/libutil.so (0x00007f1530013000)
   libstdc++.so.6 => /usr/lib64/libstdc++.so.6 (0x00007f152fd0d000)
   libm.so.6 => /lib64/libm.so.6 (0x00007f152fa89000)
   libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007f152f873000)
   libc.so.6 => /lib64/libc.so.6 (0x00007f152f4df000)
   /lib64/ld-linux-x86-64.so.2 (0x00007f1530215000)


$ ldd $(which app2)
   linux-vdso.so.1 =>  (0x00007ffdad757000)
   libutil.so => /usr/lib64/libutil.so (0x00007fed49570000)
   libstdc++.so.6 => /usr/lib64/libstdc++.so.6 (0x00007fed4926a000)
   libm.so.6 => /lib64/libm.so.6 (0x00007fed48fe6000)
   libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007fed48dd0000)
   libc.so.6 => /lib64/libc.so.6 (0x00007fed48a3c000)
   /lib64/ld-linux-x86-64.so.2 (0x00007fed49773000)

$ git clone https://github.com/caiorss/cmake-cpp-nested cnest 
$ cd cnest

# For Visual Studio MSVC 2019 / x86-64 (AMD64 or IA64 - 64 bits)
$ cmake --Config Release -H. -B_install1 -G "Visual Studio 16 2019" -A x64 -DCMAKE_INSTALL_PREFIX=%USERPROFILE%\Desktop\mycmake-app

# For Visual Studio MSVC 2017 / x86-64 (64 bits)
$ cmake --Config Release -H. -B_install1 -G "Visual Studio 16 2017 Win64" -DCMAKE_INSTALL_PREFIX=%USERPROFILE%\Desktop\mycmake-app

# For Visual Studio MSVC 2017 x86 - 32 bits 
$ cmake --Config Release -H. -B_install1 -G "Visual Studio 16 2017" -DCMAKE_INSTALL_PREFIX=%USERPROFILE%\Desktop\mycmake-app

$ cmake --build _install1 --target

$ ls _install1

ALL_BUILD.vcxproj          CMake_With_Makefile.sln  run-app1.vcxproj
ALL_BUILD.vcxproj.filters  CMakeCache.txt           run-app1.vcxproj.filters
app1.dir/                  CMakeFiles/              run-app2.vcxproj
app1.vcxproj               Debug/                   run-app2.vcxproj.filters
app1.vcxproj.filters       INSTALL.vcxproj          x64/
app2.dir/                  INSTALL.vcxproj.filters  ZERO_CHECK.vcxproj
app2.vcxproj               install_manifest.txt     ZERO_CHECK.vcxproj.filters
app2.vcxproj.filters       lib_tool/
cmake_install.cmake        lib_util/

$ ls _install1/Debug
app1.exe*  app1.pdb   app2.ilk  tool.lib  util.dll*  util.ilk  util.pdb
app1.ilk   app2.exe*  app2.pdb  tool.pdb  util.exp   util.lib

# ----- Check file types ----------------------------------------------#

$ file _install1/Debug/app1.exe
_install1/Debug/app1.exe: PE32+ executable (console) x86-64, for MS Windows

$ file _install1/Debug/app1.ilk
_install1/Debug/app1.ilk: data

$ file _install1/Debug/app1.pdb
_install1/Debug/app1.pdb: MSVC program database ver 7.00, 4096*267 bytes

$ file _install1/Debug/app1.lib
_install1/Debug/app1.lib: cannot open `_install1/Debug/app1.lib' (No such file or directory)

$ file _install1/Debug/tool.lib
_install1/Debug/tool.lib: current ar archive

$ file _install1/Debug/util.exp
_install1/Debug/util.exp: Intel amd64 COFF object file, not stripped, 2 sections, symbol offset=0xb38, 38 symbols

$ _install1\Debug\app1.exe
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ _install1\Debug\app2.exe
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ cmake --build _install1 --target install
Microsoft (R) Build Engine version 16.8.2+25e4d540b for .NET Framework
Copyright (C) Microsoft Corporation. All rights reserved.

  tool.vcxproj -> Z:\cnest\_install1\Debug\tool.lib
  Auto build dll exports
  util.vcxproj -> Z:\cnest\_install1\Debug\util.dll
  app1.vcxproj -> Z:\cnest\_install1\Debug\app1.exe
  app2.vcxproj -> Z:\cnest\_install1\Debug\app2.exe
  -- Install configuration: "Debug"
  -- Installing: C:/Users/h03fx/Desktop/mycmake-app/bin/app1.exe
  -- Installing: C:/Users/h03fx/Desktop/mycmake-app/bin/app2.exe
  -- Installing: C:/Users/h03fx/Desktop/mycmake-app/lib/util.lib
  -- Installing: C:/Users/h03fx/Desktop/mycmake-app/bin/util.dll
  -- Installing: C:/Users/h03fx/Desktop/mycmake-app/lib/tool.lib
  -- Installing: C:/Users/h03fx/Desktop/mycmake-app/data/LICENSE.txt

 $ >> tree mycmake-app 
mycmake-app
├── bin
│   ├── app1.exe
│   ├── app2.exe
│   └── util.dll
├── data
│   └── LICENSE.txt
└── lib
    ├── tool.lib
    └── util.lib

3 directories, 6 files

$ %USERPROFILE%\Desktop\mycmake-app\bin\app1
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit


$ %USERPROFILE%\Desktop\mycmake-app\bin\app2
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit


$ %USERPROFILE%\Desktop\mycmake-app\bin\app1.exe
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ cmake --Config Release -H. -B_install2 -G "Visual Studio 16 2019" -A x64

$ cmake --build _install2 --target install
Microsoft (R) Build Engine version 16.6.0+5ff7b0c9e for .NET Framework
Copyright (C) Microsoft Corporation. All rights reserved.

  tool.vcxproj -> C:\Users\mxpkf8\Desktop\cnest\_install2\Debug\tool.lib
  Auto build dll exports
  util.vcxproj -> C:\Users\mxpkf8\Desktop\cnest\_install2\Debug\util.dll
  app1.vcxproj -> C:\Users\mxpkf8\Desktop\cnest\_install2\Debug\app1.exe
  app2.vcxproj -> C:\Users\mxpkf8\Desktop\cnest\_install2\Debug\app2.exe
  -- Install configuration: "Debug"
  -- Installing: C:/Program Files (x86)/CMake_With_Makefile/bin/app1.exe
  -- Installing: C:/Program Files (x86)/CMake_With_Makefile/bin/app2.exe
  -- Installing: C:/Program Files (x86)/CMake_With_Makefile/lib/util.lib
  -- Installing: C:/Program Files (x86)/CMake_With_Makefile/bin/util.dll
  -- Installing: C:/Program Files (x86)/CMake_With_Makefile/lib/tool.lib
  -- Installing: C:/Program Files (x86)/CMake_With_Makefile/data/LICENSE.txt

$ "C:/Program Files/CMake_With_Makefile/bin/app1.exe"
[INFO] Application 1 Called Ok.
[TRACE] util_function() called with n = 100
[TRACE] Called tool_lib_function() OK.
Type RETURN to exit

$ "C:/Program Files/CMake_With_Makefile/bin/app2.exe"
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ "%PROGRAMFILES%"\CMake_With_Makefile\bin\app1.exe
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ git clone https://github.com/caiorss/cmake-cpp-nested cnest 
$ cd cnest

$ cmake --config Debug -H. -B_buildmg -G "MinGW Makefiles" -DCMAKE_INSTALL_PREFIX=%USERPROFILE%\Desktop\cnest-mingw-install

$ cmake --build _buildmg --target

$ ls _buildmg
app1.exe  cmake_install.cmake  CMakeFiles  lib_util   libutil.dll    Makefile
app2.exe  CMakeCache.txt       lib_tool    libtool.a  libutil.dll.a

$ _buildmg/app1.exe
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ _buildmg/app1.exe
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ cmake --build _buildmg --target install
  ...   ...   ...   ...   ...   ... 
  ...   ...   ...   ...   ...   ... 

 Install the project...
C:\Users\myuser\scoop\apps\cmake\3.19.2\bin\cmake.exe -P cmake_install.cmake
-- Install configuration: ""
-- Installing: C:/Users/myuser/Desktop/cnest-mingw-install/bin/app1.exe
-- Installing: C:/Users/myuser/Desktop/cnest-mingw-install/bin/app2.exe
-- Installing: C:/Users/myuser/Desktop/cnest-mingw-install/lib/libutil.dll.a
-- Installing: C:/Users/myuser/Desktop/cnest-mingw-install/bin/libutil.dll
-- Installing: C:/Users/myuser/Desktop/cnest-mingw-install/lib/libtool.a
-- Installing: C:/Users/myuser/Desktop/cnest-mingw-install/data/LICENSE.txt

$ %USERPROFILE%\Desktop\cnest-mingw-install\bin\app1.exe
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ %USERPROFILE%\Desktop\cnest-mingw-install\bin\app2.exe
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK.
 Type RETURN to exit

$ git clone https://github.com/caiorss/cmake-cpp-nested cnest 
$ cd cnest

$ cmake --config Release -H. -B_build -DCMAKE_INSTALL_PREFIX=$HOME/Desktop/myappx

-- The C compiler identification is AppleClang 11.0.3.11030032
-- The CXX compiler identification is AppleClang 11.0.3.11030032
-- Check for working C compiler: /Library/Developer/CommandLineTools/usr/bin/cc
-- Check for working C compiler: /Library/Developer/CommandLineTools/usr/bin/cc - works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Check for working CXX compiler: /Library/Developer/CommandLineTools/usr/bin/c++
-- Check for working CXX compiler: /Library/Developer/CommandLineTools/usr/bin/c++ - works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done

-- Generating done
-- Build files have been written to: /Volumes/data/cnest/_build

$ cmake --build _build --target all 

$ tree -L 2 _build
_build
├── CMakeCache.txt
 ... ... ... ... ... 
 ... ... ... ... ... 
├── Makefile
├── app1
├── app2
├── cmake_install.cmake
├── lib_tool
│   ├── CMakeFiles
│   ├── Makefile
│   ├── cmake_install.cmake
│   └── libtool.a
└── lib_util
    ├── CMakeFiles
    ├── Makefile
    ├── cmake_install.cmake
    └── libutil.dylib

$ file _build/app1
_build/app1: Mach-O 64-bit executable x86_64

$ file _build/lib_tool/libtool.a
_build/lib_tool/libtool.a: current ar archive random library

$ file _build/lib_util/libutil.dylib
_build/lib_util/libutil.dylib: Mach-O 64-bit dynamically linked shared library x86_64

$ _build/app1
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK. 

$ _build/app2
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK.  

$ cmake --build _build --target install
  ... ... ... ... ... ... ... ... ...
  ... ...  ... .... ... ... ... ... .. 
/Library/Developer/CommandLineTools/usr/bin/make  -f CMakeFiles/Makefile2 preinstall
make[1]: Nothing to be done for `preinstall'.
Install the project...
/usr/local/Cellar/cmake/3.17.3/bin/cmake -P cmake_install.cmake
-- Install configuration: ""
-- Installing: /Users/unix/Desktop/myappx/bin/app1
-- Installing: /Users/unix/Desktop/myappx/bin/app2
-- Installing: /Users/unix/Desktop/myappx/lib/libutil.dylib
-- Installing: /Users/unix/Desktop/myappx/lib/libtool.a
-- Installing: /Users/unix/Desktop/myappx/data/LICENSE.txt

$ tree $HOME/Desktop/myappx
/Users/unix/Desktop/myappx
├── bin
│   ├── app1
│   └── app2
├── data
│   └── LICENSE.txt
└── lib
    ├── libtool.a
    └── libutil.dylib

3 directories, 5 files

$ /Users/unix/Desktop/myappx/bin/app1
 [INFO] Application 1 Called Ok.
 [TRACE] util_function() called with n = 100
 [TRACE] Called tool_lib_function() OK. 


$ /Users/unix/Desktop/myappx/bin/app2
 [INFO] Application 2 Called Ok.
dyld: lazy symbol binding failed: Symbol not found: __ZN4util13util_functionEi
  Referenced from: /Users/unix/Desktop/myappx/bin/app2
  Expected in: /usr/lib/libutil.dylib

dyld: Symbol not found: __ZN4util13util_functionEi
  Referenced from: /Users/unix/Desktop/myappx/bin/app2
  Expected in: /usr/lib/libutil.dylib


$ env DYLD_LIBRARY_PATH=/Users/unix/Desktop/myappx/lib   /Users/unix/Desktop/myappx/bin/app2
 [INFO] Application 2 Called Ok.
 [TRACE] util_function() called with n = 20
 [TRACE] Called tool_lib_function() OK. 

$ otool -l  /Users/unix/Desktop/myappx/bin/app1

/Users/unix/Desktop/myappx/bin/app1:
Mach header
      magic cputype cpusubtype  caps    filetype ncmds sizeofcmds      flags
 0xfeedfacf 16777223          3  0x00           2    19       1584 0x00218085
Load command 0
      cmd LC_SEGMENT_64
  cmdsize 72
  segname __PAGEZERO
   vmaddr 0x0000000000000000
   vmsize 0x0000000100000000
 .... .. .   .... .. .   .... .. .    .... .. .   .... .. .   .... .. .
 .... .. .   .... .. .   .... .. .    .... .. .   .... .. .   .... .. .
Load command 17
      cmd LC_DATA_IN_CODE
  cmdsize 16
  dataoff 22088
 datasize 0
Load command 18
          cmd LC_RPATH
      cmdsize 40
         path @executable_path/../lib (offset 12)

# Error: attemtps to install to read-only file system 
$ cmake --config Release -H. -B_build2 -DCMAKE_INSTALL_PREFIX=
$ cmake --build _build2 --target install

$ git init .
Initialized empty Git repository in /home/user/projects/cmake-experiment/.git/

$ git add CMakeLists.txt main.cpp 

$ git commit -m started
[master (root-commit) 8e60c5c] started
 2 files changed, 16 insertions(+)
 create mode 100644 CMakeLists.txt
 create mode 100644 main.cpp

$ git submodule add  https://github.com/gabime/spdlog extern/spdlog
$ git submodule add https://github.com/cpputest/cpputest extern/cpputest

$ tree -L 2 .
.
├── CMakeLists.txt
├── CMakeLists.txt.user
├── extern
│   ├── cpputest
│   └── spdlog
└── main.cpp

3 directories, 3 files

cmake_minimum_required(VERSION 2.8)
project(cmake-experiment)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_VERBOSE_MAKEFILE ON)

add_subdirectory(extern/spdlog)
add_subdirectory(extern/cpputest)

add_executable(app main.cpp)
target_link_libraries(app spdlog::spdlog CppUTest)

add_library(spdlog INTERFACE)
add_library(spdlog::spdlog ALIAS spdlog)

include_directories(${CppUTestRootDirectory}/include)
add_subdirectory(src/CppUTest)

add_library( CppUTest
            CommandLineArguments.cpp
            MemoryLeakWarningPlugin.cpp
            TestHarness_c.cpp
            ... ... ... ... 
           )

#include <iostream>
#include <spdlog/spdlog.h>
#include <CppUTest/CommandLineTestRunner.h>
#include <CppUTest/Utest.h>
#include <CppUTest/TestHarness.h>

double func(double x)
{
    return 3 * x * x - 21.0 * x + 36.0;
}

TEST_GROUP(MainTest)
{
};

TEST(MainTest, functionPoints)
{
    spdlog::info("Running functionPointsTest.");

    DOUBLES_EQUAL(0.0, func(4.0), 0.001);
    DOUBLES_EQUAL(0.0, func(3.0), 0.001);
    DOUBLES_EQUAL(0.0, func(3.0), 0.001);
    DOUBLES_EQUAL(10.0, func(126.0), 0.001);

    // Supposed to fail
    DOUBLES_EQUAL(1.0, func(18.0), 0.001);

    spdlog::info("Ending functionPointsTest.");
};

int main(int argc, char** argv)
{
    SPDLOG_TRACE("Entering function");
    spdlog::info("Starting server OK.");
    spdlog::error("Server crashed. ");
    spdlog::info("Received request from 192.168.10.1 at port 9090");
    spdlog::info("Sending response to client 192.168.100.1 connection ID 10");
    SPDLOG_TRACE("Exit application");

    std::cout << "========== Running Tests ============" << std::endl;

    return RUN_ALL_TESTS(argc, argv);
}

$ cmake -H. -B_build -GNinja -DCMAKE_BUILD_TYPE=Debug
 ... ... ... ... ... ... 
-------------------------------------------------------

-- Configuring done
-- Generating done
-- Build files have been written to: /home/archbox/projects/cmake-experiment/_build

$ cmake --build _build --target all

$ _build/app 
[2019-07-11 17:24:59.450] [info] Starting server OK.
[2019-07-11 17:24:59.450] [error] Server crashed. 
[2019-07-11 17:24:59.450] [info] Received request from 192.168.10.1 at port 9090
[2019-07-11 17:24:59.451] [info] Sending response to client 192.168.100.1 connection ID 10
========== Running Tests ============
[2019-07-11 17:24:59.451] [info] Running functionPointsTest.

../main.cpp:23: error: Failure in TEST(MainTest, functionPoints)
        expected <10>
        but was  <45018> threshold used was <0.001>

.
Errors (1 failures, 1 tests, 1 ran, 4 checks, 0 ignored, 0 filtered out, 1 ms)

cmake_minimum_required(VERSION 3.14 FATAL_ERROR)
project(cmake-experiment)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_VERBOSE_MAKEFILE ON)

# See documentation at: https://cmake.org/cmake/help/latest/module/FetchContent.html
include(FetchContent)

#========== Fetch cpputest ============================#

FetchContent_Declare(
    cpputest
    GIT_REPOSITORY  "https://github.com/cpputest/cpputest.git"
    GIT_TAG         "v3.8"
)
FetchContent_GetProperties(cpputest)
if(NOT cpputest_POPULATED)
    FetchContent_Populate(cpputest)
    message(" [INFO] cpputest_SOURCE_DIR = ${cpputest_SOURCE_DIR} ")
    message(" [INFO] cpputest_BINARY_DIR = ${cpputest_BINARY_DIR} ")

    # Optional => From: https://github.com/cpputest/cpputest/blob/master/CMakeLists.txt
    set(TEST OFF)
    set(TEST_DETAILED OFF)

    add_subdirectory(${cpputest_SOURCE_DIR} ${cpputest_BINARY_DIR})

    # Note: this path was found by trial and error, it is library-specific
    include_directories(${cpputest_SOURCE_DIR}/include)
endif()

#===== Fetch spdlog as archive ====================#

FetchContent_Declare(
    spdlog
    URL       "https://github.com/gabime/spdlog/archive/v1.3.1.zip"
)
FetchContent_GetProperties(spdlog)
if(NOT spdlog_POPULATED)
    FetchContent_Populate(spdlog)
    # message(" [INFO] spdlog_SOURCE_DIR = ${spdlog_SOURCE_DIR} ")
    # message(" [INFO] spdlog_BINARY_DIR = ${spdlog_BINARY_DIR} ")

    # Optional => Set library build options
    # Build options at: https://github.com/gabime/spdlog/blob/v1.x/CMakeLists.txt
    set(SPDLOG_BUILD_EXAMPLES OFF)
    set(SPDLOG_BUILD_BENCH    OFF)
    set(SPDLOG_BUILD_TESTS    OFF)

    add_subdirectory(${spdlog_SOURCE_DIR} ${spdlog_BINARY_DIR})
endif()

# ========= Target Settings ==========================#
add_executable(app main.cpp)
target_link_libraries(app  CppUTest spdlog::spdlog)

#include <iostream>
#include <spdlog/spdlog.h>
#include <CppUTest/CommandLineTestRunner.h>
#include <CppUTest/Utest.h>
#include <CppUTest/TestHarness.h>

double func(double x)
{
    return 3 * x * x - 21.0 * x + 36.0;
}

TEST_GROUP(MainTest)
{
};

TEST(MainTest, functionPoints)
{
    spdlog::info("Running functionPointsTest.");

    DOUBLES_EQUAL(0.0, func(4.0), 0.001);
    DOUBLES_EQUAL(0.0, func(3.0), 0.001);
    DOUBLES_EQUAL(0.0, func(3.0), 0.001);
    DOUBLES_EQUAL(10.0, func(126.0), 0.001);

    // Supposed to fail
    DOUBLES_EQUAL(1.0, func(18.0), 0.001);

    spdlog::info("Ending functionPointsTest.");
};

int main(int argc, char** argv)
{
    SPDLOG_TRACE("Entering function");
    spdlog::info("Starting server OK.");
    spdlog::error("Server crashed. ");
    spdlog::info("Received request from 192.168.10.1 at port 9090");
    spdlog::info("Sending response to client 192.168.100.1 connection ID 10");
    SPDLOG_TRACE("Exit application");

    std::cout << "========== Running Tests ============" << std::endl;

    return RUN_ALL_TESTS(argc, argv);
}

$ cmake -H. -Bbuild -DCMAKE_BUILD_TYPE=Debug
-- The C compiler identification is GNU 8.3.1
-- The CXX compiler identification is GNU 8.3.1
-- Check for working C compiler: /usr/lib64/ccache/cc
-- Check for working C compiler: /usr/lib64/ccache/cc -- works

 ... .... ... ... ... ... ... ... ... ... 

-- Configuring done
-- Generating done
-- Build files have been written to: /home/user/projects/cmake-experiment/build

$ cmake --build build --target

$ tree -L 2 build
build
├── app
├── CMakeCache.txt
├── CMakeFiles
│   ├── 3.14.3
│   ├── app.dir
│   ├── cmake.check_cache
│   ├── CMakeDirectoryInformation.cmake
│   ├── CMakeError.log
│   ├── CMakeOutput.log
│   ├── CMakeRuleHashes.txt
│   ├── CMakeTmp
│   ├── feature_tests.bin
│   ├── feature_tests.c
│   ├── feature_tests.cxx
│   ├── Makefile2
│   ├── Makefile.cmake
│   ├── progress.marks
│   └── TargetDirectories.txt
├── cmake_install.cmake
├── _deps
│   ├── cpputest-build
│   ├── cpputest-src
│   ├── cpputest-subbuild
│   ├── spdlog-build
│   ├── spdlog-src
│   └── spdlog-subbuild
├── Makefile
├── spdlogConfigVersion.cmake
└── spdlog.pc

11 directories, 18 files

$ build/app 
[2019-07-14 01:16:58.305] [info] Starting server OK.
[2019-07-14 01:16:58.305] [error] Server crashed. 
[2019-07-14 01:16:58.305] [info] Received request from 192.168.10.1 at port 9090
[2019-07-14 01:16:58.305] [info] Sending response to client 192.168.100.1 connection ID 10
========== Running Tests ============
[2019-07-14 01:16:58.305] [info] Running functionPointsTest.

/home/archbox/projects/cmake-experiment/main.cpp:23: error: Failure in TEST(MainTest, functionPoints)
        expected <10>
        but was  <45018> threshold used was <0.001>

.
Errors (1 failures, 1 tests, 1 ran, 4 checks, 0 ignored, 0 filtered out, 0 ms)

cmake_minimum_required(VERSION 3.14 FATAL_ERROR)
project(cmake-experiment)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_VERBOSE_MAKEFILE ON)

# See documentation at: https://cmake.org/cmake/help/latest/module/FetchContent.html

#========== Macros for automating Library Fetching =============#
include(FetchContent)

# Download library from Github and add it as sub-project
#
macro(Download_Library_Git  NAME TAG REPOSITORY_URL)
    FetchContent_Declare(
        ${NAME}
        GIT_REPOSITORY  ${REPOSITORY_URL}
        GIT_TAG         ${TAG}
    )
    FetchContent_GetProperties(${NAME})
    if(NOT cpputest_POPULATED)
        FetchContent_Populate(${NAME})
        message("${NAME}_SOURCE_DIR} = ${${NAME}_SOURCE_DIR}")
        add_subdirectory(${${NAME}_SOURCE_DIR} ${${NAME}_BINARY_DIR})
    endif()
endmacro()

macro(Download_Library_Github LIBRARY_NAME TAG USER PROJECT )
    Download_Library_Git(
        ${LIBRARY_NAME}
        ${TAG}
        "https://github.com/${USER}/${PROJECT}.git"
        )
endmacro()

# Download library archive (zip, *.tar.gz, ...) from URL
macro(Download_Library_Url NAME URL)
    FetchContent_Declare(${NAME} URL  ${URL})
    FetchContent_GetProperties(${NAME})
    if(NOT ${NAME}_POPULATED)
        FetchContent_Populate(${NAME})
        add_subdirectory(${${NAME}_SOURCE_DIR} ${${NAME}_BINARY_DIR})
    endif()
endmacro()

# Add path header files to the include path of all targets.
# => NAME => Library name added with any Download_Library command.
# => RELATIVE_PATH => Path to header files relative to library root directory
#
function(include_headers_directory NAME REALATIVE_PATH)
    include_directories("${${NAME}_SOURCE_DIR}/${RELATIVE_PATH}")
endfunction()

#============== Library Download =========================#

Download_Library_Url(
    spdlog
    "https://github.com/gabime/spdlog/archive/v1.3.1.zip"
    )

Download_Library_Github(
    cppcodec  # Library name - arbitrary
    v0.2      # Git tag
    tplgy     # Github user name
    cppcodec  # Name of project that will be cloned.
              # Note: It is does not always have the same name as the library.
    )

# Only use it if CMake cannot find the headers or the library is not
# set properly.
include_headers_directory(cppcodec ./cppcodec)

# ========= Targets Settings ==========================#

add_executable(mainapp main.cpp)
target_link_libraries(mainapp cppcodec spdlog::spdlog)

#include <iostream>
#include <spdlog/spdlog.h>

#include <cppcodec/base32_crockford.hpp>
#include <cppcodec/base64_rfc4648.hpp>


int main(int argc, char** argv)
{
    SPDLOG_TRACE("Entering function");

    spdlog::info("Starting server OK.");

    spdlog::info("Received request from 192.168.10.1 at port 9090");
    spdlog::info("Sending response to client 192.168.100.1 connection ID 10");

    using base32 = cppcodec::base32_crockford;
    using base64 = cppcodec::base64_rfc4648;

    std::vector<uint8_t> decoded = base64::decode("YW55IGNhcm5hbCBwbGVhc3VyZQ==");
    std::cout << "decoded size (\"any carnal pleasure\"): " << decoded.size() << '\n';
    std::cout << base32::encode(decoded) << std::endl; // "C5Q7J833C5S6WRBC41R6RSB1EDTQ4S8"


    SPDLOG_TRACE("Exit application");

    return 0;
}

$ cd proejct_directory 
$ cmake -B_build -H. -DCMAKE_BUILD_TYPE=Debug
$ cmake --build _build --target all

# Run 
$ _build/mainapp 
[2019-07-19 17:46:56.306] [info] Starting server OK.
[2019-07-19 17:46:56.306] [info] Received request from 192.168.10.1 at port 9090
[2019-07-19 17:46:56.306] [info] Sending response to client 192.168.100.1 connection ID 10
decoded size ("any carnal pleasure"): 19
C5Q7J833C5S6WRBC41R6RSB1EDTQ4S8

$ sudo apt-get install -y freeglut3-dev
$ sudo apt-get install -y libxi-dev
$ sudo apt-get install -y libxcursor-dev
$ sudo apt-get install -y libxrandr-dev
$ sudo apt-get install -y libxinerama-dev

cmake_minimum_required(VERSION 3.5)
project(GLFW_project)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_VERBOSE_MAKEFILE ON)

#================ GLFW Settings  ===============#

include(FetchContent)

# Set GLFW Options before FectchContent_MakeAvailable 
set( GLFW_BUILD_EXAMPLES OFF CACHE BOOL  "GLFW lib only" )
set( GLFW_BUILD_TESTS OFF CACHE BOOL     "GLFW lib only" )
set( GLFW_BUILD_DOCS OFF CACHE BOOL      "GLFW lib only" )
set( GLFW_BUILD_INSTALL OFF CACHE BOOL   "GLFW lib only" )

FetchContent_Declare(
  glfwlib
  URL   https://github.com/glfw/glfw/releases/download/3.3.2/glfw-3.3.2.zip
)

FetchContent_MakeAvailable(glfwlib)

#========= Find Packages =========================#

find_package(OpenGL REQUIRED)

#========== Target Configurations ================#

add_executable(app1 main.cpp)
target_link_libraries(app1 glfw OpenGL::GL glut GLU)

#include <GLFW/glfw3.h>
#include <GL/glu.h>
#include <GL/glut.h>

int main(int argc, char** argv)
{
    GLFWwindow* window;

    /* Initialize the library */
    if (!glfwInit())
        return -1;

    glutInit(&argc, argv);

    /* Create a windowed mode window and its OpenGL context */
    window = glfwCreateWindow(640, 480, "Hello World", NULL, NULL);
    if (!window)
    {
        glfwTerminate();
        return -1;
    }

    /* Make the window's context current */
    glfwMakeContextCurrent(window);

    glClearColor(0.0f, 0.5f, 0.6f, 1.0f);


    /* Loop until the user closes the window */
    while (!glfwWindowShouldClose(window))
    {
        /* Render here */
        glClear(GL_COLOR_BUFFER_BIT);

        glRotated(15.0, 1.0, 1.0, 1.0);
        ::glutWireTeapot(0.65);

        /* Swap front and back buffers */
        glfwSwapBuffers(window);

        /* Poll for and process events */
        glfwPollEvents();
    }

    glfwTerminate();
    return 0;
}

$ cmake -H. -B_build -DCMAKE_BUILD_TYPE=Debug 
-- The C compiler identification is GNU 8.3.1
-- The CXX compiler identification is GNU 8.3.1
    ... ... ... .... ... 

-- Found OpenGL: /usr/lib64/libOpenGL.so   
-- Configuring done
-- Generating done
-- Build files have been written to: /home/archbox/projects/glfw-learning/_build

$ cmake --build _build --target all 

... ... ... ... ... ... 
... ... ... ... ... ... 

Scanning dependencies of target glfw
gmake[2]: Leaving directory '/home/archbox/projects/glfw-learning/_build'
/usr/bin/gmake -f _deps/glfwlib-build/src/CMakeFiles/glfw.dir/build.make _deps/glfwlib-build/src/CMakeFiles/glfw.dir/build
gmake[2]: Entering directory '/home/archbox/projects/glfw-learning/_build'
[  5%] Building C object _deps/glfwlib-build/src/CMakeFiles/glfw.dir/context.c.o

 ... ... ... ... ... .. 
... ... ... ... ... ... 

[ 10%] Building C object _deps/glfwlib-build/src/CMakeFiles/glfw.dir/init.c.o

... ... ... ... ... ... 
... ... ... ... ... ... 

[ 89%] Linking C static library libglfw3.a

[100%] Linking CXX executable app1

$ _build/app1 

cmake_minimum_required(VERSION 3.9)
project(Simple_Cmake_Project)

#========== Global Configurations =============#
#----------------------------------------------#

set(CMAKE_CXX_STANDARD 17)     
set(CMAKE_VERBOSE_MAKEFILE ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# ------------ Download CPM CMake Script ----------------#

## Automatically donwload and use module CPM.cmake
file(DOWNLOAD https://raw.githubusercontent.com/TheLartians/CPM.cmake/v0.26.2/cmake/CPM.cmake
                 "${CMAKE_BINARY_DIR}/CPM.cmake")
include("${CMAKE_BINARY_DIR}/CPM.cmake")

#----------- Add dependencies --------------------------#

CPMAddPackage(
    NAME spdlog
    URL  "https://github.com/gabime/spdlog/archive/v1.3.1.zip"

    # -->> Only enable this, if the library does not use CMake.
    #      The library uses only Makefile, GNU autotools and so on.  
    #      In other words, does not have a CMakeLists.txt at root directory.
    # DOWNLOAD_ONLY YES
)

CPMAddPackage(
    NAME               cppcodec 
    GITHUB_REPOSITORY  tplgy/cppcodec 
    GIT_TAG            v0.2
    #VERSION            0.2 

    OPTIONS 
        "BUILD_TESTING OFF"
)
include_directories( ${cppcodec_SOURCE_DIR}/ )

message([TRACE] " spdlog source = ${spdlog_SOURCE_DIR} ")
message([TRACE] " cppcodec source = ${cppcodec_SOURCE_DIR} ")

#----------- Set targets -------------------------------#

add_executable(app1 app1.cpp)
target_link_libraries(app1 cppcodec spdlog::spdlog)

#include <iostream>
#include <spdlog/spdlog.h>

#include <cppcodec/base32_crockford.hpp>
#include <cppcodec/base64_rfc4648.hpp>


int main(int argc, char** argv)
{
    SPDLOG_TRACE("Entering function");

    spdlog::info("Starting server OK.");

    spdlog::info("Received request from 192.168.10.1 at port 9090");
    spdlog::info("Sending response to client 192.168.100.1 connection ID 10");

    using base32 = cppcodec::base32_crockford;
    using base64 = cppcodec::base64_rfc4648;

    std::string secret = "SGVsbG8gd29ybGQgQ01ha2UgQ1BNIHdpdGggYmFzZTY0IGVuY29uZGluZy4=";

    std::vector<uint8_t> decoded = base64::decode(secret);
    std::string text(decoded.begin(), decoded.end());

    std::cout << " =>> Decoded text = " << text << std::endl; 

    SPDLOG_TRACE("Exit application");

    return 0;
}

# Download code 
 $ git clone https://gist.github.com/caiorss/76b8540d8a358ab0c740709962e1e511 demo-cpm 
 $ cd demo-cpm

# [1] Configuration step 
 $ cmake -H. -B_build -DCMAKE_BUILD_TYPE=Debug
-- The C compiler identification is GNU 10.1.1
-- The CXX compiler identification is GNU 10.1.1
-- Check for working C compiler: /usr/bin/cc
  ... ....  ... ....  ... .... 
 ... ....  ... ....  ... .... 
-- CPM: adding package spdlog@ ()
-- Build type: Debug
-- CPM: adding package cppcodec@0.2 (v0.2)
[TRACE] spdlog source = /home/myuser/temp-projects/cmake-cpm/_build/_deps/spdlog-src 
[TRACE] cppcodec source = /home/myuser/temp-projects/cmake-cpm/_build/_deps/cppcodec-src 
-- Found PkgConfig: /usr/bin/pkg-config (found version "1.6.3") 
-- Checking for module 'catch2'
--   Package 'catch2', required by 'virtual:world', not found
-- Did NOT find system Catch2, instead using bundled version
-- Configuring done
-- Generating done
-- Build files have been written to: /home/myuser/temp-projects/cmake-cpm/_build

# [2] Building step 
$ cmake --build _build --target all

 $ _build/app1 
[2020-06-01 02:34:11.610] [info] Starting server OK.
[2020-06-01 02:34:11.610] [info] Received request from 192.168.10.1 at port 9090
[2020-06-01 02:34:11.610] [info] Sending response to client 192.168.100.1 connection ID 10
 =>> Decoded text = Hello world CMake CPM with base64 enconding

cmake_minimum_required(VERSION 3.5)
project(mingw-statically-linked)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_VERBOSE_MAKEFILE ON)


# ---------- T A R G E T S  ----------------------------#

# Executable linked dynamically against MinGW libraries
# It may fail to execute if the deployment machine
# does not have MINGW runtime libraries installed. 
       add_executable( winapp-dynam windows-application.cpp)
target_link_libraries( winapp-dynam stdc++fs )

# Executable statically linked against MingW runtinme  dependencies
# - which allows deploying it on any Windows machine.
#
# find_package( Threads REQUIRED)
add_executable( winapp-static windows-application.cpp)
target_link_libraries( winapp-static stdc++fs )

IF(MINGW)
   target_link_options( winapp-static PRIVATE                                 
                         -static-libgcc
                         -static-libstdc++
                         -Wl,-Bstatic,--whole-archive -lwinpthread -Wl,--no-whole-archive
                        )
ENDIF()       

#include <iostream>
#include <filesystem>

#include <windows.h>

namespace fs = std::filesystem;

void list_directory(std::string const& path);


int main()
{

    std::cerr << " [TRACE] Display root directory of current machine" << '\n';
    /* List root directory or C:\\ */
    list_directory("C:\\");

    std::fprintf(stderr, " [TRACE] Hello world MS-Windows.");
    OutputDebugStringA("Output of applications built for Window Subsystem");

    /*  Show messagebox window */
    DWORD const infoboxOptions  = MB_OK | MB_ICONINFORMATION | MB_SETFOREGROUND;
    MessageBoxA( nullptr, "Messagebox text", "MessageBox title", infoboxOptions);

    OutputDebugStringA("Exit application");

    std::cout << " => Type RETURN to exit" << std::endl;    
    std::cin.get();
    return 0;
}

void list_directory(std::string const& path)
{
  for(auto const& entry : fs::directory_iterator(path) )
  {
    auto p = entry.path();
    std::cout << " => Path = " << p.filename() << std::endl;          
  }
}

$ cmake -H. -B_build_mingw -DCMAKE_BUILD_TYPE=Debug -G "MinGW Makefiles"
$ cmake --build _build_mingw --target

# View build directory: 
$ ls _build_mingw\
cmake_install.cmake  CMakeFiles/  winapp-dynam.exe*
CMakeCache.txt       Makefile     winapp-static.exe*

$ docker run -it --rm -v $PWD:/cwd -w /cwd --entrypoint=bash dockcross/windows-static-x64
$ cmake -H. -B_build_cross_compile -DCMAKE_BUILD_TYPE=Debug
$ cmake --build _build_cross_compile --target

# View build directory 
[root:/cwd/cmake-mingw-project] # ls _build_cross_compile/
CMakeCache.txt  Makefile             winapp-dynam.exe
CMakeFiles      cmake_install.cmake  winapp-static.exe

# Execute on Windows 
$ _build_mingw\winapp-dynam.exe

 $ >> wine _build_mingw/winapp-dynam.exe  
002b:err:module:import_dll Library libgcc_s_seh-1.dll (which is needed by L"Z:\\home\\user\\Documents\\cmake-mingw-project\\_build_mingw\\winapp-dynam.exe") not found
002b:err:module:import_dll Library libstdc++-6.dll (which is needed by L"Z:\\home\\user\\Documents\\cmake-mingw-project\\_build_mingw\\winapp-dynam.exe") not found
002b:err:module:LdrInitializeThunk Importing dlls for L"Z:\\home\\user\\Documents\\cmake-mingw-project\\_build_mingw\\winapp-dynam.exe" failed, status c0000135

$ _build_mingw\winapp-static.exe

 [TRACE] Display root directory of current machine
 => Path = "$Recycle.Bin"
 => Path = "Config.Msi"
 => Path = "Documents and Settings"
 => Path = "hiberfil.sys"
 => Path = "pagefile.sys"
 => Path = "PerfLogs"
 => Path = "Program Files"
 => Path = "Program Files (x86)"
 => Path = "ProgramData"
 => Path = "Recovery"
 => Path = "swapfile.sys"
 => Path = "System Volume Information"
 => Path = "Temp"
 => Path = "Users"
 => Path = "Windows"
 [TRACE] Hello world MS-Windows. => Type RETURN to exit

$ >> wine _build_mingw/winapp-static.exe
[TRACE] Display root directory of current machine
=> Path = "Program Files"
=> Path = "Program Files (x86)"
=> Path = "ProgramData"
=> Path = "users"
=> Path = "windows"
[TRACE] Hello world MS-Windows. => Type RETURN to exit

// Icon Resource => Compiled by Resource compiler
id ICON "programImage.ico"

 # .... Omit beginning and global configuration .... #
  add_executable(ProgramWithICON src/main.cpp src/src1.cpp src/src2.cpp)
 if(WIN32)
    target_sources(ProgramWithICON src/icon.rc)
 endif()

 target_include_directories(ProgramWithICON  ./includes)
# .... Omit additional configuration ... #

cmake_minimum_required(VERSION 2.8)
project(cppwindows)

#=======================================

# Copy target file to current directory whenerver it is rebuilt
function(copy_after_build TARGET_NAME )
    # Note: CMAKE_CURRENT_LIST_DIR is the directory where is this
    # CMakeLists.txt file.
    set(DESTDIR ${CMAKE_CURRENT_LIST_DIR}/bin/)
    file(MAKE_DIRECTORY ${DESTDIR})

    # Copy binary file to <CMakeLists.txt didctory>./bin
    # after target is compiled.
    add_custom_command(TARGET ${TARGET_NAME} POST_BUILD
      COMMAND ${CMAKE_COMMAND} -E copy
                               $<TARGET_FILE:${TARGET_NAME}> ${DESTDIR}
                               )
endfunction()

#----------------------------------------

# Build the executable: app_console_subsystem.exe which opens a
# terminal when clicked
add_executable(app_console_subsystem main.cpp)
copy_after_build(app_console_subsystem)

# Builds the executable: app_window_subsystem.exe
# which does not open a terminal when clicked, it only shows
# a message box
add_executable(app_window_subsystem WIN32 main.cpp)
copy_after_build(app_window_subsystem)

#include <iostream>
#include <windows.h>

int main()
{
    std::cout << "Hello World Windows Console and Window subsystem!" << std::endl;
    OutputDebugStringA("Output of applications built for Window Subsystem");

    // Show messagebox window
    DWORD const infoboxOptions  = MB_OK | MB_ICONINFORMATION | MB_SETFOREGROUND;
    MessageBoxA( nullptr, "Messagebox text", "MessageBox title", infoboxOptions);

    std::cout << "Exit application " << std::endl;
    OutputDebugStringA("Exit application");

    std::cin.get();
    std::cout << " => Enter RETURN to exit" << std::endl;
    return 0;
}

add_executable(my-target src1.cpp src1.hpp src2.cpp src2.hpp ... )

IF(WIN32)
   set_property(TARGET my-target PROPERTY WIN32_EXECUTALE true)
ENDIF()

if(WIN32)
   set_target_properties(WindowApplicationExample PROPERTIES LINK_FLAGS_DEBUG "/SUBSYSTEM:CONSOLE")
   set_target_properties(WindowApplicationExample PROPERTIES COMPILE_DEFINITIONS_DEBUG "_CONSOLE")
   set_target_properties(WindowApplicationExample PROPERTIES LINK_FLAGS_RELWITHDEBINFO "/SUBSYSTEM:CONSOLE")
   set_target_properties(WindowApplicationExample PROPERTIES COMPILE_DEFINITIONS_RELWITHDEBINFO "_CONSOLE")
   set_target_properties(WindowApplicationExample PROPERTIES LINK_FLAGS_RELEASE "/SUBSYSTEM:WINDOWS")
   set_target_properties(WindowApplicationExample PROPERTIES LINK_FLAGS_MINSIZEREL "/SUBSYSTEM:WINDOWS")
endif(WIN32)

cmake_minimum_required(VERSION 3.5)
project(testbed_project)

#=========== Global Settings ==============================#
# ... omit other settings ... 

# Export ALL DLLs symbols on Windows without __declspec(xxxx) annotations.
set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS true)

#=============== Targets-specific settings ====================#

# Target: libutil (Library)
add_library(utils SHARED utils.cpp utils.hpp)

# Target: app1 => Executable (Dynamically linked)
add_executable(main main1.cpp)
target_link_libraries(main utils)

#ifndef _UTILS_HPP_
#define _UTILS_HPP_

#include <string>

namespace  utils {

     class Dummy{
     private:
          std::string m_name = "<Untitled>";
     public:
         Dummy();
         Dummy(std::string const& name);
         void  showName() const;
     };
}
#endif 

#include <iostream> 
#include "utils.hpp"

namespace utils{
      Dummy::Dummy() { }
      Dummy::Dummy(std::string const& name): m_name(name) { }

      void Dummy::showName() const
      {
          std::cout << " [TRACE] Object name is : " << m_name << "\n";
      }
}

class __declspec(dllexport) Dummy{
private:
     std::string m_name = "<Untitled>";
public:
    Dummy();
    Dummy(std::string const& name);
    void  showName() const;
};

 static void internal_function(int) {
   // ... code here ... 
 }

 static class InternalClass {
   // ... code here ... 
 }

 static struct MyStruct{
    double x; 
    double y;
 }; 

// ---- OR make the symbols private with anonymous namespace  ------// 

namespace {

   void internal_function(int) {
     // ... code here ... 
   }

   class InternalClass {
     // ... code here ... 
   }

   static struct MyStruct{
      double x; 
      double y;
   }; 

}

cmake_minimum_required(VERSION 3.5)
project(testbed_project)

#=========== Global Settings =================#

set(CMAKE_VERBOSE_MAKEFILE ON)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON) 

#  => Place executable(s) in ${SOURCE DIRECTORY}/out/bin 
#  => Place libraries in ${SOURCE DIRECTORY}/out/lib 
#
#  => Note: ${SOURCE DIRECTORY} is the directory where is this CMakeLists.txt 
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/out/lib)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/out/lib)
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}/out/bin)

# Set relative rpath to shared library in executable object code
# See:
#  => https://cmake.org/cmake/help/latest/prop_tgt/BUILD_RPATH_USE_ORIGIN.html
#  => https://gitlab.kitware.com/cmake/community/-/wikis/doc/cmake/RPATH-handling
if(UNIX)
  SET(CMAKE_INSTALL_RPATH "$ORIGIN/../lib:$ORIGIN/")
endif()

# Export ALL DLLs symbols on Windows without __declspec(xxxx) annotations.
set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS true)

#=============== Targets-specific settings ====================#

# Target: libutil (Library)
add_library(utils SHARED utils.cpp utils.hpp)
add_library(utils_static STATIC utils.cpp utils.hpp)

# Target: app1 => Executable (Dynamically linked)
add_executable(app1 main1.cpp)
target_link_libraries(app1 utils)

# Target: app2 => Executable (Dynamically linked)
add_executable(app2 main2.cpp)
target_link_libraries(app2 utils)

# Target: app1_static => Executable (static linked)
add_executable(app1_static main1.cpp)
target_link_libraries(app1_static utils_static)

# Target: app1_static => Executable (static linked)
add_executable(app2_static main1.cpp)
target_link_libraries(app2_static utils_static)


#============== Target: Install ===============================#
# Equivalent to: $ make install 

install(TARGETS app1 app2 app1_static app2_static utils utils_static  
  RUNTIME  DESTINATION bin # Executable: *.exe, 
  LIBRARY  DESTINATION lib # Shared libraries: *.dll, *.so and so on 
  ARCHIVE  DESTINATION lib # Static libraries: *.a 
)

install(FILES README.txt DESTINATION ./)

======= Application User Guide ==========

  + app1 => Application for creating PCB - Printed Circuit Board
  + app2 => App. for communicating with remote link

  <INSERT TEXT HERE ....>  

#ifndef _UTILS_HPP_
#define _UTILS_HPP_

#include <string>

namespace  utils {

     class Dummy{
     private:
          std::string m_name = "<Untitled>";
     public:
          Dummy();
          Dummy(std::string const& name);
          void  showName() const;
     };
}

#endif 

#include <iostream> 

#include "utils.hpp"

namespace utils{

     Dummy::Dummy() { }
     Dummy::Dummy(std::string const& name): m_name(name) { }

     void Dummy::showName() const
     {
         std::cout << " [TRACE] Object name is : " << m_name << "\n";
     }

}

#include <iostream>
#include "utils.hpp"

using utils::Dummy;

int main()
{
    std::puts(" [TRACE] I am the application 1. Ok.");
    Dummy dummy1("I_am_dummy_object_A");
    dummy1.showName();

    return 0;
}

#include <iostream>
#include "utils.hpp"

int main()
{
    std::puts(" [TRACE] I am the application 2. Ok.");
    utils::Dummy dummy2("I_am_dummy_object_B");
    dummy2.showName();

    return 0;
}

#  + (-B/tmp/_build2) => Place build tree at /tmp/_build2
#  + Install binaries (object-code) at ~/Desktop/appinstall
$ cmake -H. -B/tmp/_build2 -DCMAKE_INSTALL_PREFIX=~/Desktop/appinstall
$ cmake --build /tmp/build2 --target 

# List source/project directory 
$ ls .
out/  CMakeLists.txt  main1.cpp  main2.cpp  README.txt  utils.cpp  utils.hpp


$ tree .
.
├── CMakeLists.txt
├── main1.cpp
├── main2.cpp
├── out
│   ├── bin
│   │   ├── app1
│   │   ├── app1_static
│   │   ├── app2
│   │   └── app2_static
│   └── lib
│       ├── libutils.so
│       └── libutils_static.a
├── README.txt
├── utils.cpp
└── utils.hpp

3 directories, 12 files

$ out/bin/app1
 [TRACE] I am the application 1. Ok.
 [TRACE] Object name is : I_am_dummy_object_A

$ out/bin/app2
 [TRACE] I am the application 2. Ok.
 [TRACE] Object name is : I_am_dummy_object_B

$ out/bin/app1_static 
 [TRACE] I am the application 1. Ok.
 [TRACE] Object name is : I_am_dummy_object_A

$ out/bin/app2_static 
 [TRACE] I am the application 1. Ok.
 [TRACE] Object name is : I_am_dummy_object_A


# Check app1 dependencies 
$ ldd out/bin/app1
        linux-vdso.so.1 (0x00007ffff7ffa000)
        libutils.so => /home/archbox/shared/demo-cmake-proj2/out/lib/libutils.so (0x00007ffff7bd0000)
        libstdc++.so.6 => /lib64/libstdc++.so.6 (0x00007ffff783e000)
        libm.so.6 => /lib64/libm.so.6 (0x00007ffff74aa000)
        libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007ffff7292000)
        libc.so.6 => /lib64/libc.so.6 (0x00007ffff6ed4000)
        /lib64/ld-linux-x86-64.so.2 (0x00007ffff7dd6000)

# Check app1_static dependencies 
$ ldd out/bin/app2_static 
        linux-vdso.so.1 (0x00007ffff7ffa000)
        libstdc++.so.6 => /lib64/libstdc++.so.6 (0x00007ffff7a44000)
        libm.so.6 => /lib64/libm.so.6 (0x00007ffff76b0000)
        libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007ffff7498000)
        libc.so.6 => /lib64/libc.so.6 (0x00007ffff70da000)
        /lib64/ld-linux-x86-64.so.2 (0x00007ffff7dd6000)

$ cmake --build /tmp/_build2/ --target install

$ ls ~/Desktop/appinstall/
bin/  lib/  README.txt

$ tree ~/Desktop/appinstall/
├── bin
│   ├── app1
│   ├── app1_static
│   ├── app2
│   └── app2_static
├── lib
│   ├── libutils.so
│   └── libutils_static.a
└── README.txt

$ ~/Desktop/appinstall/bin/app1
 [TRACE] I am the application 1. Ok.
 [TRACE] Object name is : I_am_dummy_object_A

$ ~/Desktop/appinstall/bin/app2
 [TRACE] I am the application 2. Ok.
 [TRACE] Object name is : I_am_dummy_object_B

$ ~/Desktop/appinstall/bin/app1_static 
 [TRACE] I am the application 1. Ok.
 [TRACE] Object name is : I_am_dummy_object_A

$ ldd ~/Desktop/appinstall/bin/app1
        linux-vdso.so.1 (0x00007ffff7ffa000)
        libutils.so => /home/archbox/Desktop/appinstall/bin/../lib/libutils.so (0x00007ffff7bd0000)
        libstdc++.so.6 => /lib64/libstdc++.so.6 (0x00007ffff783e000)
        libm.so.6 => /lib64/libm.so.6 (0x00007ffff74aa000)
        libgcc_s.so.1 => /lib64/libgcc_s.so.1 (0x00007ffff7292000)
        libc.so.6 => /lib64/libc.so.6 (0x00007ffff6ed4000)
        /lib64/ld-linux-x86-64.so.2 (0x00007ffff7dd6000)

$ cmake -H. -B..\_build_proj -G "Visual Studio 15 2017 Win64" -DCMAKE_INSTALL_RPEFIX=%USERPROFILE%\appinstall
$ cmake --build ..\_build_proj --target 

λ ls
CMakeLists.txt  README.txt  main1.cpp  main2.cpp  out/  utils.cpp  utils.hpp

λ ls out\bin\Debug\
app1.exe*  app1.pdb          app1_static.ilk  app2.exe*  app2.pdb          app2_static.ilk  utils.dll*  utils.pdb
app1.ilk   app1_static.exe*  app1_static.pdb  app2.ilk   app2_static.exe*  app2_static.pdb  utils.ilk

λ out\bin\Debug\app1.exe
 [TRACE] I am the application 1. Ok.
 [TRACE] Object name is : I_am_dummy_object_A

λ out\bin\Debug\app2.exe
 [TRACE] I am the application 2. Ok.
 [TRACE] Object name is : I_am_dummy_object_B

λ out\bin\Debug\app1_static.exe
 [TRACE] I am the application 1. Ok.
 [TRACE] Object name is : I_am_dummy_object_A

λ cmake --build ..\_build_proj --target install

λ ls C:\\Users\archbox\appinstall\
README.txt  bin/  lib/

λ ls %USERPROFILE%\appinstall/bin
app1.exe*  app1_static.exe*  app2.exe*  app2_static.exe*  utils.dll*

λ ls %USERPROFILE%\appinstall/lib
utils.lib  utils_static.lib

λ type %USERPROFILE%\appinstall\README.txt
======= Application User Guide ==========

  + app1 => Application for creating PCB - Printed Circuit Board
  + app2 => App. for communicating with remote link

  <INSERT TEXT HERE ....>

cmake_minimum_required(VERSION 3.9)
project(ProjectWithUnixExtension)

#----------------------------------------------#

set(CMAKE_CXX_STANDARD 17)     
set(CMAKE_VERBOSE_MAKEFILE ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# Add file extension .bin to all executable files on Unix (Linux, OSX, BSD, ...)
if(UNIX)
  set(CMAKE_EXECUTABLE_SUFFIX ".bin")
endif()

#========== Targets Configurations ============#
add_executable(app1  main1.cpp)
add_executable(app2  main1.cpp src1.cpp src2.cpp src3.cpp)

cmake_minimum_required(VERSION 3.0)
project(cmake-glob)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_VERBOSE_MAKEFILE ON)

  #----------------------------------------------#
  #    mylib  => Library target                  #
  #----------------------------------------------#

# Assign all *.cpp files paths in the directory ./mylib 
# to the variable 'mylib_sources'. It allso includes the 
# subdirectories of ./mylib. 
file(GLOB_RECURSE mylib_sources "mylib/*.cpp")
file(GLOB_RECURSE mylib_headers "mylib/*.hpp")

add_library(mylib SHARED ${lib_sources} ${lib_headers} )
target_include_directories(mylib PUBLIC ./lib)

  #----------------------------------------------#
  #     main  => Executable target               #
  #----------------------------------------------#

# --> Assign the path of all *.cpp files in the directory 
#  ./main to the variable 'main_sources'
#  note: it does not include subdirectories. 
file(GLOB main_sources "main/*.cpp")
file(GLOB main_headers "main/*.hpp")

       add_executable( main ${main_sources} ${main_headers})
target_link_libraries( main mylib glut gl ... )

file(GLOB main_sources "main/*.cpp")

file(GLOB_RECURSE mylib_sources "mylib/*.cpp") 

# TARGET: testlib Shared library => Builds liblinalg.so on Unix or
# linalg.dll on Windows.
add_library(linalg SHARED  src/testlib.cpp)

# TARGET: app Executable => Builds 'app' on Unix-like Oses and
# unix.exe on Windows.
add_executable(app src/main/main-app.cpp src/main/file1.cpp src/main/file2.cpp)

# If not set the install directory, attemp set the install directory
# CMAKE_INSTALL_PREFIX to the directory ./bin 
if(NOT DEFINED CMAKE_INSTALL_PREFIX OR CMAKE_INSTALL_PREFIX MATCHES "")
  set(CMAKE_INSTALL_PREFIX  "./bin")
endif()

message(" [INFO] CMakeLists.txt is in the directory ${CMAKE_CURRENT_LIST_DIR}")

# Copy targets to ./ - Directory where is this file CMakeLists.txt (project top level dir)
install(TARGETS app linalg DESTINATION  ${CMAKE_CURRENT_LIST_DIR})

$ cd project-directory 

#===> Set build system 
# -H<SOURCE> -B<COMPILATION-OUTPUT> -G <BUILDING-SYSTEM>
$ cmake -H. -G "Unix Makefiles" -Bbuild 

#===> Run all targets [all default.]
$ cmake --build build --target all 

#===> Run target install and copy the binaries to ./bin 
$ cmake --build build --target install 

cmake_minimum_required(VERSION 3.9)

 ... ...  ... ...  ... ...

# TARGET: myapplication 
add_executable(myapplication src/main.cpp src/code1.cpp code2.cpp ...)

# TARGET: run -> Runs the executable myapplication 
# On Unix-like Oses, it runs  /<build-directory>/myapplication 
# On Windows: it runs  <build-directory>/myapplication.exe 
add_custom_target(run
    COMMAND myapplication
    DEPENDS myapplication
    WORKING_DIRECTORY ${CMAKE_PROJECT_DIR}
)

#===> Run all targets [all default.]
$ cmake --build build --target run

... ... 

if(MSVC)
   set_target_properties(WindowApp1 PROPERTIES LINK_FLAGS "/entry:mainCRTStartup")
else() 
   message(FATAL_ERROR " [ERROR] Linker flags of target WindowApp1 not set for this compiler")
endif()
... ... 

add_library( testlib  SHARED  ./testlib.cpp)
set_target_properties(testlib PROPERTIES CXX_VISIBILITY_PRESET hidden)

add_custom_command(TARGET testlib POST_BUILD
  COMMAND ${CMAKE_COMMAND} -E copy 
  $<TARGET_FILE:testlib>                     # Source    
  ${CMAKE_CURRENT_SOURCE_DIR}/libtest.so     # Destination, file or directory 
  # OR: ${CMAKE_CURRENT_SOURCE_DIR}/         # Directory destination. 
)

# Generate cache directory containing building scripts or project files 
# specifics for some building systems
$ cmake -H. -Bcache -G "CHOOSE SYSTEM>"

# Run all targets  [Default]
$ cmake --build cache --target
$ cmake --build cache --target all 

# Run target 'testlib'. 
$ cmake --build cache --target testlib 

#include <iostream>

int main(int argc, char** argv)
{

  std::cout << " [INFO] Hello world from application1" << std::endl;
  ::system("whoami");

  return 0;
}

cmake_minimum_required(VERSION 3.9)
project(Simple_Cmake_Project)

#========== Global Configurations =============#
#----------------------------------------------#
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_VERBOSE_MAKEFILE ON)

#========== Targets Configurations ============#
add_executable(app1 application1.cpp)

# Using Makefile (Linux)   
$ cmake -H. -B_build -G Ninja -DCMAKE_BUILD_TYPE=Debug \
   -DCMAKE_TOOLCHAIN_FILE=$HOME/Android/Sdk/ndk-bundle/build/cmake/android.toolchain.cmake \
   -DANDROID_ABI=armeabi-v7a \
   -DANDROID_NATIVE_API_LEVEL=21

# OR Using Ninja build generator 
$ cmake -H. -B_build -G Ninja -DCMAKE_BUILD_TYPE=Debug \
  -DCMAKE_TOOLCHAIN_FILE=$HOME/Android/Sdk/ndk-bundle/build/cmake/android.toolchain.cmake \
  -DANDROID_ABI=armeabi-v7a \
  -DANDROID_NATIVE_API_LEVEL=21

$ cmake --build _build --target all
[4/4] Linking CXX executable app1

# Check executable 
$ file _build/app1
_build/app1: ELF 32-bit LSB shared object, ARM, EABI5 version 1 (SYSV), dynamically linked, 
interpreter /system/, BuildID[sha1]=8d6b159e0e65604fe1f65bca5ad9eef36aa4ab26, with debug_info, not stripped

# Attempt to run => Fails because the current machine (host) is Linux
# x86_64 - 64 bits, not ARM 32 bits
$ _build/app1
bash: _build/app1: cannot execute binary file: Exec format error

$ adb push _build/app1 /data/local/tmp
_build/app1: 1 file pushed. 18.6 MB/s (2848980 bytes in 0.146s)

$ adb shell

on5xelte:/ $ /data/local/tmp/app1
 [INFO] Hello world from application1
shell

$ adb shell /data/local/tmp/app1
 [INFO] Hello world from application1
shell

if(CMAKE_SIZEOF_VOID_P EQUAL 8)
   message(" [INFO] 64 bits build.")
else()
   message(" [INFO] 32 bits build.")
endif()

# Configuration 
$ cmake -Bcache -DCMAKE_INSTALL_PREFIX=C:\\Users\Dummy\apps 

# Execute install target 
$ cmake --build cache --config Debug --target install 

message(" [INFO] Build type = ${CMAKE_BUILD_TYPE}")

if(CMAKE_SIZEOF_VOID_P EQUAL 8)
   message(" [INFO] Target = 64 bits build.")
else()
   message(" [INFO] Target = 32 bits build.")
endif()

message(" [INFO] Compiler ID = ${CMAKE_CXX_COMPILER_ID}")

message(" [INFO] System Name = ${CMAKE_SYSTEM_NAME} ")

message(" [INFO] CMake binary dir = ${CMAKE_BINARY_DIR}")

message(" [INFO] Install path CMAKE_INSTALL_PREFIX = ${CMAKE_INSTALL_PREFIX} ")

message(" [INFO]  System Name  - CMAKE_SYSTEM_NAME     = ${CMAKE_SYSTEM_NAME}")
message(" [INFO]  Build type   - CMAKE_BUILD_TYPE      = ${CMAKE_BUILD_TYPE}")
message(" [INFO]  Compiler ID  - CMAKE_CXX_COMPILER_ID = ${CMAKE_CXX_COMPILER_ID}")
message(" [INFO]  Install path - CMAKE_INSTALL_PREFIX  = ${CMAKE_INSTALL_PREFIX} ")
if(CMAKE_SIZEOF_VOID_P EQUAL 8)
   message(" [INFO] Target = 64 bits build.")
else()
   message(" [INFO] Target = 32 bits build.")
endif()
message(" [INFO] CMake binary dir = ${CMAKE_BINARY_DIR}")

set(CMAKE_BUILD_TYPE Debug) # Force debug build

#========= Global Configuration ===============# 
cmake_minimum_required(VERSION 3.9)
project(Demo_cpp_plugin)
set(CMAKE_CXX_STANDARD 17)     
set(CMAKE_VERBOSE_MAKEFILE ON)

# Force debug build
set(CMAKE_BUILD_TYPE Debug) # Force debug build

#========== Targets Configurations ============#

add_executable(app ... )
.. ... ... ... 

cmake_minimum_required(VERSION 3.9)
project(NumericalMethods)
set(CMAKE_CXX_STANDARD 17)     
set(CMAKE_VERBOSE_MAKEFILE ON)

set(FORCE_CLANG ON)
# Force compiler to Clang++
if(FORCE_CLANG)
    set(CMAKE_C_COMPILER clang)
    set(CMAKE_CXX_COMPILER clang++)
endif()

#========== Targets Configurations ============#

# TARGET: rootFinding1.cpp 
add_executable(rootFinding1 rootFinding1.cpp)

set(FORCE_CLANG ON)   # Force using clang compiler 
set(FORCE_CLANG OFF)  # Use default compiler 

# Force compiler to Clang++
if(FORCE_CLANG)
    set(CMAKE_C_COMPILER clang)
    set(CMAKE_CXX_COMPILER clang++)
endif()