Prerequisites
Ditto’s C++ Android Quickstart supports Android. Before getting started, ensure you have the following:
Get Started
1. Clone the Repository
- Open the terminal
- Clone the repository from GitHub.
git clone https://github.com/getditto/quickstart
- Navigate to the project directory:
cd quickstart
Get Ditto App ID, Playground Token, Auth URL, and Websocket URL
Add Ditto Credentials
- Copy the
.env.sample
file at the top level of the quickstart
repo to .env
and add your app ID and online playground token.
- Update the
.env
file with the App ID and Playground Token from your Ditto Application
DITTO_APP_ID="REPLACE_ME_WITH_YOUR_APP_ID"
DITTO_PLAYGROUND_TOKEN="REPLACE_ME_WITH_YOUR_PLAYGROUND_TOKEN"
DITTO_AUTH_URL="REPLACE_ME_WITH_YOUR_AUTH_URL"
DITTO_WEBSOCKET_URL="REPLACE_ME_WITH_YOUR_WEBSOCKET_URL"
Download, Unpack, and Link Ditto
-
Navigate to the project directory
cd android-cpp/QuickStartTasksCPP
-
Download Ditto.tar.gz
and unpack an archive containing the libditto.a
static library and Ditto header.
curl -O https://software.ditto.live/cpp-linux-x86_64/Ditto/4.8.2/dist/Ditto.tar.gz && tar xvfz Ditto.tar.gz
-
Add the ./sdk
directory to your compiler’s include and linker directories, and link the
ditto library into your application. For example:
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
3. Run the Application
- Launch Android Studio and open the
quickstart/cpp-android
directory.
- In Android Studio, select a connected Android device, or create and launch an Android emulator and select it as the destination, then choose the
Run > Run 'app'
menu item.
4. Sync-Data Offline
- Launch the application on multiple devices or simulators
- Disconnect from your current WiFi network while keeping WiFi enabled on the device to allow for LAN connections
- Add, edit, and delete tasks and experience offline collaboration!
Next Steps
All the Ditto Quickstart apps works together! Try running a quickstart app in other languages and see them all collaborate.
Additional Resources
Responses are generated using AI and may contain mistakes.