Kotlin/Native ЧаВо

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

Определите функцию верхнего уровня 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.
            }
        }
    }
}

Эти параметры имеют почти тот же эффект, что и -fembed-bitcode/-fembed-bitcode-marker clang и -embed-bitcode/-embed-bitcode-marker swiftc.

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

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

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

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

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

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

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