Kotlin/Native FAQ

Как запустить мою программу?

Определите функцию верхнего уровня fun main(args: Array<String>) или просто fun main(), если вы не заинтересованы в переданных аргументах. Пожалуйста, убедитесь, что она не находится в пакете. Также, можно использовать компиляторный переключатель -entry, чтобы сделать любую функцию, принимающую Array<String> или не принимающую аргументов и возвращающую Unit, точкой входа.

Какая модель управления памятью используется в Kotlin/Native?

Kotlin/Native использует автоматическую схему управления памятью, аналогичную той, что используется в Java или Swift.

Узнайте подробнее о менеджере памяти Kotlin/Native

Как создать общую библиотеку?

Используйте компиляторный переключатель -produce dynamic или binaries.sharedLib() в Gradle.

kotlin {
    iosArm64("mylib") {
        binaries.sharedLib()
    }
}

Это позволит сгенерировать платформо-специфичный общий объект (.so на Linux, .dylib на macOS и .dll на Windows) и заголовок на языке C, что позволит использовать все публичные API вашего приложения Kotlin/Native из кода C/C++.

Как создать статическую библиотеку или файл объекта?

Используйте компиляторный переключатель -produce static или binaries.staticLib() в Gradle.

kotlin {
    iosArm64("mylib") {
        binaries.staticLib()
    }
}

Это позволит сгенерировать платформо-специфичный статический объект (в формате библиотеки .a) и заголовок на языке C, позволяющий использовать все публичные API вашего приложения Kotlin/Native из кода C/C++.

Как запустить Kotlin/Native через корпоративный прокси?

Так как Kotlin/Native необходимо загрузить платформо-специфичный инструментарий, вам нужно указать -Dhttp.proxyHost=xxx -Dhttp.proxyPort=xxx в качестве аргументов компилятора или gradlew, или установить его через переменную окружения JAVA_OPTS.

Как задать пользовательское префиксное имя Objective-C для моего фреймворка Kotlin?

Используйте параметр компилятора -module-name или соответствующее утверждение Gradle DSL.

kotlin {
    iosArm64("myapp") {
        binaries.framework {
            freeCompilerArgs += listOf("-module-name", "TheName")
        }
    }
}

kotlin {
    iosArm64("myapp") {
        binaries.framework {
            freeCompilerArgs += ["-module-name", "TheName"]
        }
    }
}

Как переименовать фреймворк iOS?

По умолчанию имя фреймворка iOS равно <project name>.framework. Для установки пользовательского имени используйте опцию baseName. Это также установит имя модуля.

kotlin {
    iosArm64("myapp") {
       binaries {
          framework {
              baseName = "TheName"
          }
       }
    }
}

Как включить bitcode для моего фреймворка Kotlin?

По умолчанию плагин Gradle добавляет его для целевой платформы iOS.

• Для отладочного билда он встраивает данные замещающего LLVM IR в качестве маркера.

• Для релизного билда он встраивает bitcode в качестве данных.

Или командные аргументы: -Xembed-bitcode (для релиза) и -Xembed-bitcode-marker (для отладки)

Установка в Gradle DSL:

kotlin {
    iosArm64("myapp") {
        binaries {
            framework {
                // Use "marker" to embed the bitcode marker (for debug builds).
                // Use "disable" to disable embedding.
                embedBitcode("bitcode") // for release binaries.
            }
        }
    }
}

Эти параметры почти идентичны эффекту clang's -fembed-bitcode/-fembed-bitcode-marker и swiftc's -embed-bitcode/-embed-bitcode-marker.

Почему я вижу ошибку InvalidMutabilityException?

Вероятно, это происходит потому, что вы пытаетесь изменить замороженный объект. Объект может перейти в замороженное состояние явно, как объекты, доступные из объектов, на которых вызван kotlin.native.concurrent.freeze, или неявно (то есть доступные из enum или глобального объекта-синглтона — см. следующий вопрос).

Как сделать объект-синглтон изменяемым?

В настоящее время объекты-синглтоны неизменяемы (то есть замораживаются после создания), и в целом считается хорошей практикой иметь неизменяемое глобальное состояние. Если по какой-то причине вам нужен изменяемый объект внутри такого объекта, используйте аннотацию @konan.ThreadLocal для объекта. Также, класс kotlin.native.concurrent.AtomicReference может использоваться для хранения разных указателей на замороженные объекты в замороженном объекте и автоматического обновления этих указателей.

Как скомпилировать проект с невыпущенными версиями Kotlin/Native?

Сначала попробуйте предварительные версии.

Если вам нужна ещё более новая версия разработки, вы можете собрать Kotlin/Native из исходного кода: клонировать репозиторий Kotlin и следовать этим шагам.