C++ Console App Quickstart

​

Prerequisites

Ditto’s C++ Console App Quickstart supports Linux only. Before getting started, ensure you have the following:

• Git installed on your machine
• A C++ compiler (such as Clang or GCC)
• If using GCC (g++), version 11 or newer is needed
• CMake (version 3.15.3 or later)
• Make (for building the project)
• A Ditto Portal account with a configured Ditto Database (see Getting SDK Connection Details)

​

Get Started

​

1. Clone the Repository

​

2. Configure Ditto

​

Get Ditto Database ID, Playground Token, and Auth URL

​

Add Ditto Credentials

1. Copy the .env.sample file at the top level of the quickstart repo to .env and add your app ID and online playground token.
   cp .env.sample .env
   
2. Update the .env file with the Database ID and Playground Token from your Ditto Database
   DITTO_APP_ID="REPLACE_ME_WITH_YOUR_DATABASE_ID"
   DITTO_PLAYGROUND_TOKEN="REPLACE_ME_WITH_YOUR_PLAYGROUND_TOKEN"
   DITTO_AUTH_URL="REPLACE_ME_WITH_YOUR_AUTH_URL"
   

​

Download, Unpack, and Link Ditto

1. Navigate to the sdk subdirectory of the project directory
   cd cpp-tui/taskscpp/sdk
   
2. Download Ditto.tar.gz and unpack an archive containing the libditto.a static library and Ditto header.
   x86_64

   aarch64

   curl -O https://software.ditto.live/cpp-linux-x86_64/Ditto/5.0.2/dist/Ditto.tar.gz && tar xvfz Ditto.tar.gz
   

   curl -O https://software.ditto.live/cpp-linux-aarch64/Ditto/5.0.2/dist/Ditto.tar.gz && tar xvfz Ditto.tar.gz
   

​

3. Run the Application

1. Navigate back to the project directory
   cd ..
   
2. Build the application
   make build
   
3. Run the application
   ./build/taskscpp
   

​

4. Sync-Data Offline

​

Next Steps

All the Ditto Quickstart apps works together! Try running a quickstart app in other languages and see them all collaborate.

​

Additional Resources

• C++ Install Guide
• C++ Release Notes
• API Reference