This content is for SDK V4. App and App ID are now called Database and Database ID in SDK v5 and the Ditto Portal. The SDK v4 API names and the environment variable names used by the v4 quickstarts are unchanged. For the latest version, see the V5 documentation.
Prerequisites
Ditto’s Java Android Quickstart supports Android. Before getting started, ensure you have the following:- Android Studio (Ladybug or later) installed
- Git installed on your machine
- A Ditto Portal account with a configured Ditto Database (see Getting SDK Connection Details)
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
2. Configure Ditto
Get Ditto Database ID, Playground Token, Auth URL, and Websocket URL
- Log in to your Ditto Portal account
- Navigate to your database and obtain the Ditto Database ID, Development Token, and URL. (see Getting SDK Connection Details for more details)
Add Ditto Credentials
- Navigate to
app/src/main/java/com/example/dittotasks/MainActivity.java - Update the following variables with the Database ID and Playground Token from your Ditto Database
3. Run the Application
- Launch Android Studio and open the
quickstart/android-javadirectory - 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!