Понимание структуры проекта Multiplatform

Плагин Multiplatform

При создании проекта Multiplatform мастер проекта автоматически применяет плагин kotlin-multiplatform Gradle в файле build.gradle(.kts).

Вы также можете применить его вручную.

plugins {
    kotlin("multiplatform") version "1.9.0"
}

plugins {
    id 'org.jetbrains.kotlin.multiplatform' version '1.9.0'
}

Плагин kotlin-multiplatform настраивает проект для создания приложения или библиотеки, работающей на нескольких платформах, и подготавливает его для сборки на этих платформах.

В файле build.gradle(.kts), он создаёт расширение kotlin на верхнем уровне, которое включает настройки для целей, наборов исходных кодов и зависимостей.

Цели

Проект Multiplatform ориентирован на множество платформ, которые представлены различными целями. Цель — часть сборки, отвечающая за сборку, тестирование и создание пакета приложения для конкретной платформы, например, macOS, iOS или Android. См. список поддерживаемых платформ.

При создании проекта Multiplatform цели добавляются в блок kotlin в файле build.gradle(.kts).

kotlin {
    jvm()    
    js {
        browser {}
    }
 }

Узнайте, как настроить цели вручную.

Наборы исходных кодов

Проект включает директорию src с наборами исходных кодов Kotlin, которые представляют собой коллекции файлов кода Kotlin, вместе с их ресурсами, зависимостями и настройками языка. Один набор исходных кодов может быть использован в компиляциях Kotlin для одной или нескольких целевых платформ.

Каждая директория набора исходных кодов включает файлы кода Kotlin (директория kotlin ) и resources. Мастер проекта создаёт стандартные наборы исходных кодов для main и test компиляций общего кода и всех добавленных целей.

Наборы исходных кодов добавляются в блок sourceSets верхнего уровня kotlin блока. Например, вот структура наборов исходных кодов, полученная при создании многоплатформенной библиотеки с помощью мастера проекта IntelliJ IDEA:

kotlin {
    sourceSets {
        val commonMain by getting
        val commonTest by getting {
            dependencies {
                implementation(kotlin("test"))
            }
        }
        val jvmMain by getting
        val jvmTest by getting
        val jsMain by getting
        val jsTest by getting
        val nativeMain by getting
        val nativeTest by getting
    }
}

kotlin {
    sourceSets {
        commonMain {

        }
        commonTest {
            dependencies {
                implementation kotlin('test')
            }
        }
        jvmMain {

        }
        jvmTest {

        }
        jsMain {

        }
        jsTest {

        }
        nativeMain {

        }
        nativeTest {

        }
    }
}

Наборы исходных кодов образуют иерархию, которая используется для совместного использования общего кода. В наборе исходных кодов, используемом несколькими целями, можно использовать платформенно-специфические языковые особенности и зависимости, которые доступны для всех этих целей.

Например, все функции Kotlin/Native доступны в наборе исходных кодов desktopMain, который нацелен на платформы Linux (linuxX64), Windows (mingwX64) и macOS (macosX64) .

Узнайте, как построить иерархию наборов исходных кодов.

Компиляции

Каждая цель может иметь одну или несколько компиляций, например, для целей производства и тестирования.

Для каждой цели стандартные компиляции включают:

• main и test компиляции для JVM, JS и Native целей.

• Компиляцию для каждой варианты сборки Android для Android целей.

Каждая компиляция имеет стандартный набор исходных кодов, который содержит исходные коды и зависимости, специфичные для этой компиляции.

Узнайте, как настроить компиляции.