Installing C++ SDK

You can integrate the Ditto SDK into C++ projects to develop for Linux and iOS platforms.
For a complete overview of the platforms, transports, and devices the C++ SDK supports, see Compatibility with C++﻿.
To install the C++ SDK:
1
Fetch and extract the Ditto package. (Downloading and Unpacking Ditto﻿) 
2
Configure your app to link to the Ditto static library. (Linking to Ditto﻿)
Downloading and Unpacking Ditto
Download Ditto.tar.gz and unpack an archive containing the libditto.a static library and Ditto header:
Linux x86_64
Linux aarch64
curl -O https://software.ditto.live/cpp-linux-aarch64/Ditto/4.3.0/dist/Ditto.tar.gz && tar xvfz Ditto.tar.gz
curl -O https://software.ditto.live/cpp-linux-aarch64/Ditto/4.3.0/dist/Ditto.tar.gz && tar xvfz Ditto.tar.gz
﻿
Linking to Ditto
Add -lditto as a compilation step in the main.cpp source file: 
For instructions on adding cross-platform Bluetooth Low Energy (LE) capabilities, see Installing Bluetooth on Linux﻿.
BlueZ is the official Bluetooth protocol stack implementation for Linux systems to communicate with other Bluetooth-enabled platforms.
Linux
iOS
# This command assumes:
# You have unzipped the Ditto.tar.gz in a relative directory ./sdk/
# Your main code entry point is in ./src/main.cpp

g++ -std=c++17 ./src/main.cpp -I ./sdk -lditto -ldl -lrt -pthread -L ./sdk -o dist/main;

 # Once executed, your output will be available at: ./dist/main
# This command assumes:
# You have unzipped the Ditto.tar.gz in a relative directory ./sdk/
# Your main code entry point is in ./src/main.cpp

g++ -std=c++17 ./src/main.cpp -I ./sdk -lditto -ldl -lrt -pthread -L ./sdk -o dist/main;

 # Once executed, your output will be available at: ./dist/main
﻿
Importing Ditto
From the source code of your app, using #include <Ditto.h>,  import Ditto and provide your access credentials:
For instructions on how to obtain your access credentials, see Onboarding﻿. For an introduction to authentication in Ditto, see Ditto Basics > Authentication and Initialization﻿.
C++
auto identity =
    Identity::OnlinePlayground("YOUR_APP_ID", "PLAYGROUND_TOKEN", true);
try {
  Ditto ditto = Ditto(identity, dir);
  ditto.set_minimum_log_level(LogLevel::debug);
  ditto.start_sync();
} catch (const DittoError &err) {
}
auto identity =
    Identity::OnlinePlayground("YOUR_APP_ID", "PLAYGROUND_TOKEN", true);
try {
  Ditto ditto = Ditto(identity, dir);
  ditto.set_minimum_log_level(LogLevel::debug);
  ditto.start_sync();
} catch (const DittoError &err) {
}
﻿
﻿
Updated 11 Mar 2024
Did this page help you?
Compatibility with C++
Release Notes