用途:为 R 包执行完整的版本发布周期,适用于准备发布新版本(修复、功能或破坏性变更)、CRAN 通过后创建对应 GitHub Release,以及设置发布后的开发版本。
主要能力:按语义化版本确定递增类型(patch 0.1.0→0.1.1、minor 0.1.0→0.2.0、major 0.1.0→1.0.0);更新 DESCRIPTION 版本并新增 NEWS.md 标题;填写分类发布说明并附 issue/PR 编号;执行 devtools::check()、devtools::spell_check()、urlchecker::url_check() 最终检查;提交发布、创建并推送带注释标签、创建 GitHub Release、设置开发版本。
使用方式:依次执行各步骤。版本更新用 usethis::use_version("minor")(或 "patch"/"major");提交用 git add DESCRIPTION NEWS.md 与 git commit -m "Release packagename v0.2.0";打标签用 git tag -a v0.2.0 -m "Release v0.2.0" 与 git push origin main --tags;创建 Release 用 gh release create v0.2.0 --title "packagename v0.2.0" --notes-file NEWS.md 或 usethis::use_github_release();发布后用 usethis::use_dev_version() 将版本改为 x.y.z.9000 并提交推送。
限制与注意:需包已具备可发布变更并指定发布类型;是否提交 CRAN 默认否,需另用 submit-to-cran 技能。git push 不会推送标签,需加 --tags;标签须打在版本递增提交之后;CRAN 不接受已发布版本号;不得向 CRAN 提交 .9000 开发版本。检查须达到 0 errors、0 warnings、0 notes。资料未提供具体收费、平台支持范围等信息。