使用 devtools::document 构建 R 包错误

Question

我正在使用 devtools 构建 R 包。我已经构建了一个包，其中包含一些我想包含的功能。我想在启动时加载包及其文档。我的包文件位于以下位置：

'~/global/Rcode/Startup Package'

我的 .Rprofile 文件如下所示：

.First <- function(){
    library(devtools)
    location <- '~/global/Rcode/Startup Package'
    document(location)
}

但是，当我打开 R 时，会加载包中的函数，但不会加载文档。

如果我自己启动后运行同样的代码行，即：

library(devtools)
location <- '~/global/Rcode/Startup Package'
document(location)

然后一切正常，包正确记录。因此，这似乎是一个相当奇怪的错误！

（作为部分修复，我可以运行

install(location)

并将其视为普通的 r 包并且一切正常，但这需要时间，因为我打算经常更新包并且真的不想每次都必须运行，尤其是因为 devtools 选项应该有效。）

Answer 1

确保 utils 在加载 devtools 之前加载，否则没有 help 函数供 devtools 覆盖。

使用 .Rprofile:

.First = function(){
library(utils)
library(devtools)
document("./foo")
}

然后 R 启动：

[stuff]
Type 'q()' to quit R.

Updating foo documentation
Loading foo

而help是devtools版本：

> environment(help)
<environment: namespace:devtools>

删除那个 library(utils) 你会看到帮助功能是 utils 中找不到你的包文档的功能。

Building an R package error with devtools::document