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

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

Чтобы получить доступ к метрикам менеджера памяти, вызовите 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)
}

Отслеживание потребления памяти на платформах Apple

При отладке проблем с памятью на платформах Apple можно посмотреть, сколько памяти зарезервировано кодом Kotlin. Память, используемая Kotlin, помечена идентификатором, и её можно отслеживать с помощью таких инструментов, как VM Tracker в Xcode Instruments.

Эта функция доступна только для аллокатора памяти Kotlin/Native по умолчанию, если соблюдены все следующие условия:

• Маркировка включена. Память должна быть помечена допустимым идентификатором. Apple рекомендует использовать числа от 240 до 255; значение по умолчанию — 246.

  Если задано свойство Gradle kotlin.native.binary.mmapTag=0, маркировка отключается.

• Выделение памяти с помощью mmap. Аллокатор должен использовать системный вызов mmap для отображения файлов в память.

  Если задано свойство Gradle kotlin.native.binary.disableMmap=true, аллокатор по умолчанию использует malloc вместо mmap.

• Подкачка включена. Подкачка выделенной памяти (буферизация) должна быть включена.

  Если задано свойство Gradle kotlin.native.binary.pagedAllocator=false, память резервируется отдельно для каждого объекта.

Обновление Kotlin

Обновите Kotlin до последней версии. Мы постоянно совершенствуем менеджер памяти, поэтому даже простое обновление компилятора может снизить потребление памяти.

Отключение подкачки аллокатора

Можно отключить подкачку выделенной памяти (буферизацию), чтобы аллокатор памяти резервировал память отдельно для каждого объекта. В некоторых случаях это помогает соблюдать строгие ограничения по памяти или снизить потребление памяти при запуске приложения.

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

kotlin.native.binary.pagedAllocator=false

Включение поддержки строк в кодировке Latin-1

По умолчанию строки в Kotlin хранятся в кодировке UTF-16, где каждый символ занимает два байта. В некоторых случаях из-за этого строки занимают в бинарном файле вдвое больше места, чем в исходном коде, а чтение данных требует вдвое больше памяти.

Чтобы уменьшить размер бинарного файла приложения и скорректировать потребление памяти, можно включить поддержку строк в кодировке Latin-1. В кодировке Latin-1 (ISO 8859-1) каждый из первых 256 символов Unicode представлен одним байтом.

Чтобы включить эту возможность, задайте следующую опцию в файле gradle.properties:

kotlin.native.binary.latin1Strings=true

При включённой поддержке Latin-1 строки хранятся в этой кодировке, если все символы входят в её диапазон. В противном случае используется кодировка UTF-16 по умолчанию.

Если ни один из этих вариантов не помог, создайте задачу в YouTrack.