跳至主要内容
版本:1.23.7

CRAN 套件註冊表

為您的用戶或組織發布 R 套件到類似 CRAN 的註冊表。

需求

要使用 CRAN 套件註冊表,您需要安裝 R

配置套件註冊表

要註冊套件註冊表,您需要將其添加到 Rprofile.site,可以是系統級別、用戶級別(~/.Rprofile)或項目級別:

options("repos" = c(getOption("repos"), c(gitea="https://gitea.example.com/api/packages/{owner}/cran")))
參數描述
owner套件的擁有者。

如果您需要提供憑證,您可以將它們嵌入到 URL 中(https://user:password@gitea.example.com/...)。

發布套件

要發布 R 套件,請執行 HTTP PUT 操作,請求體中包含套件內容。

源套件:

PUT https://gitea.example.com/api/packages/{owner}/cran/src
參數描述
owner套件的擁有者。

二進制套件:

PUT https://gitea.example.com/api/packages/{owner}/cran/bin?platform={platform}&rversion={rversion}
參數描述
owner套件的擁有者。
platform平台名稱。
rversion二進制的 R 版本。

例如:

curl --user your_username:your_password_or_token \
--upload-file path/to/package.zip \
https://gitea.example.com/api/packages/testuser/cran/bin?platform=windows&rversion=4.2

如果您使用 2FA 或 OAuth,請使用 個人訪問令牌 代替密碼。

如果已經存在同名同版本的套件,您不能發布該套件。您必須先刪除現有的套件。

服務器響應以下 HTTP 狀態碼。

HTTP 狀態碼含義
201 Created套件已發布。
400 Bad Request套件無效。
409 Conflict已存在具有相同參數組合的套件文件。

安裝套件

要從套件註冊表中安裝 R 套件,請執行以下命令:

install.packages("{package_name}")
參數描述
package_name套件名稱。

例如:

install.packages("testpackage")