Follow the steps below to get started with chat example app
Ensure you have the following installed:
- Android Studio (latest stable version)
- Java 17 or higher
- Android SDK with API Level 34 or higher
Add your Ably key to the local.properties
file:
sdk.dir=/path/to/android/sdk
ABLY_KEY=xxxx:yyyyyy
-
Open in Android Studio
- Open Android Studio.
- Select File > Open and navigate to the cloned repository.
- Open the project.
-
Sync Gradle
- Wait for Gradle to sync automatically.
- If it doesn’t, click on Sync Project with Gradle Files in the toolbar.
-
Configure an Emulator or Device
- Set up an emulator or connect a physical Android device.
- Ensure the device is configured with at least Android 5.0 (API 21).
-
Run the App
- Select your emulator or connected device in the device selector dropdown.
- Click on the Run button
▶️ in the toolbar or press Shift + F10.
-
View the App
Once the build is complete, the app will be installed and launched on the selected device or emulator.
- SDK Not Found: Install missing SDK versions from File > Settings > Appearance & Behavior > System Settings > Android SDK.
- Build Failures: Check the error logs and resolve dependencies or configuration issues.