It is template for multiplatform project which you can use for simple start of your own library
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
InsanusMokrassar deba42332a
Update libs.versions.toml
2 weeks ago
.github/workflows Update build.yml 2 months ago
.templates update dependencies and add ModuleGenerator templates 1 month ago
gradle Update libs.versions.toml 2 weeks ago
lib improve lib and add template for libs 9 months ago
.gitignore updates and migration onto toml 1 year ago
LICENSE Initial commit 3 years ago
README.md update android part 7 months ago
build.gradle updates and migration onto toml 1 year ago
defaultAndroidSettings.gradle update android part 7 months ago
extensions.gradle add mppJsProject 2 years ago
gradle.properties updates and migration onto toml 1 year ago
gradlew init 3 years ago
gradlew.bat init 3 years ago
mppAndroidProject.gradle updates and migration onto toml 1 year ago
mppJavaProject.gradle Update mppJavaProject.gradle 11 months ago
mppJsProject.gradle updates and migration onto toml 1 year ago
mppProjectWithSerialization.gradle Update mppProjectWithSerialization.gradle 11 months ago
settings.gradle fixes 1 year ago

README.md

How to use

That is a template for Kotlin Multiplatform Projects. How to use it:

  • Create your repository from this template
  • Add local.properties file in case you plan to use Android target (you must set up location of SDK, it will not be tracked by git and it is correct behaviour). In the snippet below you may see approximate content of local.properties file:
## This file must *NOT* be checked into Version Control Systems,
# as it contains information specific to your local configuration.
#
# Location of the SDK. This is only used by Gradle.
# For customization when using a Version Control System, please read the
# header note.
sdk.dir=/your/path/to/android/sdk
  • Replace in a whole project project_group by your group
  • Replace in a whole project project_name by your ROOT project name
  • Update your subproject packages. It is not critical, but recommended especially in case you plan to publish your library

Subprojects

In this template there is only one subproject with name lib. You are always able to rename it, but remember that in this case you must rename it in settings.gradle file.

JVM sources in Android target

By default JVM code is not included in Android target. In case you wish to include JVM sources in Android build, use next method in the sourceSets section of your build.gradle:

kotlin {
    sourceSets {
        // Some other code
        androidMain {
            // Some other code (like dependencies)
            dependsOn jvmMain
        }
    }
}

In case when you need to be sure that JVM sources are not included in Android part, just remove line with dependsOn jvmMain

Types of projects

mppProjectWithSerialization

This type of preset have JVM, JS and Android targets and available using apply from: "$mppProjectWithSerializationPresetPath". Template for project with this preset looks like next snippet:

plugins {
    id "org.jetbrains.kotlin.multiplatform"
    id "org.jetbrains.kotlin.plugin.serialization"
    id "com.android.library"
}

apply from: "$mppProjectWithSerializationPresetPath"

// The code below is optional

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                // common dependencies
            }
        }
        commonTest {
            dependencies {
                // common test dependencies
            }
        }
        jvmMain {
            dependencies {
                // jvm dependencies
            }
        }
        jvmTest {
            dependencies {
                // jvm test dependencies
            }
        }
        jsMain {
            dependencies {
                // js dependencies
            }
        }
        jsTest {
            dependencies {
                // js test dependencies
            }
        }
        androidMain {
            dependencies {
                // android dependencies
            }
        }
        androidTest {
            dependencies {
                // android test dependencies
            }
        }
    }
}

mppJavaProject

This type of preset have only JVM target and available using apply from: "$mppJavaProjectPresetPath". Template for project with this preset looks like next snippet:

plugins {
    id "org.jetbrains.kotlin.multiplatform"
}

apply from: "$mppJavaProjectPresetPath"

// The code below is optional

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                // common dependencies
            }
        }
        commonTest {
            dependencies {
                // common test dependencies
            }
        }
        jvmMain {
            dependencies {
                // jvm dependencies
            }
        }
        jvmTest {
            dependencies {
                // jvm test dependencies
            }
        }
    }
}

mppJsProject

This type of preset have only JS target and available using apply from: "mppJsProjectPresetPath". Template for project with this preset looks like next snippet:

plugins {
    id "org.jetbrains.kotlin.multiplatform"
}

apply from: "$mppJsProjectPresetPath"

// The code below is optional

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                // common dependencies
            }
        }
        commonTest {
            dependencies {
                // common test dependencies
            }
        }
        jsMain {
            dependencies {
                // jvm dependencies
            }
        }
        jsTest {
            dependencies {
                // jvm test dependencies
            }
        }
    }
}

mppAndroidProject

This type of preset have only Android target and available using apply from: "$mppAndroidProjectPresetPath". Template for project with this preset looks like next snippet:

plugins {
    id "org.jetbrains.kotlin.multiplatform"
    id "com.android.library"
}

apply from: "$mppAndroidProjectPresetPath"

// The code below is optional

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                // common dependencies
            }
        }
        commonTest {
            dependencies {
                // common test dependencies
            }
        }
        androidMain {
            dependencies {
                // android dependencies
            }
        }
        androidTest {
            dependencies {
                // android test dependencies
            }
        }
    }
}