向你的 Kotlin Notebook 添加依赖项

最终更新: 2025/02/06

本章是 Kotlin Notebook 入门 教程的第 3 部分. 阅读本章之前, 请确认你已完成了之前的章节.

First step 设置环境
Second step 创建 Kotlin Notebook
Third step 向 Kotlin Notebook 添加依赖项

你已经创建了你的第一个 Kotlin Notebook! 现在我们来学习如何添加库的依赖项, 在使用高级功能时必须用到这些库.

note

Kotlin 标准库直接可以使用, 因此你不必导入这些库.

在任何代码单元中, 你可以使用 Gradle 风格的语法, 指定库的座标(coordinate), 载入 Maven 仓库中的任何库. 但是, Kotlin Notebook 有一个简化的方法, 可以使用 %use 语句 载入常用的库:

// 请将 libraryName 替换为你想要添加的库依赖项
%use libraryName

你也可以在 Kotlin Notebook 中使用自动完成功能, 快速找到可用的库:

Kotlin Notebook 中的自动完成功能

向你的 Kotlin Notebook 添加 Kotlin DataFrame 和 Kandy 库

我们来向你的 Kotlin Notebook 添加两个常用的 Kotlin 库依赖项:

要添加库, 请执行以下步骤:

  1. 点击 Add Code Cell, 创建一个新的代码单元.

  2. 在代码单元中输入以下代码:

    // 确保使用库的最新版本
%useLatestDescriptors

// 导入 Kotlin DataFrame 库
%use dataframe

// 导入 Kotlin Kandy 库
%use kandy

  3. 运行这个代码单元.

    在 %use 语句执行时, 它会下载库依赖项, 并向你的 Notebook 添加默认的 import.

    note

    在你运行任何依赖于库的代码单元之前, 要确保运行了带有 %use libraryName 行的那个代码单元.

  4. 要使用 Kotlin DataFrame 库从 CSV 文件导入数据, 请在一个新的代码单元中使用 .read() 函数:

    // 从 "netflix_titles.csv" 文件导入数据, 创建一个 DataFrame.
val rawDf = DataFrame.read("netflix_titles.csv")

// 显示 DataFrame 的原始数据
rawDf

    tip

    你可以从 Kotlin DataFrame 示例的 GitHub 仓库 下载这个示例 CSV. 将它添加到你的项目目录中.

    使用 DataFrame 显示数据

  5. 在一个新的代码单元中, 使用 .plot 方法, 可视化显示你的 DataFrame 中的电视剧和电影的分布状况:

    rawDf
    // 计算名为 "type" 的列中出现的各个值的个数
    .valueCounts(sort = false) { type }
    // 使用指定颜色的条状图(Bar Chart) 可视化显示数据
    .plot {
        bars {
            x(type)
            y("count")
            fillColor(type) {
                scale = categorical(range = listOf(Color.hex("#00BCD4"), Color.hex("#009688")))
            }
        }

        // 配置图表的布局, 并设置标题
        layout {
            title = "Count of TV Shows and Movies"
            size = 900 to 550
        }
    }

运行结果产生的图表如下:

使用 Kandy 库可视化显示数据

恭喜你, 你已经在你的 Kotlin Notebook 中添加并使用了这些库! 这只是你使用 Kotlin Notebook 和它 支持的库 所能实现的功能的一个非常简单的介绍.

下一步做什么