我们正在改进库作者体验!

Read this post in other languages:

现代编程语言生态系统包括从测试框架到机器学习库再到 Web 开发框架的一切。 这些选项通常由库作者提供给社区。

Kotlin 团队明白,作者的工作对所有用户都相当重要。 因此,我们希望通过工具和文档来提供支持。 库作者体验是 2023 年 Kotlin 路线图的一大首要优先事项

在这篇博文中,我们将进一步介绍我们的计划和已经完成的工作,特别是 Dokka 文档更新。

改进库作者体验

我们专注于改进记录公共 API 的主要痛点,帮助库作者进行 API 设计,并提供方便的开发环境设置,包括项目模板和 CI 脚本。 详细了解我们的计划,随时在 YouTrack 的专用工单中参与讨论。

KDoc 体验改进 KT-55073

  • 改进 KDoc 和多行注释的格式。
  • 在 KDoc 注释中支持指向特定重载的链接。
  • 在 KDoc 注释中支持示例代码的高亮显示和建议。
  • 在显式 API 模式开启时,为公共 API 提供针对缺失 KDoc 注释的检查。

Dokka 稳定版本。 KT-48998

  • 使用 HTML 输出稳定 Dokka。
  • 发布完全修改的 Dokka 文档。

面向库作者的 Kotlin API 指南。 KT-55077

  • 为库作者提供全面的 API 指南。
  • 描述 JVM 和多平台库开发的最佳做法。
  • 列出有助于库开发(包括项目设置、确保向后兼容和发布)的工具。

隆重推出新的 Dokka 文档!

查看经过重写的、更加人性化的 Dokka 文档,并告诉我们您的想法。 

我们为 Gradle 项目配置添加了 Groovy DSL 示例,为 Maven 项目添加了示例。 这将帮助使用这些脚本和构建工具的开发者。

我们还重新组织了页面结构,添加了更多配置示例,并提供了配置选项描述来帮助新手更快入门。

要详细了解有关针对库作者的计划改进和其他 Kotlin 计划,请查看 Kotlin 路线图

另请参阅

本博文英文原作者:

Sue

Denis Ambatenne

Discover more

K2 编译器将在 Kotlin 2.0 中进入稳定状态

我们一直在为 Kotlin 编译器(代号 K2)开发新的前端。 前端是编译器的一部分,负责解析代码和执行语义分析、数据流分析、调用解析和类型推断。 这是开发者与编译器交互最多的部分。 编译器也通过它在 IDE 中持续运行、报告所有错误和警告消息,帮助完成自动补全、语义感知检查、意图和重构等任务。 新前端已经可供预览 – 我们将继续进行完善和稳定工作,计划在未来 Kotlin 版本中将其设为默认编译器前端。 我们已经决定将这个未来版本命名为 Kotlin 2.0。 下文将详细描述 Kotlin 2.0 版本的路线图、我们的动力以及对它的期望。 Kotlin 2.0 发布路线图是什么? 我们计划再发布一个按照传统方式进行版本控制的版本,Kotlin 1.9,其中还将包括来自 K2 编译器前端的持续开发的更新,因为它已经接近稳定。 未来不会有 Kotlin 1.10。 Kotlin 1.9 后的下一个主要版本将是 Kotlin 2.0。 为什么选择 Kotlin 2.0? 前端是编译器的主要部分。K2 编译器前端不仅仅是对旧编译器前端的重构,而是基于新架构从头开始的完全重写。 我们一直在各种博客、视频和会议演讲中发布有关差异的技术细节。 如需了解详情,可以从K2 编译器之路开始。 简而言之,新架构在设计上更快、更可扩展,解决了旧编译器前端的技术债务,修正了各个位置的错误和极端情况,并为