當前位置: 首頁>>代碼示例 >>用法及示例精選 >>正文


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。非經特殊聲明,原始代碼版權歸原作者所有,本譯文未經允許或授權,請勿轉載或複製。