R INSTALL 安装附加包

说明

用于安装 add-on 软件包的实用程序。

用法

R CMD INSTALL [options] [-l lib] pkgs

参数

pkgs	以空格分隔的列表，其中包含要安装的软件包的路径名。查看具体信息'。
lib	的路径名R要安装到的库树。也接受以下形式‘⁠--library=lib⁠’。应使用所用 shell 的约定，将包含空格的路径加引号。
options	以空格分隔的选项列表，通过该列表可以特别控制构建帮助文件的过程。使用 R CMD INSTALL --help 获取完整的当前选项列表。

细节

这将在出现第一个错误时停止，因此如果您希望尝试所有 pkgs，请通过 shell 循环调用它。

如果用作R CMD INSTALL pkgs没有明确指定lib，包被安装到以库路径中的第一个目录为根的库树中，该目录将由R在当前环境下运行。

要安装到库树 lib 中，请使用 R CMD INSTALL -l lib pkgs 。这会在安装期间将 lib 添加到库路径中，以便在安装目录中找到所需的包(并优先于其他库中的包使用)。

lib和pkgs的元素都可以是目录的绝对路径名或相对路径名。 pkgs 还可能包含包存档文件的名称：然后将它们提取到临时目录。这些是包含单个目录的 tarball，可以选择由 gzip 、 bzip2 、 xz 或 compress 压缩。最后，可以提供二进制包存档文件(由 R CMD INSTALL --build 创建)。

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

可以在安装之前清理软件包源--预清理或之后 - 干净的：如果源要与多个架构或平台一起使用，则清理至关重要。

一些包源包含‘配置' 可以通过选项传递参数或变量的脚本--configure-args和--configure-vars，如果需要的话。后者非常有用，特别是当包所需的库或头文件位于非系统目录中时。在这种情况下，可以使用配置变量LIBS和CPPFLAGS指定这些位置(并通过设置它们--configure-vars)，请参阅“R 安装和管理”中的“配置变量”部分以获取更多信息。 (如果在命令行上多次使用它们，它们将被连接起来。)可以使用选项绕过配置机制--no-configure.

如果尝试安装该软件包失败，则剩余的内容将被删除。如果该软件包已安装，则恢复旧版本。如果命令遇到错误或者安装被键盘中断，就会发生这种情况：清理后脚本终止。

有关所完成的锁定的详细信息，请参阅 install.packages 帮助中的“锁定”部分。

选项 - 建造可用于将已安装的包打包为二进制包(如 macOS 上使用的那样)进行分发。这是由utils::tar除非环境变量R_INSTALL_TAR已设置。

默认情况下，当且仅当以下情况时，才会使用静态 HTML 帮助页面安装软件包：R是：使用选项--html和--no-html来覆盖这个。

默认情况下，软件包不会安装并保持源格式(请参阅keep.source参数source)：这可以通过选项启用--with-keep.source或者通过设置环境变量R_KEEP_PKG_SOURCE到yes.

指定--install-tests选项复制‘的内容测试’目录进入包安装。如果R_ALWAYS_INSTALL_TESTS环境变量设置为真值，即使在以下情况下也会安装测试--install-tests被省略。

使用 R CMD INSTALL --help 获取简洁的使用信息，包括所有可用选项。

Sub-architectures

一个R安装可以支持多个sub-architecture：目前，这最常用于 Windows 上的 32 位和 64 位版本。

对于此类安装，默认行为是尝试为所有已安装的 sub-architectures 安装源包，除非该包具有配置脚本或“源文件/生成文件' (或者 'src/Makefile.win’在 Windows 上)，当仅为 sub-architecture 运行编译代码时R CMD INSTALL已安装。

仅针对使用的 sub-architecture 安装带有编译代码的源码包R CMD INSTALL， 采用--no-multiarch。要仅安装另一个sub-architecture的编译代码，请使用--libs-only.

对于所有可用的sub-architectures，有两种安装方法。如果已知配置脚本适用于两种 Windows 体系结构，请使用标志--force-biarch(并且包可以指定这个通过A '⁠Biarch：是的⁠’他们的领域DESCRIPTION文件)。其次，可以安装单个 tarball

R CMD INSTALL --merge-multiarch mypkg_version.tar.gz

分阶段安装

安装源码包的默认方式发生了变化R3.6.0，因此软件包首先安装到临时位置，然后(如果成功)移动到目标库目录。一些旧包的编写方式假定直接安装到目标库。

目前可以通过一行‘来覆盖分阶段安装⁠分阶段安装：否⁠' 在包的'DESCRIPTION' 文件，通过旗帜--no-staged-install或者通过设置环境变量R_INSTALL_STAGED为错误值(例如‘⁠假⁠' 或者 '⁠不⁠’)。

分阶段安装需要--pkglock或者 - 锁，默认使用其中之一。

注意

选项不必在‘⁠包装⁠’在命令行上，尽管这样做会更清晰。所有选项都会在任何包之前处理，并且如果选项具有冲突效果，则最后一个将获胜。

部分操作的INSTALL取决于R临时目录(参见tempdir，通常在‘/tmp’) 对正在运行的帐户具有写入和执行权限R。通常是这种情况，但是如果‘/tmp' 已安装为noexec、环境变量TMPDIR可能需要设置为允许执行的目录。

也可以看看

REMOVE;.libPaths有关使用多个库树的信息；install.packages为了R- 软件包的级别安装；update.packages使用 Internet 或本地存储库自动更新软件包。

“R 安装和管理”中的“Add-on 包”部分和“编写 R 扩展”中的“创建 R 包”一章通过 RShowDoc或在‘文档/手册’的子目录R源树。