Kotlin и OSGi

Для включения поддержки Kotlin OSGi в вашем проекте Kotlin, используйте kotlin-osgi-bundle вместо обычных библиотек Kotlin. Рекомендуется удалить зависимости kotlin-runtime, kotlin-stdlib и kotlin-reflect, так как kotlin-osgi-bundle уже содержит их все. Также следует обратить внимание на случай включения внешних библиотек Kotlin. Большинство обычных зависимостей Kotlin не поддерживают OSGi, поэтому их не следует использовать и нужно удалить из вашего проекта.

Maven

Для включения пакета Kotlin OSGi в проект Maven:

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-osgi-bundle</artifactId>
        <version>${kotlin.version}</version>
    </dependency>
</dependencies>

Чтобы исключить стандартную библиотеку из внешних библиотек (обратите внимание, что «звездочное исключение» работает только в Maven 3):

<dependency>
    <groupId>some.group.id</groupId>
    <artifactId>some.library</artifactId>
    <version>some.library.version</version>

    <exclusions>
        <exclusion>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>*</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle

Для включения kotlin-osgi-bundle в проект Gradle:

dependencies {
    implementation(kotlin("osgi-bundle"))
}

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-osgi-bundle:1.9.0"
}

Чтобы исключить стандартные библиотеки Kotlin, которые входят в качестве транзитивных зависимостей, можно использовать следующий подход:

dependencies {
    implementation("some.group.id:some.library:someversion") {
        exclude(group = "org.jetbrains.kotlin")
    }
}

dependencies {
    implementation('some.group.id:some.library:someversion') {
        exclude group: 'org.jetbrains.kotlin'
    }
}

Вопросы и ответы

Почему бы просто не добавить необходимые параметры манифеста ко всем библиотекам Kotlin

Хотя это предпочтительный способ предоставления поддержки OSGi, к сожалению, это пока невозможно из-за так называемой проблемы «разделения пакетов», которую сложно устранить, и такие радикальные изменения пока не планируются. Есть Require-Bundle функция, но и она не является лучшим вариантом и не рекомендуется к использованию. Поэтому было решено создать отдельный артефакт для OSGi.

Последнее изменение: 03 апреля 2023

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