Ark项目使用教程

Ark项目使用教程

ark Ark, an R kernel 项目地址: https://gitcode.com/gh_mirrors/ark6/ark

1. 项目介绍

Ark是一个为Jupyter应用程序设计的R内核。它被创建用于作为R和Positron IDE之间的接口，并且与所有实现Jupyter协议的前端兼容。Ark的目标是提供一套完整的可重用和互操作性工具，用于实现R的IDE。它不仅是一个Jupyter内核，提供了R和前端之间的结构化交互（输入和输出），还是一个LSP服务器，支持诸如代码补全、跳转到定义、查找引用、诊断等智能感知特性。此外，它还是一个DAP服务器，用于R函数的高级逐步调试。

2. 项目快速启动

在Positron中运行Ark的最简单方法是通过Positron来执行，这是目前使用Ark的高级特性（由LSP和DAP提供）的唯一实际方式。以下是在Jupyter应用程序中快速启动Ark的步骤：

首先，下载Ark的发布版本到您的系统中，例如在macOS或Linux上可以是/usr/local/bin/ark。

然后，使用以下命令安装Jupyter内核规范文件：

ark --install

**注意：**Ark目前未签名和认证，因此在macOS上，您可能需要转到“系统设置” -> “隐私与安全性” -> 点击“允许任何方式”来允许运行ark，否则macOS会阻止您运行它。我们正在改进这一点。但是，当使用Positron中捆绑的ark版本时，这不适用。

完成安装后，Ark应该可以在Jupyter应用程序中使用，例如在Jupyter Lab中：

或者在命令行中（如果安装了Jupyter Console）：

jupyter console --kernel=ark

3. 应用案例和最佳实践

以下是一些使用Ark的应用案例和最佳实践：

• **交互式数据分析和可视化：**使用JupyterLab等前端，通过Ark内核执行R代码，进行交互式数据分析和创建数据可视化。
• **代码补全和智能感知：**利用Ark的LSP服务器功能，为R代码提供实时代码补全和其他智能感知特性，提升编码效率。
• **调试R代码：**通过Ark的DAP服务器，可以在R代码中设置断点，逐步调试代码，并检查局部变量。

4. 典型生态项目

• **Positron：**下一代数据科学IDE，它通过Ark内核提供交互式R代码评估和收集输出和图表。
• **IRKernel：**一个用R自身编写的Jupyter内核，提供类似于R Markdown或Quarto的集成级别。
• **languageserver：**一个为R实现LSP协议的服务器，主要用R编写。
• **vscDebugger：**一个为R实现DAP协议的服务器，作为R包编写。

以上就是关于Ark项目的使用教程，希望对您有所帮助。

ark Ark, an R kernel 项目地址: https://gitcode.com/gh_mirrors/ark6/ark