构建 R 包

1. 要创建项目，请执行以下操作之一：

   • 转到文件 | 新项目

   • 在欢迎屏幕上，单击创建新项目

2. 在“新建项目”对话框中，从可用项目类型中选择“R 包” 。

   

3. 指定以下参数：

   • Location：项目目录名称。该名称用于创建包标题并为包中的所有源构建文件名。

   • Python解释器。展开Python 解释器区域并单击基本解释器字段旁边的。在文件系统中，选择 R 可执行文件。R 可执行文件的示例路径可以是macOS 上的/usr /local /bin /R或 Windows 上的C: \Program Files \R \R-3.6.1 \bin \R.exe。

   • 选择的包管理器：在项目中构建 R 包的主要工具。展开更多设置并从列表中选择包管理器：Packrat、Rcpp、RcppArmadillo、RcppEigen或Devtools。如果您保持此设置不变，则将使用默认的托管包。

   单击“确定”完成任务。

4. 在项目工具窗口中展开项目内容根目录。该插件已创建所有必需的目录和模板文件。

   

5. 根据编写 R 扩展建议修改源文件并添加所有必需的详细信息。

   • man ：应包含 R 文档 ( *.Rd )格式的包中对象的文档文件的目录。

   • R：仅包含 R 代码文件的目录。

   • 描述：以特定格式包含有关包的基本信息的文件。

   • NAMESPACE ：可以包含一个或多个useDynLib指令的文件，该指令允许需要加载的共享对象。

   • Read-and-delete-me：包构建指令。

   如果您有任何 C、C++ 或 Fortran 源代码，则可以选择创建src目录。

6. 添加所有源文件后，您就可以安装并重新加载包了。在“R 工具”窗口的“构建”选项卡中，单击。

   

   完成此操作后，将创建 tarball 文件，并且该包可供您自己使用。

7. 要检查您的包是否通过R CMD check并可以上传到cran，请单击。

8. 您可以调整构建选项。单击并取消选择或保持选择以下复选框：

   

   默认情况下会选择每个选项，并代表一个特定的命令行选项。

测试一个包

1. 通过以下方式之一创建 R 文件的测试：

   在编辑器中

   在上下文菜单中

   单击R 文件工具栏上的 。

   

   在“项目”工具窗口中选择一个目标 R 文件，右键单击它，然后从上下文菜单中选择“创建测试文件”。

   

   新添加的测试文件将放置在项目根目录的test目录下。您可以使用相同的编辑器图标和上下文菜单从 R 文件导航到其测试。

2. 在新创建的测试文件中添加一些测试代码。

3. 您可以通过调用目标测试文件（R 文件工具栏上的图标）中的“运行”操作来单独运行每个测试，也可以使用R 工具窗口的“构建”选项卡中的相应图标运行包的所有测试。

   

4. 预览测试运行结果并在适当时修复 R 代码。