swift-klib-plugin - GitLite

KO | EN

gitlite — search

#python #llm #android #machine-learning #deep-learning #linux #macos #nodejs #java #cli #awesome-list #pytorch #mcp #open-source

swift-klib-plugin

(★ 364)

Gradle Plugin for injecting Swift code into Kotlin Multiplatform Mobile shared module

파일 탐색기

최종 버전 다운로드 (.zip)

- - Release.yml
  - Test.yml
- - swiftklib-dark.svg
  - swiftklib-light.svg
- - .gitignore
  - build.gradle.kts
  - gradle.properties
  - gradlew
  - gradlew.bat
  - settings.gradle.kts
- - build.gradle.kts
  - gradle.properties
  - gradlew
  - gradlew.bat
  - settings.gradle.kts
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- libs.versions.toml
- build.gradle.kts
.editorconfig
.gitignore
build.gradle.kts
CHANGELOG.md
gradle.properties
gradlew
gradlew.bat
LICENSE
README.md
settings.gradle.kts

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/ttypic/swift-klib-plugin

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd swift-klib-plugin

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

url = uri("https://plugins.gradle.org/m2/")

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="https://github.com/ttypic/swift-klib-plugin/raw/main/docs/media/swiftklib-light.svg" alt="Swift Klib library logo" width="300">

# Swift Klib Gradle Plugin

![badge-ios](https://img.shields.io/badge/platform-ios-light)
![badge-mac](https://img.shields.io/badge/platform-macos-light)
![badge-tvos](https://img.shields.io/badge/platform-tvos-light)
![badge-watchos](https://img.shields.io/badge/platform-watchos-light)

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](https://docs.gradle.org/current/userguide/plugins.html#sec:plugins_block):

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

Using [legacy plugin application](https://docs.gradle.org/current/userguide/plugins.html#sec:old_plugin_application):

```kotlin
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).
```properties
#Kotlin Multiplatform
kotlin.mpp.enableCInteropCommonization=true

```

## Usage

Plugin works together with [Kotlin Multiplatform plugin](https://plugins.gradle.org/plugin/org.jetbrains.kotlin.multiplatform).

### 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](https://lazarevzubov.medium.com/compatible-with-objective-c-swift-code-e7c3239d949).

```swift
@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
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.

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

### Examples

- More samples can be found in the [examples/](https://github.com/ttypic/swift-klib-plugin/tree/main/examples) folder.
- Component demonstrating a multipurpose Kotlin Multiplatform and Swift Package audio player: [radioplayer-kt](https://github.com/markst/radioplayer-kt)

## License

This package is licensed under MIT license.