miniCRAN 使用教程

miniCRAN 使用教程

1、项目介绍

miniCRAN 是一个 R 包，用于创建一个包含选定包的迷你版本的 CRAN。它允许用户指定一组所需的包，并递归地读取这些包的依赖树，然后仅下载这一子集。用户可以直接从该仓库安装包，而不是从 CRAN 安装。这在生产环境中非常有用，例如在防火墙后面的服务器或互联网访问缓慢（或无）的远程位置。

2、项目快速启动

安装 miniCRAN

首先，从 CRAN 安装 miniCRAN：

install.packages("miniCRAN")
library("miniCRAN")

或者从 GitHub 安装最新开发版本：

# 使用 `devtools` 从 GitHub 直接安装
library(devtools)
install_github("andrie/miniCRAN")

创建本地 CRAN 仓库

以下是一个快速启动示例，展示如何创建一个包含 ggplot2、plyr 和 reshape2 及其依赖项的本地 CRAN 仓库：

# 定义 CRAN 镜像
mirror <- c(CRAN = "https://cloud.r-project.org")

# 指定要下载的包列表
pkgs <- c("ggplot2", "plyr", "reshape2")

# 获取包依赖列表
pkgList <- pkgDep(pkgs, repos = mirror, type = "source", suggests = FALSE)

# 创建本地仓库
makeRepo(pkgList, path = "~/miniCRAN", repos = mirror, type = c("source", "binary"))

3、应用案例和最佳实践

应用案例

假设你在一个没有互联网访问的服务器上工作，但你需要安装一些特定的 R 包。使用 miniCRAN，你可以：

1. 在有互联网访问的机器上创建一个包含所需包的本地 CRAN 仓库。
2. 将该仓库复制到服务器上。
3. 从本地仓库安装包。

最佳实践

• 定期更新仓库：使用 updatePackages 函数定期更新本地仓库中的包版本。
• 管理依赖项：确保在创建仓库时包含所有必要的依赖项，以避免安装时出现问题。

4、典型生态项目

miniCRAN 通常与其他 R 包管理工具一起使用，例如：

• devtools：用于从 GitHub 安装开发版本的包。
• renv：用于项目级别的包管理，确保项目在不同环境中的一致性。
• packrat：类似于 renv，用于项目级别的包管理。

通过结合这些工具，可以更有效地管理和部署 R 包。