README.md

Swift Klib Gradle Plugin

This gradle plugin provides easy way to include your Swift source files in your Kotlin Multiplatform Mobile shared module and access them in Kotlin via cinterop for iOS targets. It is useful for:

• Accessing Swift-only libraries (e.g. CryptoKit)
• Creating a Kotlin-Friendly Swift API
• Learning how Swift <-> Kotlin interoperability works

Note: Plugin has been tested on Gradle 7.5+, Xcode 15+

Installation

Using the plugins DSL:

plugins {
    id("io.github.ttypic.swiftklib") version "0.6.4"
}

Using legacy plugin application:

buildscript {
  repositories {
    maven {
      url = uri("https://plugins.gradle.org/m2/")
    }
  }
  dependencies {
    classpath("io.github.ttypic:plugin:0.6.4")
  }
}

apply(plugin = "io.github.ttypic.swiftklib")

Add this to the project-level gradle.properties file (if it’s not already included).

#Kotlin Multiplatform
kotlin.mpp.enableCInteropCommonization=true

Usage

Plugin works together with Kotlin Multiplatform plugin.

Prepare Swift code

Place your Swift files inside your project in separate folder (e.g. native/HelloSwift).

Make sure that Swift API you want to expose to Kotlin is compatible with Objective-C.

@objc public class HelloWorld : NSObject {
    @objc public class func helloWorld() -> String {
        return "HeLLo WorLd!"
    }
}

Setup swiftklib extension

Then you need to add cinterop for target platforms in your Kotlin Multiplatform Plugin. There is no need to configure it or add .def file, all configuration will be done automatically by Swift Klib.

kotlin {
    listOf(
        iosX64(),
        iosArm64(),
        iosSimulatorArm64(),
    ).forEach {
        it.compilations {
            val main by getting {
                cinterops {
                    create("HelloSwift")
                }
            }
        }
    }

    //...
}

And finally provide settings for it in swiftklib extension. You need to specify path and packageName parameters.

swiftklib {
    create("HelloSwift") {
        path = file("native/HelloSwift")
        packageName("com.ttypic.objclibs.greeting")
    }
}

Examples

• More samples can be found in the examples/ folder.
• Component demonstrating a multipurpose Kotlin Multiplatform and Swift Package audio player: radioplayer-kt

License

This package is licensed under MIT license.