Исключение неиспользуемого кода в Kotlin/JS

Плагин Kotlin Multiplatform Gradle включает инструмент исключения неиспользуемого кода (DCE). Исключение неиспользуемого кода также часто называется удалением неиспользуемого кода. Оно уменьшает размер результирующего JavaScript-кода, удаляя неиспользуемые свойства, функции и классы.

Неиспользуемые объявления могут появляться в таких случаях:

• Функция инлайнизирована и никогда не вызывается напрямую (что происходит всегда, за исключением нескольких ситуаций).

• Модуль использует общую библиотеку. Без DCE части библиотеки, которые вы не используете, всё равно включаются в результирующий бандл. Например, стандартная библиотека Kotlin содержит функции для работы со списками, массивами, последовательностями символов, адаптерами для DOM и так далее. Все эти функции занимали бы около 1,3 МБ в виде JavaScript-файла. Простое приложение «Hello, world» нуждается только в функциях для работы с консолью, что составляет всего несколько килобайт для всего файла.

Плагин Kotlin Multiplatform Gradle автоматически обрабатывает DCE при создании бандла для производства, например, с помощью задачи browserProductionWebpack. Задачи сборки для разработки (например, browserDevelopmentWebpack) не включают DCE.

kotlin {
    js {
        browser {
            dceTask {
                keep("myKotlinJSModule.org.example.getName", "myKotlinJSModule.org.example.User" )
            }
            binaries.executable()
        }
    }
}

kotlin {
    js {
        browser {
            dceTask {
                dceOptions.devMode = true
            }
        }
        binaries.executable()
    }
}