Управление памятью в Kotlin/Native

Включение сборки мусора вручную

Чтобы принудительно запустить сборщик мусора, вызовите kotlin.native.internal.GC.collect(). Это запускает новую коллекцию и ожидает её завершения.

Отслеживание производительности GC

Пока нет специальных инструментов для отслеживания производительности GC. Однако всё ещё можно просмотреть журналы GC для диагностики. Чтобы включить протоколирование, задайте соответствующий флаг компиляции в скрипте Gradle:

-Xruntime-logs=gc=info

В настоящее время журналы выводятся только в stderr.

Отключение сборки мусора

Рекомендуется держать GC включённым. Однако, в некоторых случаях, например, для тестирования или если у вас кратковременная программа, вы можете его отключить. Для этого задайте соответствующий флаг компиляции в скрипте Gradle:

-Xgc=noop

Поиск утечек памяти

Для доступа к метрикам менеджера памяти вызовите kotlin.native.internal.GC.lastGCInfo(). Он возвращает статистику последнего запуска сборщика мусора. Статистика может быть полезна для:

• Отладки утечек памяти при использовании глобальных переменных

• Проверки наличия утечек при запуске тестов

import kotlin.native.internal.*
import kotlin.test.*

class Resource

val global = mutableListOf<Resource>()

@OptIn(ExperimentalStdlibApi::class)
fun getUsage() : Long {
    GC.collect()
    return GC.lastGCInfo!!.memoryUsageAfter["heap"]!!.totalObjectsSizeBytes
}

fun run() {
    global.add(Resource())
    // The test will fail if you remove the next line
    global.clear()
}

@Test
fun test() {
    val before = getUsage()
    // A separate function is used to ensure that all temporary objects are cleared
    run()
    val after = getUsage()
    assertEquals(before, after)
}

Настройка потребления памяти

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

Другой способ исправить высокое потребление памяти связан с mimalloc, стандартным менеджером памяти для многих целей. Он предварительно выделяет и удерживает системную память, чтобы ускорить выделение.

Чтобы избежать этого с потерей производительности, доступны несколько вариантов:

• Переключите менеджер памяти с mimalloc на системный менеджер. Для этого задайте опцию -Xallocator=std в скрипте Gradle.

• Начиная с Kotlin 1.8.0-Beta, вы также можете указать mimalloc немедленно освободить память обратно в систему. Это немного снижает производительность, но даёт менее определённые результаты.

  Для этого включите следующую опцию в вашем файле gradle.properties:

  kotlin.native.binary.mimallocUseCompaction=true
  

• Переключитесь на пользовательский менеджер памяти. Он всё ещё Бета. Чтобы попробовать его в своих проектах, установите опцию -Xallocator=custom в вашем скрипте Gradle.

  Для получения дополнительной информации об архитектуре нового менеджера памяти, см. этот README.

Если ни один из этих вариантов не помог улучшить потребление памяти, сообщите об ошибке в YouTrack.