Installation

Add the Vizco Android SDK to your project with Gradle.

The Vizco Android SDK provides a Jetpack Compose composable that renders published widgets natively in your Android app.

Requirements

| Requirement | Minimum | |---|---| | Android SDK | 24 (Android 7.0) | | Kotlin | 1.9+ | | Jetpack Compose | 2024.12.01 BOM or later | | Java | 17 |

Gradle setup

Add the Vizco SDK dependency to your app-level build.gradle.kts:

app/build.gradle.kts
dependencies {
  implementation("com.vizco:vizco-sdk:1.0.0")
}

The SDK brings the following transitive dependencies:

  • Ktor (OkHttp engine) — HTTP client for API calls
  • Coil — Image loading with AsyncImage
  • kotlinx-serialization — JSON parsing
  • Jetpack Compose Foundation — Layout primitives

Compose setup

Make sure Compose is enabled in your app module:

app/build.gradle.kts
android {
  buildFeatures {
      compose = true
  }
}

plugins {
  id("org.jetbrains.kotlin.plugin.compose")
  id("org.jetbrains.kotlin.plugin.serialization")
}

Permissions

The SDK requires internet access. Add this to your AndroidManifest.xml if not already present:

AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET" />

Sync and verify

After adding the dependency, sync your Gradle project. You should be able to import:

import com.vizco.sdk.Vizco
import com.vizco.sdk.ui.VizcoWidget

Next steps