Советы по оптимизации времени компиляции 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 Mobile.

• Не отключайте демона 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 Security.