R语言开发记录,二(创建R包)

1.如何创建R包

library(devtools)

library(roxygen2)

pkg_file <- build("D:/charls") # 打包为 .tar.gz

message("包已生成于:", pkg_file)

1.1首先安装:

复制代码
install.packages(c("devtools", "roxygen2"))

1.2 R包的文件结构

复制代码
myPackage/
├── DESCRIPTION         # 包的元信息(必须)
├── NAMESPACE           # 导出函数定义(必须)
├── R/                  # 存放 R 脚本文件(必须)
│   └── myfunctions.R
├── data/               # 可选:存放 .rda 数据文件
├── man/                # 可选:帮助文档(由 roxygen2 自动生成)
├── inst/               # 可选:额外资源文件(如 config、doc 等)
└── README.md           # 可选:说明文档

1.3 创建 R 包并打包

步骤 1:创建基础结构(可选)

如果你还没有完整结构,可以用 devtools 快速生成:

复制代码
library(devtools)
create_package("path/to/myPackage")

步骤 2:编写 DESCRIPTION 文件(必须)

打开 DESCRIPTION 文件,填写基本元信息,例如:

复制代码
Package: myPackage
Title: My First R Package
Version: 0.1.0
Author: Your Name <your.email@example.com>
Maintainer: Your Name <your.email@example.com>
Description: A short description of what the package does.
License: MIT
Depends:
    R (>= 3.5.0)
Imports:
    dplyr,
    ggplot2

步骤 3:生成 NAMESPACE 文件(必须)

你可以手动写,也可以用 roxygen2 自动生成:

方法 A:手动写(不推荐)

NAMESPACE 中写:

复制代码
exportPattern("^[^\\.]")  # 导出所有非以 . 开头的函数
方法 B:使用 roxygen2 自动生成(推荐)

在 R 函数中添加注释格式帮助文档:

复制代码
#' 计算两个数的和
#' @param a 第一个数
#' @param b 第二个数
#' @return 两数之和
add <- function(a, b) {
  a + b
}

然后运行:

复制代码
library(roxygen2)
roxygenise("path/to/myPackage")

这会自动生成 NAMESPACEman/ 帮助文档。

步骤 4:构建包(打包)

在 R 控制台中运行:

复制代码
# 构建 .tar.gz(适用于 Linux/macOS)
pkg_path <- devtools::build(path = "path/to/myPackage")
print(pkg_path)  # 输出包路径,比如:"/path/to/myPackage_0.1.0.tar.gz"

# 如果你想构建 Windows 二进制包(需要 Rtools)
devtools::build_win(path = "path/to/myPackage")

步骤 5:安装本地包

复制代码
install.packages("path/to/myPackage_0.1.0.tar.gz", repos = NULL, type = "source")

参数说明:

pkgs: 本地包文件的路径;

repos = NULL: 表示不从远程仓库安装;

type: 指定安装类型:

"source":适用于 Linux/macOS,安装源码包;

"win.binary":适用于 Windows 的 .zip 二进制包;

如果省略,R 会自动识别。

快速打包

复制代码
library(devtools)
library(roxygen2)

# 创建空包(如果还没结构)
create_package("myPackage")

# 添加函数、数据等后:
roxygenise("myPackage")       # 生成帮助文档和 NAMESPACE
pkg_file <- build("myPackage")  # 打包为 .tar.gz

message("包已生成于:", pkg_file)
相关推荐
2601_9620702316 小时前
差异基因富集分析(R语言——GO&KEGG&GSEA)
开发语言·golang·r语言
统计学小王子1 天前
R语言入门——ggplot2图例增加公式
开发语言·r语言
统计学小王子3 天前
R语言入门——相关性热图(建模常用二)
r语言·可视化·相关性分析
知识分享小能手4 天前
概理论与数理统计学习教程,从入门到精通,在数理统计中应用R软件(22)
开发语言·学习·r语言
知识分享小能手5 天前
概理论与数理统计学习教程,从入门到精通,在数理统计中应用R软件(21)
开发语言·学习·r语言
asyxchenchong88811 天前
R语言混合效应(多水平/层次/嵌套)模型及贝叶斯实现技术应用
开发语言·r语言
临床数据科学和人工智能兴趣组13 天前
R语言中,列表是一种非常灵活的数据结构,它可以存储不同类型的对象,如向量、矩阵、数据框、甚至其他列表
数据结构·数据库·r语言·r语言-4.2.1·临床试验
临床数据科学和人工智能兴趣组14 天前
矩阵是一种二维数组,每个矩阵仅能包含一类数据(数值型、字符型或者逻辑型)
数据库·线性代数·矩阵·r语言·r语言-4.2.1·临床试验
临床数据科学和人工智能兴趣组15 天前
网络爬虫(Web Scraping)是一种用于自动提取网页内容的技术
r语言·r语言-4.2.1
生态学者16 天前
Ecological Indicators | 机场鸟调的新方法:用 AWM-PC1 读懂干扰梯度下的鸟类群落
人工智能·算法·r语言·微信公众平台