当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


R PkgUtils 用于构建和检查附加包的实用程序


R语言 PkgUtils 位于 utils 包(package)。

说明

用于检查源是否存在的实用程序Radd-on 包可以正常工作,并可以从中构建源包。

用法

R CMD check [options] pkgdirs
R CMD build [options] pkgdirs

参数

pkgdirs

包含源的目录名称列表Radd-on 包。为了check这些也可以是压缩的文件名tar扩展名为‘的档案.tar.gz', '.tgz', '.tar.bz2' 或者 '.tar.xz’。

options

用于控制处理或获取有关实用程序的使用情况和版本的信息的其他选项。

细节

R CMD check检查Radd-on 从其来源打包,执行各种诊断检查。

R CMD build构建R源 tarball。包的名称取自‘DESCRIPTION’ 文件而不是目录名称。这完全适用于所提供的源目录的副本。

使用 R CMD foo --help 获取实用程序 foo 的使用信息,特别是可能的 options

某些选项的默认值R CMD build可以通过环境变量设置_R_BUILD_RESAVE_DATA__R_BUILD_COMPACT_VIGNETTES_:请参阅“编写 R 扩展”。很多检查都在R CMD check可以通过环境变量关闭或打开:请参阅“R 内部”手册的“工具”一章。

默认情况下R CMD build使用"internal"选项tar准备 tarball。一个外部tar程序可以由指定R_BUILD_TAR环境变量。对于非常大的包来说,这可能会快得多,并且对于具有长路径名(超过 100 字节)或非常大的文件(超过 8GB)的包来说可能是必需的:但是,生成的 tarball 可能不可移植。

R CMD check默认情况下通过内部解压 tarballuntar函数:如果需要外部tar命令可以通过环境变量指定R_INSTALL_TAR:请确保它可以处理 tarball 上使用的压缩类型。 (对于包含无效或不受支持部分的 tarball,有时需要这样做,并且在非常大的 tarball 上可能会更快。设置R_INSTALL_TAR到 '⁠tar.exe⁠' 需要克服某些 Windows 系统上的权限问题。)

注意

仅在 Windows 上:它们使用环境变量指定的临时目录TMPDIR并默认为‘⁠c:/TEMP⁠’。请确保使用设置的正斜杠。

也可以看看

“编写 R 扩展”中有关“检查和构建包”和“处理 Rd 格式”的部分(参见 Unix-alikes 上的“文档/手册’的子目录R源树,在 Windows 上,请参阅控制台上帮助菜单的手册 sub-menu)。

相关用法


注:本文由纯净天空筛选整理自R-devel大神的英文原创作品 Utilities for Building and Checking Add-on Packages。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。