Extract kotlin artifacts public API.

2022-04-12 10:06:35 +02:00
parent 19dc91135c
commit 3085f6bacf
9 changed files with 424 additions and 328 deletions
@@ -0,0 +1,137 @@
+/*
+ * Copyright 2010-2022 JetBrains s.r.o. and Kotlin Programming Language contributors.
+ * Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
+ */
+
+package org.jetbrains.kotlin.gradle.dsl
+
+import org.gradle.api.*
+import org.gradle.api.plugins.ExtensionAware
+import org.jetbrains.kotlin.gradle.plugin.mpp.BitcodeEmbeddingMode
+import org.jetbrains.kotlin.gradle.plugin.mpp.NativeBuildType
+import org.jetbrains.kotlin.konan.target.KonanTarget
+
+interface KotlinArtifact : Named, ExtensionAware {
+    val artifactName: String
+    val modules: Set<Any>
+    val taskName: String
+    fun registerAssembleTask(project: Project)
+}
+
+interface KotlinNativeArtifact : KotlinArtifact {
+    val modes: Set<NativeBuildType>
+    val isStatic: Boolean
+    val linkerOptions: List<String>
+    val kotlinOptionsFn: KotlinCommonToolOptions.() -> Unit
+    val binaryOptions: Map<String, String>
+}
+
+interface KotlinNativeLibrary : KotlinNativeArtifact {
+    val target: KonanTarget
+}
+
+interface KotlinNativeFramework : KotlinNativeArtifact {
+    val target: KonanTarget
+    val embedBitcode: BitcodeEmbeddingMode?
+}
+
+interface KotlinNativeFatFramework : KotlinNativeArtifact {
+    val targets: Set<KonanTarget>
+    val embedBitcode: BitcodeEmbeddingMode?
+}
+
+interface KotlinNativeXCFramework : KotlinNativeArtifact {
+    val targets: Set<KonanTarget>
+    val embedBitcode: BitcodeEmbeddingMode?
+}
+
+interface KotlinArtifactConfig {
+    val artifactName: String
+    val modules: Set<Any>
+    fun setModules(vararg project: Any)
+    fun addModule(project: Any)
+    fun createArtifact(extensions: ExtensionAware): KotlinArtifact
+}
+
+interface KotlinNativeArtifactConfig : KotlinArtifactConfig {
+    var modes: Set<NativeBuildType>
+    fun modes(vararg modes: NativeBuildType)
+    var isStatic: Boolean
+    var linkerOptions: List<String>
+    fun kotlinOptions(fn: Action<KotlinCommonToolOptions>)
+    fun binaryOption(name: String, value: String)
+}
+
+interface KotlinNativeLibraryConfig : KotlinNativeArtifactConfig {
+    var target: KonanTarget
+}
+
+interface KotlinNativeFrameworkConfig : KotlinNativeArtifactConfig {
+    var target: KonanTarget
+    var embedBitcode: BitcodeEmbeddingMode?
+}
+
+interface KotlinNativeFatFrameworkConfig : KotlinNativeArtifactConfig {
+    var targets: Set<KonanTarget>
+    fun targets(vararg targets: KonanTarget)
+    var embedBitcode: BitcodeEmbeddingMode?
+}
+
+interface KotlinNativeXCFrameworkConfig : KotlinNativeArtifactConfig {
+    var targets: Set<KonanTarget>
+    fun targets(vararg targets: KonanTarget)
+    var embedBitcode: BitcodeEmbeddingMode?
+}
+
+interface KotlinArtifactsExtension {
+    //Extending by external plugins:
+    //
+    //project.kotlinArtifactsExtension.apply {
+    //    artifactConfigs.all {
+    //      //add custom extension to artifact config DSL
+    //      (it as ExtensionAware).extensions.create("myConfig", Config::class.java)
+    //    }
+    //    artifacts.all {
+    //      val config = it.extensions.findByName("myConfig") as Config
+    //      //configure additional tasks, etc
+    //      //here we can use artifact parameters
+    //    }
+    //}
+    val artifactConfigs: DomainObjectSet<KotlinArtifactConfig>
+    val artifacts: NamedDomainObjectSet<KotlinArtifact>
+    val Native: KotlinNativeArtifactDSL
+}
+
+interface KotlinNativeArtifactDSL {
+    @RequiresOptIn(
+        message = "This API is experimental. It may be changed in the future.",
+        level = RequiresOptIn.Level.WARNING
+    )
+    @Retention(AnnotationRetention.BINARY)
+    @Target(AnnotationTarget.FUNCTION)
+    annotation class ExperimentalArtifactDsl
+
+    @ExperimentalArtifactDsl
+    fun Library(name: String, configure: Action<KotlinNativeLibraryConfig>)
+
+    @ExperimentalArtifactDsl
+    fun Library(configure: Action<KotlinNativeLibraryConfig>)
+
+    @ExperimentalArtifactDsl
+    fun Framework(name: String, configure: Action<KotlinNativeFrameworkConfig>)
+
+    @ExperimentalArtifactDsl
+    fun Framework(configure: Action<KotlinNativeFrameworkConfig>)
+
+    @ExperimentalArtifactDsl
+    fun FatFramework(name: String, configure: Action<KotlinNativeFatFrameworkConfig>)
+
+    @ExperimentalArtifactDsl
+    fun FatFramework(configure: Action<KotlinNativeFatFrameworkConfig>)
+
+    @ExperimentalArtifactDsl
+    fun XCFramework(name: String, configure: Action<KotlinNativeXCFrameworkConfig>)
+
+    @ExperimentalArtifactDsl
+    fun XCFramework(configure: Action<KotlinNativeXCFrameworkConfig>)
+}