https://github.com/labs64/netlicensingclient-cpp
C++ wrapper for Labs64 NetLicensing RESTful API
https://github.com/labs64/netlicensingclient-cpp
activation hacktoberfest labs64 license license-management licensing netlicensing wrapper
Last synced: about 1 year ago
JSON representation
C++ wrapper for Labs64 NetLicensing RESTful API
- Host: GitHub
- URL: https://github.com/labs64/netlicensingclient-cpp
- Owner: Labs64
- License: apache-2.0
- Created: 2016-01-12T09:11:13.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-10-31T10:39:07.000Z (over 1 year ago)
- Last Synced: 2025-03-21T13:23:20.198Z (about 1 year ago)
- Topics: activation, hacktoberfest, labs64, license, license-management, licensing, netlicensing, wrapper
- Language: C++
- Homepage: https://netlicensing.io
- Size: 241 KB
- Stars: 10
- Watchers: 6
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# [Labs64 NetLicensing](https://netlicensing.io) Client (C++)
[](https://github.com/Labs64/NetLicensingClient-cpp/actions/workflows/netlicesning-client-ci.yml)
[](https://github.com/Labs64/NetLicensingClient-cpp/blob/master/LICENSE)
[](https://netlicensing.io/wiki/restful-api)
[](https://www.linkedin.com/showcase/netlicensing)
C++ wrapper for Labs64 NetLicensing [RESTful API](https://netlicensing.io/wiki/restful-api)
Visit Labs64 NetLicensing at https://netlicensing.io
## Dependencies
1. C++11 toolset + STL
2. cmake
3. [libcurl](https://github.com/curl/curl) (with libcurl's transitive dependencies)
4. [jsoncpp](https://github.com/open-source-parsers/jsoncpp) (included)
5. [boost](https://www.boost.org/) (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](https://github.com/Labs64/NetLicensingClient-cpp.git) 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](https://cmake.org/cmake/help/latest/))
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](https://github.com/Labs64/NetLicensingClient-cpp.git) 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```
3. In the `NetLicensingClient-cpp` directory create `build/` subdirectory
4. Execute:
```
cd NetLicensingClient-cpp/build
cmake ..
make
```
### Unit tests
Unit tests require [**Boost**](https://www.boost.org) 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](#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](#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)