feat: add basic chat app, that sends and receives messages using `Cha…

…tApi`

example/build.gradle.kts

@@ -1,3 +1,7 @@
+import java.io.FileInputStream
+import java.io.InputStreamReader
+import java.util.Properties
+
 plugins {
     alias(libs.plugins.android.application)
     alias(libs.plugins.android.kotlin)
@@ -19,6 +23,8 @@ android {
         vectorDrawables {
             useSupportLibrary = true
         }
+
+        buildConfigField("String", "ABLY_KEY", "\"${getLocalProperty("ABLY_KEY") ?: ""}\"")
     }
 
     buildTypes {
@@ -38,6 +44,7 @@ android {
         jvmTarget = "1.8"
     }
     buildFeatures {
+        buildConfig = true
         compose = true
     }
     composeOptions {
@@ -68,3 +75,13 @@ dependencies {
     debugImplementation(libs.androidx.ui.tooling)
     debugImplementation(libs.androidx.ui.test.manifest)
 }
+
+fun getLocalProperty(key: String, file: String = "local.properties"): String? {
+    val properties = Properties()
+    val localProperties = File(file)
+    if (!localProperties.isFile) return null
+    InputStreamReader(FileInputStream(localProperties), Charsets.UTF_8).use { reader ->
+        properties.load(reader)
+    }
+    return properties.getProperty(key)
+}

example/src/main/java/com/ably/chat/example/MainActivity.kt

@@ -4,24 +4,52 @@ import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
 import androidx.activity.enableEdgeToEdge
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Row
 import androidx.compose.foundation.layout.fillMaxSize
 import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.material3.Button
 import androidx.compose.material3.Scaffold
 import androidx.compose.material3.Text
+import androidx.compose.material3.TextField
 import androidx.compose.runtime.Composable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.rememberCoroutineScope
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
-import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.text.input.TextFieldValue
+import androidx.compose.ui.unit.dp
+import com.ably.chat.ChatApi
+import com.ably.chat.Message
+import com.ably.chat.QueryOptions
+import com.ably.chat.RealtimeClient
+import com.ably.chat.SendMessageParams
 import com.ably.chat.example.ui.theme.AblyChatExampleTheme
+import io.ably.lib.types.ClientOptions
+import kotlinx.coroutines.launch
 
 class MainActivity : ComponentActivity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
+        val realtimeClient = RealtimeClient(
+            ClientOptions().apply {
+                key = BuildConfig.ABLY_KEY
+                clientId = "my-client-id"
+                logLevel = 2
+            },
+        )
+        val chatApi = ChatApi(realtimeClient)
         enableEdgeToEdge()
         setContent {
             AblyChatExampleTheme {
                 Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
-                    Greeting(
-                        name = "Android",
+                    AblyChat(
+                        chatApi,
                         modifier = Modifier.padding(innerPadding),
                     )
                 }
@@ -31,17 +59,59 @@ class MainActivity : ComponentActivity() {
 }
 
 @Composable
-fun Greeting(name: String, modifier: Modifier = Modifier) {
-    Text(
-        text = "Hello $name!",
-        modifier = modifier,
-    )
-}
+fun AblyChat(chatApi: ChatApi, modifier: Modifier = Modifier) {
+    var messageText by remember { mutableStateOf(TextFieldValue("")) }
+    var sending by remember { mutableStateOf(false) }
+    var messages by remember { mutableStateOf(listOf<Message>()) }
+    val coroutineScope = rememberCoroutineScope()
 
-@Preview(showBackground = true)
-@Composable
-fun GreetingPreview() {
-    AblyChatExampleTheme {
-        Greeting("Android")
+    val roomId = "my-room"
+
+    Column(
+        modifier = Modifier.fillMaxSize(),
+        verticalArrangement = Arrangement.SpaceBetween,
+    ) {
+        Button(modifier = modifier.align(Alignment.CenterHorizontally), onClick = {
+            coroutineScope.launch {
+                messages = chatApi.getMessages(roomId, QueryOptions()).items
+            }
+        }) {
+            Text("Load")
+        }
+
+        LazyColumn(
+            modifier = Modifier.weight(1f).padding(16.dp),
+        ) {
+            items(messages.size) { index ->
+                Text(text = messages[index].text)
+            }
+        }
+
+        Row(
+            modifier = Modifier.padding(16.dp),
+            horizontalArrangement = Arrangement.spacedBy(8.dp),
+        ) {
+            TextField(
+                value = messageText,
+                onValueChange = { messageText = it },
+                modifier = Modifier.weight(1f),
+                readOnly = sending,
+            )
+            Button(enabled = !sending, onClick = {
+                sending = true
+                coroutineScope.launch {
+                    chatApi.sendMessage(
+                        roomId,
+                        SendMessageParams(
+                            text = messageText.text,
+                        ),
+                    )
+                    messageText = TextFieldValue("")
+                    sending = false
+                }
+            }) {
+                Text("Send")
+            }
+        }
     }
 }

gradle.properties

@@ -14,4 +14,6 @@ org.gradle.parallel=true
 # AndroidX package structure to make it clearer which packages are bundled with the
 # Android operating system, and which are packaged with your app's APK
 # https://developer.android.com/topic/libraries/support-library/androidx-rn
-android.useAndroidX=true
+android.useAndroidX=true
+
+android.enableBuildConfigAsBytecode=true