Kotlin Multiplatform

We recommend integrating the Breez SDK as Gradle dependency from our Maven repository.

Add the Breez Maven repository to your settings.gradle.kts:

pluginManagement {
    repositories {
        maven("https://mvn.breez.technology/releases")
    }
}

dependencyResolutionManagement {
    repositories {
        maven("https://mvn.breez.technology/releases")
    }
}

Then add the dependency in your module's build.gradle.kts:

kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("technology.breez.spark:breez-sdk-spark-kmp:{VERSION}")
        }
    }
}

Integration

iOS

Install the native binary framework via Swift Package Manager. The Gradle plugin automatically configures the framework search path from Xcode's build environment.

Add the Gradle plugin to your module's build.gradle.kts and update the iOS framework binaries to use a dynamic framework:

plugins {
    id("technology.breez.spark.kmp") version "{VERSION}"
}

kotlin {
    listOf(
        iosArm64(),
        iosSimulatorArm64(),
        iosX64(),
    ).forEach {
        it.binaries.framework {
            baseName = "shared"
            isStatic = false
        }
    }
}

Swift Package Manager

Installation via Xcode

Via File > Add Packages..., add

https://github.com/breez/breez-sdk-spark-swift.git

as a package dependency in Xcode.

Installation via Swift Package Manifest

Add the following to the dependencies array of your Package.swift:

.package(url: "https://github.com/breez/breez-sdk-spark-swift.git", from: "{VERSION}"),

Custom Framework Path

If the automatic framework detection doesn't work for your setup, you can override it by setting the breezSdkSparkFrameworkPath project property to the directory containing breez_sdk_sparkFFI.framework.

In gradle.properties:

breezSdkSparkFrameworkPath=/path/to/framework/dir

Or via the command line:

./gradlew build -PbreezSdkSparkFrameworkPath=/path/to/framework/dir