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源樹。