kotlin-multiplatform

Thin bridge delegating to native SDKs for offer presentation, user identification, attribute management, purchase lifecycle, passthrough events, and configurable claim UI with suspendable placement API.

#service-sdk
#sdk
#kotlin-native
#kotlin-coroutines
#gradle
#client
#apple

Suggest an edit

Android JVMKotlin/Native

GitHub stars0

AuthorsEncoreKit

Open issues0

Creation date16 days ago

Last activityabout 13 hours ago

Latest release0.1.3 (8 days ago)

GitHub repository Wiki page

Encore KMP SDK

Kotlin Multiplatform SDK for Encore — thin bridge delegating to native iOS and Android SDKs.

Installation

Gradle (KMP / Android)

// build.gradle.kts
dependencies {
    implementation("com.encorekit:encore-kmp:0.1.0")
}

iOS (CocoaPods)

The iOS target is distributed via the KMP cocoapods plugin. In your KMP project's build.gradle.kts:

cocoapods {
    pod("EncoreKit") { version = "1.4.36" }
}

Quick Start

Common (Shared Code)

import com.encorekit.kmp.Encore
import com.encorekit.kmp.models.PresentationResult

// Identify user
Encore.identify(userId = "user_123")

// Show placement
val result = Encore.placement("cancel_flow").show()
when (result) {
    is PresentationResult.Granted -> println("Offer accepted: ${result.offerId}")
    is PresentationResult.NotGranted -> println("Declined: ${result.reason.value}")
}

Android Setup

// Application.onCreate()
Encore.configure(context = this, apiKey = "pk_xxx")

// Activity.onCreate()
Encore.setActivity(this)

// Activity.onDestroy()
Encore.setActivity(null)

iOS Setup

// In common or iOS-specific code
Encore.configure(apiKey = "pk_xxx")

The iOS target requires CocoaPods. The EncoreKMPBridge pod (included in iosHelper/) wraps the Swift-only EncoreKit APIs for Kotlin/Native cinterop.

Platform-Specific Setup

Android

Context: Pass applicationContext in configure() — required for the native SDK
Activity: Set via Encore.setActivity(activity) — required for presenting offer UI
Min SDK: 26

iOS

CocoaPods: The KMP cocoapods plugin generates a pod from the shared module
Deployment Target: iOS 15.0
Bridge: iosHelper/EncoreKMPBridge.swift provides @objc wrappers for cinterop

API Reference

Method	Description
`Encore.configure(apiKey, logLevel?)`	Initialize the SDK
`Encore.identify(userId, attributes?)`	Set current user
`Encore.setUserAttributes(attributes)`	Update user attributes
`Encore.reset()`	Clear user state
`Encore.placement(id?).show()`	Present an offer (suspend)
`Encore.placements.setClaimEnabled(bool)`	Enable/disable claim UI
`Encore.onPurchaseRequest { request -> }`	Handle purchase requests
`Encore.onPurchaseComplete { result, id -> }`	Handle purchase completions
`Encore.onPassthrough { placementId -> }`	Handle passthrough events

Development

make test           # Run all tests
make build          # Build all targets
make publish-local  # Publish to ~/.m2 for local testing
make demo-android   # Build Android demo APK
make demo-ios       # Build iOS demo for simulator
make release        # Interactive release flow

Architecture

commonMain/          Public API (Encore object, models, expect classes)
androidMain/         Delegates to com.encorekit:encore (Maven Central)
iosMain/             Delegates to EncoreKMPBridge → EncoreKit (CocoaPods)
iosHelper/           Swift @objc bridge for cinterop

The SDK is a thin bridge (~600 LOC) with zero business logic — all behavior is delegated to the native SDKs.