Skip to content

Latest commit

 

History

History
115 lines (82 loc) · 4.83 KB

README.md

File metadata and controls

115 lines (82 loc) · 4.83 KB
Raw

Innovative License Management Solution

Labs64 NetLicensing Client (C++)

Build Status Apache License 2.0 📖 Documentation NetLicensing @ LinkedIn

C++ wrapper for Labs64 NetLicensing RESTful API

Visit Labs64 NetLicensing at https://netlicensing.io

Dependencies

  1. C++11 toolset + STL
  2. cmake
  3. libcurl (with libcurl's transitive dependencies)
  4. jsoncpp (included)
  5. boost (optional, needed for unit tests)

Compatibility

Notes:

  • Building NetLicensing C++ client library with static linking is currently not supported, feel free to contribute.
  • Builds verified with libcurl version 7.64.0 and cmake version 3.13.4.

Verified builds:

Platform Build toolset
Windows 7 Visual studio 14 2015 x86 - x64
Windows 7 Visual studio 15 2017 x86 - x64
Windows 10 Visual studio 14 2015 x86 - x64
Windows 10 Visual studio 15 2017 x86 - x64
macOS Mojave Xcode 10.1

Windows build

Build curl

  1. Download curl from https://github.com/curl/curl/releases
  2. cd curl_directory\winbuild
  3. Read BUILD_WINDOWS.txt for building instructions
  4. In VC command prompt execute: 
    nmake /f Makefile.vc VC=15 MACHINE=x64 ENABLE_WINSSL=yes MODE=dll
    (replace VC and MACHINE with your actual version / platform)
  5. If you get the error U1073 or U1077 - execute curl_directory\buildconf.bat first and repeat the nmake command
  6. Your curl build directory will be in sub directory builds\

Build NetLicensing C++ client

  1. Download the latest release and unpack to NetLicensingClient-cpp (or checkout master to build the latest development version)
  2. In the NetLicensingClient-cpp directory create build\ subdirectory
  3. Specify curl location using CMAKE_PREFIX_PATH=your_curl_build_directory. curl build directory must contain bin, include, and lib subdirs.
  4. In VC command prompt execute: 
     cd NetLicensingClient-cpp\build
 cmake .. -G "Visual Studio 15 2017 Win64" -DCMAKE_PREFIX_PATH=your_curl_build_directory
    (replace -G argument with your actual version / platform, see cmake documentation)
  5. Open solution created in NetLicensingClient-cpp\build directory in Visual Studio and build the library and demo client.

Linux build

Build NetLincesing-cpp

  1. Download the latest release and unpack to NetLicensingClient-cpp (or checkout master to build the latest development version)
  2. Install libcurl (for development, including C headers and libraries). E.g. in Ubuntu: sudo apt-get install libcurl4-openssl-dev
  3. Install boost: sudo apt-get install libboost-all-dev
  4. In the NetLicensingClient-cpp directory create build/ subdirectory
  5. Execute: 
     cd NetLicensingClient-cpp/build
 cmake ..
 make

Unit tests

Unit tests require Boost Unit Test Framework. To build project with the unit tests activated add cmake option -DBUILD_TESTS=yes. The tests must be executed from tests/ subdirectory on Linux or tests\Debug\ on Windows in order to properly locate the JSON files with test data.

Linux build using docker

TODO: full description

  1. Prepare container

    • Image: ubuntu:22.04
    • apt-get update
    • apt-get install cmake g++ libcurl4-openssl-dev libboost-all-dev

  2. Map NetLicensingClient-cpp or clone it inside the container

  3. Build as described in Linux Build

MacOS build

TODO: full description

  1. Prepare environment:

    • Install XCode 10.1+
    • Install homebrew
    • libcurl is provided
    • brew install cmake boost

  2. Build as described in Linux Build

Execution environment

libcurl dynamic library should be either installed system-wide or otherwise available for the loading at run-time (typically located in the same directory as your executable)