Skip to content

Android Development

James Maes edited this page Dec 28, 2025 · 1 revision

Android Development

Native Android client library for QQQ applications. Build Android apps that connect to QQQ backends with typed clients and metadata-aware components.

Quick Links

Status

Experimental - Core functionality is under development. API may change.

Overview

QQQ applications expose REST APIs that any client can consume. The Android library provides:

Feature Description
API Client Typed Kotlin client for QQQ REST endpoints
Metadata Loading Fetch table and field definitions at runtime
Record Operations Query, insert, update, delete records
Process Execution Run backend processes from Android

Prerequisites

  • Android Studio
  • Android SDK 26+
  • QQQ backend running (local or deployed)

Installation

Add to your build.gradle:

dependencies {
    implementation 'io.qrun:qqq-android:0.1.0'
}

Quick Start

Configure Client

val client = QqqClient.Builder()
    .baseUrl("https://your-qqq-app.com")
    .authToken("your-api-token")
    .build()

Query Records

val orders = client.query("order")
    .filter("status", "pending")
    .limit(20)
    .execute()

Modify Records

// Create
val newOrder = client.insert("order", mapOf(
    "customerName" to "Acme Corp",
    "total" to 100.00
))

// Update
client.update("order", 123, mapOf(
    "status" to "shipped"
))

// Delete
client.delete("order", 123)

Run Processes

client.runProcess("orderSync")

Roadmap

Feature Status
Core API client In Progress
Offline caching Planned
Background sync Planned
UI components Planned
Kotlin coroutines Planned

See Also

Clone this wiki locally