Добавление зависимостей для многоплатформенных библиотек

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

Чтобы добавить зависимость от библиотеки, обновите ваш файл build.gradle(.kts) в каталоге shared вашего проекта. Установите зависимость нужного типа (например, implementation) в блоке dependencies:

kotlin {
    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation("com.example:my-library:1.0") // library shared for all source sets
            }
        }
    }
}

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                implementation 'com.example:my-library:1.0'
            }
        }
    }
}

В качестве альтернативы, вы можете установить зависимости на верхнем уровне.

Зависимость от библиотеки Kotlin

Стандартная библиотека

Зависимость от стандартной библиотеки (stdlib) в каждом наборе исходного кода добавляется автоматически. Версия стандартной библиотеки совпадает с версией плагина kotlin-multiplatform.

Для платформно-специфических наборов исходного кода используется соответствующий платформно-специфический вариант библиотеки, в то время как общая стандартная библиотека добавляется в остальные. Плагин Kotlin Gradle выберет соответствующую JVM-стандартную библиотеку в зависимости от compilerOptions.jvmTarget варианта компилятора вашего скрипта Gradle.

Узнайте, как изменить поведение по умолчанию.

Библиотеки для тестирования

Для многоплатформенных тестов доступен kotlin.test API. Когда вы создаете многоплатформенный проект, мастер проекта автоматически добавляет тестовые зависимости в общие и платформенно-специфические наборы исходного кода.

Если вы не использовали мастер проекта для создания проекта, вы можете добавить зависимости вручную.

Библиотеки kotlinx

Если вы используете многоплатформенную библиотеку и вам нужно зависеть от общего кода, установите зависимость только один раз в общем наборе исходного кода. Используйте имя базового артефакта библиотеки, например kotlinx-coroutines-core.

kotlin {
    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4")
            }
        }
    }
}

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4'
            }
        }
    }
}

Если вы используете библиотеку kotlinx и вам нужна платформно-специфическая зависимость, вы можете использовать платформно-специфические варианты библиотек с суффиксами, такими как -jvm или -js, например, kotlinx-coroutines-core-jvm.

kotlin {
    sourceSets {
        val jvmMain by getting {
            dependencies {
                implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core-jvm:1.6.4")
            }
        }
    }
}

kotlin {
    sourceSets {
        jvmMain {
            dependencies {
                implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core-jvm:1.6.4'
            }
        }
    }
}

Зависимость от многоплатформенных библиотек Kotlin

Вы можете добавить зависимости от библиотек, которые приняли технологию Kotlin Multiplatform, например, SQLDelight. Авторы этих библиотек обычно предоставляют руководства по добавлению своих зависимостей в ваш проект.

Посмотрите на этот поддерживаемый сообществом список многоплатформенных библиотек Kotlin.

Библиотека, общая для всех наборов исходного кода

Если вы хотите использовать библиотеку из всех наборов исходного кода, вы можете добавить её только в общий набор исходного кода. Плагин Kotlin Multiplatform Mobile автоматически добавит соответствующие части кода во все остальные наборы исходного кода.

kotlin {
    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation("io.ktor:ktor-client-core:2.2.1")
            }
        }
        val androidMain by getting {
            dependencies {
                // dependency to a platform part of ktor-client will be added automatically
            }
        }
    }
}

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                implementation 'io.ktor:ktor-client-core:2.2.1'
            }
        }
        androidMain {
            dependencies {
                // dependency to platform part of ktor-client will be added automatically
            }
        }
    }
}

Библиотека, используемая в определённых наборах исходного кода

Если вы хотите использовать многоплатформенную библиотеку только для определённых наборов исходного кода, вы можете добавить её только в них. Тогда указанные объявления библиотек будут доступны только в этих наборах исходного кода.

kotlin {
    sourceSets {
        val commonMain by getting {
            dependencies {
                // kotlinx.coroutines will be available in all source sets
                implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4")
            }
        }
        val androidMain by getting {
            dependencies {}
        }
        val iosMain by getting {
            dependencies {
                // SQLDelight will be available only in the iOS source set, but not in Android or common
                implementation("com.squareup.sqldelight:native-driver:1.5.4")
            }
        }
    }
}

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                // kotlinx.coroutines will be available in all source sets
                implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4'
            }
        }
        androidMain {
            dependencies {}
        }
        iosMain {
            dependencies {
                // SQLDelight will be available only in the iOS source set, but not in Android or common
                implementation 'com.squareup.sqldelight:native-driver:1.5.4'
            }
        }
    }
}

Зависимость от другого многоплатформенного проекта

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

kotlin {
    sourceSets {
        val commonMain by getting {
            dependencies {
                implementation(project(":some-other-multiplatform-module"))
            }
        }
        val androidMain by getting {
            dependencies {
                // platform part of :some-other-multiplatform-module will be added automatically
            }
        }
    }
}

kotlin {
    sourceSets {
        commonMain {
            dependencies {
                implementation project(':some-other-multiplatform-module')
            }
        }
        androidMain {
            dependencies {
                // platform part of :some-other-multiplatform-module will be added automatically
            }
        }
    }
}

Что дальше?

Посмотрите другие ресурсы о добавлении зависимостей в многоплатформенных проектах и узнайте больше о:

Последнее изменение: 10 января 2023

© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/multiplatform-add-dependencies.html