After you have completed the common prerequisites you will need the following:
- Android Studio Ladybug or newer
Assuming you have Android Studio and other prerequisites installed, you can build and run the app by following these steps:
- Create an application at https://portal.ditto.live/. Make note of the app ID and online playground token.
- Copy the
.env.sample
file at the top level of thequickstart
repo to.env
and add your App ID, Online Playground Token, Auth URL, and Websocket URL. - Launch Android Studio and open the
quickstart/android-java
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.
The app will build and run on the selected device or emulator. You can add, edit, and delete tasks in the app.
If you run the app on additional devices or emulators, the data will be synced between them.
Compatible with Android Automotive OS (AAOS)
The Android app is a simple to-do list app that demonstrates how to use the Ditto Android SDK to sync data with other devices. It is implemented using Java and Jetpack Compose, which is a modern toolkit for building native Android UI.
It is assumed that the reader is familiar with Android development and with Compose, but needs some guidance on how to use Ditto. The following is a summary of the key parts of integration with Ditto.
In app/build.gradle.kts
, you will see this line that causes Android Studio
to download the Ditto SDK from Maven Central and add it to the project:
implementation(libs.ditto)
This line in gradle/libs.versions.toml
specifies which version of the Ditto
SDK to use:
ditto = "4.10.0"
To use a newer version of the SDK, change the version number on this line.