This section describes how to set up a native client development environment using C++ and CMake.
This walkthrough assumes that certain components are in place:
System | Native Client Library Well-Known Location |
---|---|
Linux | /usr/local/nativeclient |
Windows | C:\Program Files\nativeclient |
The CMake tool suite. Download and install CMake, following the instructions on cmake.org.
Geode: Install and configure Geode. See the Geode User’s Guide for instructions and system requirements.
To develop a Native Client application using C++ and CMake:
Create a project directory structure. In this example, the project is called MyProject. The directory structure provides a place for your application source files and a cmake
modules directory for project-specific CMake files:
MyProject/
cmake/
FindGemFireNative.cmake
CMakeLists.txt
main.cpp
Change directory to MyProject and create your application sources. In this example, we have one source file, main.cpp
.
Copy the FindGemFireNative.cmake
script from one of the Native Client examples to the cmake
subdirectory.
Create CMakeLists.txt. Copy the file from an example, if you like, as a starting point. The CMakeLists.txt file should contain the following CMake instructions:
cmake_minimum_required(VERSION 3.10)
project(MyProject LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 11)
FindGemFireNative.cmake
script is located and an instruction telling CMake to use it:set(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)
find_package(GemFireNative REQUIRED COMPONENTS cpp)
add_executable(MyProject main.cpp)
target_link_libraries(MyProject
PUBLIC
GemFireNative::cpp)
Combined, the above elements comprise the following CMakeLists.txt:
# CMakeLists.txt for C++ Native Client App
cmake_minimum_required(VERSION 3.10)
project(MyProject LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)
find_package(GemFireNative REQUIRED COMPONENTS cpp)
add_executable(MyProject main.cpp)
target_link_libraries(MyProject
PUBLIC
GemFireNative::cpp)
Create a build directory and set it as your current directory:
$ mkdir build
$ cd build
Run CMake twice, once to configure the build, then again to perform the build, generating the executable application.
$ cmake ..
$ cmake --build .
This creates the executable application in your build directory.