Bridge the Native API

The bridge is a folder of Swift files that acts as the glue between your Swift/Apple SDK code and Kotlin. The plugin compiles these files and exposes them to Kotlin via cinterop.

How It Works

When syncing the project, the plugin creates the bridge folder at:

• src/swift/[cinteropName] — when cinteropName is set
• src/swift/[targetName] — otherwise (e.g. src/swift/iosArm64)

Everything inside this folder is copied to the build directory and compiled into the bridge.

Gradle Configuration

A minimal bridge setup — no external dependencies, just the Apple native SDK:

kotlin {
    listOf(
        iosArm64(),
        iosSimulatorArm64()
        // and more Apple targets...
    ).forEach { target ->
        target.swiftPackageConfig(cinteropName = "[cinteropName]") {
        }
    }
}

swiftPackageConfig {
    create("[cinteropName]") {
    }
}

Writing Your Bridge

import UIKit

@objcMembers public class MySwiftBridge: NSObject {
    public func exportedMethod() -> String {
        return "value"
    }
    public func exportedView() -> NSObject {
        return UIView()
    }
}

import [cinteropName].MySwiftBridge

val contentFromSwift = MySwiftBridge().exportedMethod()

val aView = MySwiftBridge().exportedView() as UIView

Bundle Resources (since v1.9.0)

To bundle resources (images, fonts, data files, etc.) alongside your bridge:

1. Choose a resource type and create the corresponding folder:

1. Place your files in the chosen folder (e.g. bridgeString.txt)
2. Access them from Swift using Bundle.module:

let url = Bundle.module.url(forResource: "bridgeString", withExtension: "txt")