Skip to content
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Readme.md

Native Suspended Functions - Generates a wrapper with a callback for suspended functions for Kotlin Native to consume

Kotlin License Download PRs Welcome Tweet

Introduction

As suspended functions aren't visible from Kotlin Native I created this plugin that adds support for annotating existing functions with @NativeSuspendedFunction. The plugin will find these methods and generate a Kotlin source code file that uses callbacks that can be used from Kotlin Native.

Additionally you may use @NativeFlowFunction to generate a wrapper around a function that returns a Flow - something that Kotlin Native also cannot handle right now.

This plugin uses mpapt-runtime from Jens Klingenberg: https://github.com/Foso/MpApt

Example

Class with annotated suspended function:

class CommonAnnotated {

    @NativeSuspendedFunction
    internal suspend fun firstFunction2(id: Datum, type: Double?): Int {
        return 0
    }
    
    @ExperimentalCoroutinesApi
    @NativeFlowFunction
    fun subscribeToMowerChanges(test: Int): Flow<CoroutineScope> {
        return callbackFlow {
            offer(GlobalScope)
        }
    }

}

Generated extension:

internal fun CommonAnnotated.firstFunction2(
    id: Datum,
    type: Double?,
    callback: (SuspendResult<Int>) -> Unit
) = mainScope.launch {
    callback(suspendRunCatching<Int> { firstFunction2(id, type) })
}

@ExperimentalCoroutinesApi
fun CommonAnnotated.testFlowFunction(test: Int, callback: (CoroutineScope) -> Unit) =
    GlobalScope.launch {
        testFlowFunction(test).collect {
            callback(it)
        }
    }

The class SuspendResult is an implementation of https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-result/index.html that was made compatible with Kotlin Native (no inline functions etc.)

Currently the plugin only supports:

  • copying over annotations
  • parameters + their nullability (no default values)

Please check other limitations on https://github.com/Foso/MpApt

Feel free to open tickets for new features.

Usage

Inside your projects build.gradle(.kts) add the following plugin:

repositories {
    jcenter()
}

plugins {
   id("native-suspend-function") version "1.0.18"
    // or as dependency: "de.ffuf.kotlin.multiplatform.processor:nativesuspendfunction:1.0.18"
}

// also add the annotations as dependency:
dependencies {
    // multiplatform binaries are ready - please have a look at the example project
    implementation("de.ffuf.kotlin.multiplatform.annotations:annotations:1.0.18")
}

and in your pluginManagement:

pluginManagement {
    repositories {
        // ....
        jcenter()
    }
    // ....
    resolutionStrategy {
        eachPlugin {
            // ....
            if (requested.id.id == "native-suspend-function") {
                useModule("de.ffuf.kotlin.multiplatform.processor:nativesuspendfunction:${requested.version}")
            }
        }
    }
}

Configuration

The compiler plugin unfortunately won't be able to resolve all needed imports but you may add them in the configuration:

nativeSuspendExtension {
    outputDirectory = "src/commonMain/kotlin" // this is the default output directory for the generated extension file (without package)
    scopeName = "mainScope" // in our case we use a CoroutineScope called "mainScope" - don#t forget to import that location 
    imports = listOf("test.import.package") // additional imports for the generated file
    packageName = "de.ffuf.kotlin.extensions" //allows configuring the package name of the generated file
}

Release notes

For unknown reasons, uploading the kotlin-plugin doesn't upload the buildSrc package as well. So, publish it to mavenLocal first, then manually upload those files to: /de/ffuf/kotlin/multiplatform/processor/nativesuspendfunction/1.0.**

License

This project is licensed under the Apache License, Version 2.0 - see the LICENSE.md file for details


Copyright 2019 FFUF

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

About

Kotlin Multiplatform compiler plugin to generate a callback implementation for suspended functions so they are visible from Kotlin Native

Resources

License

Packages

No packages published

Languages