Советы по улучшению времени компиляции Kotlin/Native

Общие рекомендации

• Используйте последнюю версию Kotlin. Таким образом, вы всегда будете иметь последние улучшения производительности.

• Избегайте создания огромных классов. Они занимают много времени при компиляции и загрузке во время выполнения.

• Сохраняйте загруженные и кэшированные компоненты между сборками. При компиляции проектов Kotlin/Native загружает необходимые компоненты и кэширует некоторые результаты своей работы в каталог $USER_HOME/.konan. Компилятор использует этот каталог для последующих компиляций, что сокращает время их выполнения.

  При сборке в контейнерах (таких как Docker) или с использованием систем непрерывной интеграции компилятору может потребоваться создать каталог ~/.konan с нуля для каждой сборки. Чтобы избежать этой операции, настройте свою среду для сохранения ~/.konan между сборками. Например, переопределите его расположение с помощью переменной среды KONAN_DATA_DIR.

Настройка Gradle

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

Вот некоторые рекомендации по настройке Gradle для лучшей производительности компиляции:

• Увеличьте размер кучи Gradle. Добавьте org.gradle.jvmargs=-Xmx3g к gradle.properties. Если вы используете параллельную сборку, возможно, потребуется увеличить размер кучи или выбрать нужное количество потоков с помощью org.gradle.parallel.threads.

• Сборка только необходимых бинарных файлов. Не запускайте задачи Gradle, которые собирают весь проект, такие как build или assemble, если это не необходимо. Эти задачи собирают один и тот же код более одного раза, увеличивая время компиляции. В типичных случаях, таких как выполнение тестов из IntelliJ IDEA или запуск приложения из Xcode, инструменты Kotlin избегают выполнения ненужных задач.

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

  • linkDebug*: Для запуска кода во время разработки обычно требуется только один двоичный файл, поэтому достаточно запустить соответствующую задачу linkDebug*. Имейте в виду, что компиляция релизной бинарной сборки (linkRelease*) занимает больше времени, чем компиляция отладочной.

  • packForXcode: Поскольку у iOS-симуляторов и устройств разные архитектуры процессоров, распространённым подходом является распространение двоичного файла Kotlin/Native в виде универсального (fat) фреймворка. Во время локальной разработки быстрее собирать .framework только для используемой платформы.

    Чтобы собрать платформенно-специфичный фреймворк, вызовите задачу packForXcode , сгенерированную мастер-классом Kotlin Multiplatform Mobile.

• Не отключайте демона Gradle без веских оснований. Kotlin/Native выполняется в демоне Gradle по умолчанию. Когда он включен, используется один и тот же процесс JVM, и нет необходимости его разогревать для каждой компиляции.

• Не используйте transitiveExport = true. Использование транзитивного экспорта во многих случаях отключает удаление неиспользуемого кода: компилятор должен обработать много неиспользуемого кода. Это увеличивает время компиляции. Используйте export явно для экспорта необходимых проектов и зависимостей.

• Используйте кэш Gradle:

  • Локальный кэш сборки: Добавьте org.gradle.caching=true в свой gradle.properties или выполните с --build-cache в командной строке.

  • Удаленный кэш сборки в средах непрерывной интеграции. Узнайте, как настроить удаленный кэш сборки.

• Включите ранее отключенные функции Kotlin/Native. Существуют свойства, которые отключают демона Gradle и кэши компилятора - kotlin.native.disableCompilerDaemon=true и kotlin.native.cacheKind=none. Если у вас ранее были проблемы с этими функциями и вы добавили эти строки в свой gradle.properties или аргументы Gradle, удалите их и проверьте, успешно ли завершается сборка. Возможно, эти свойства были добавлены ранее для решения уже исправленных проблем.

Настройка Windows OS

• Настройка безопасности Windows. Безопасность Windows может замедлить компилятор Kotlin/Native. Вы можете избежать этого, добавив каталог .konan, который по умолчанию находится в %USERPROFILE%, в исключения безопасности Windows. Узнайте, как добавить исключения в Windows Security.