Добавление зависимостей в Kotlin Notebook

Вы уже создали свой первый Kotlin Notebook! Теперь узнаем, как добавлять зависимости библиотек, необходимые для использования расширенных возможностей.

Вы можете загрузить любую библиотеку из репозитория Maven, указав её координаты в любом блоке кода, используя синтаксис в стиле Gradle. Однако Kotlin Notebook позволяет упростить загрузку популярных библиотек с помощью инструкции %use:

// Replace libraryName with the library dependency you want to add
%use libraryName
// Specify a version, if required
%use libraryName(version)
// Add v= to trigger autocomplete
%use libraryName(v=version)
// Example: kotlinx.datetime:0.7.1
%use datetime(v=0.7.1)

Также вы можете использовать функцию автодополнения в Kotlin Notebook, чтобы быстро находить доступные библиотеки:

Autocompletion feature in Kotlin Notebook

Добавление библиотек Kotlin DataFrame и Kandy в Kotlin Notebook

Добавим в Kotlin Notebook две популярные библиотеки Kotlin:

Библиотека Kotlin DataFrame позволяет обрабатывать данные в проектах Kotlin. С её помощью можно получать данные из API, баз данных SQL и файлов в различных форматах, например CSV или JSON.
Библиотека Kandy предоставляет мощный и гибкий DSL для создания диаграмм.

Чтобы добавить эти библиотеки:

Нажмите Добавить ячейку кода, чтобы создать новую ячейку кода.

Введите следующий код в ячейку кода:

// Ensures that the latest available library versions are used
%useLatestDescriptors

// Imports the Kotlin DataFrame library
%use dataframe

// Imports the Kotlin Kandy library
%use kandy

Выполните ячейку кода.

При выполнении инструкции %use загружаются зависимости библиотеки и в блокнот добавляются импорты по умолчанию.

Обязательно выполните ячейку кода со строкой %use libraryName, прежде чем выполнять другие ячейки кода, использующие эту библиотеку.
Чтобы импортировать данные из файла CSV с помощью библиотеки Kotlin DataFrame, используйте функцию .read() в новой ячейке кода:
```
// Creates a DataFrame by importing data from the "netflix_titles.csv" file.
val rawDf = DataFrame.read("netflix_titles.csv")

// Displays the raw DataFrame data
rawDf
```
Этот пример файла CSV можно скачать из репозитория примеров Kotlin DataFrame на GitHub. Добавьте его в каталог проекта.

В новой ячейке кода используйте метод .plot, чтобы визуально представить распределение телешоу и фильмов в DataFrame:

rawDf
    // Counts the occurrences of each unique value in the column named "type"
    .valueCounts(sort = false) { type }
    // Visualizes data in a bar chart specifying the colors
    .plot {
        bars {
            x(type)
            y("count")
            fillColor(type) {
                scale = categorical(range = listOf(Color.hex("#00BCD4"), Color.hex("#009688")))
            }
        }

        // Configures the layout of the chart and sets the title
        layout {
            title = "Count of TV Shows and Movies"
            size = 900 to 550
        }
    }

Получившаяся диаграмма:

Поздравляем! Вы добавили и использовали эти библиотеки в Kotlin Notebook. Это лишь малая часть возможностей Kotlin Notebook и его поддерживаемых библиотек.

Предыдущий шаг

Что дальше

Узнайте, как поделиться Kotlin Notebook
Подробнее о добавлении зависимостей в Kotlin Notebook
Подробное руководство по работе с библиотекой Kotlin DataFrame см. в разделе Получение данных из файлов
Обзор инструментов и ресурсов для анализа и обработки данных в Kotlin см. в разделе Библиотеки Kotlin и Java для анализа данных

1 сентября 2026 г.

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/kotlin-notebook-add-dependencies.html