Советы по улучшению времени компиляции 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.workers.max или командной строки --max-workers. Значение по умолчанию — количество процессоров ЦП.

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

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

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

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

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

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

• Не используйте transitiveExport = true. Использование transitive export в многих случаях отключает удаление неиспользуемого кода: компилятору необходимо обработать много неиспользуемого кода. Это увеличивает время компиляции. Используйте 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

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