Cargo 包注册表

发布您用户或组织的 Cargo 包。

需求

要使用 Cargo 包注册表，您需要 Rust 和 Cargo。

Cargo 将有关可用包的信息存储在一个存储在 git 仓库中的包索引中。此仓库是使用注册表所需的。下一部分介绍如何创建它。

索引仓库

Cargo 将有关可用包的信息存储在一个存储在 git 仓库中的包索引中。在 Gitea 中，此仓库具有特殊名称 _cargo-index。上传包后，其元数据将自动写入索引。不应手动修改此仓库的内容。

用户或组织包设置页面允许创建索引仓库以及配置文件。如果需要，此操作将重写配置文件。这在例如 Gitea 实例域发生更改时可能很有用。

如果出现 Gitea 中存储的包与索引仓库中的信息不同步的情况，设置页面允许重建索引仓库。此操作将迭代注册表中的所有包并将它们的信息写入索引。如果存在很多包，此过程可能需要一些时间。

配置包注册表

要注册包注册表，必须更新 Cargo 配置。将以下文本添加到当前用户主目录中的配置文件（例如 ~/.cargo/config.toml）

[registry]
default = "gitea"

[registries.gitea]
index = "sparse+https://gitea.example.com/api/packages/{owner}/cargo/" # Sparse index
# index = "https://gitea.example.com/{owner}/_cargo-index.git" # Git

# [net]
# git-fetch-with-cli = true

参数	描述
owner	包的所有者。

如果注册表是私有的或您要发布新包，则必须配置您的凭据。将凭据部分添加到当前用户主目录中的凭据文件（例如 ~/.cargo/credentials.toml）

[registries.gitea]
token = "Bearer {token}"

参数	描述
token	您的 个人访问令牌

Git 与 Sparse

目前，cargo 支持两种在注册表中获取箱子的方式：Git 索引和稀疏索引。稀疏索引是最新方法，与 git 相比，在更新箱子时提供更好的性能。自 Rust 1.68 以来，稀疏是 crates.io 的默认方法。

发布包

通过在项目中运行以下命令来发布包

cargo publish

如果具有相同名称和版本的包已存在，则无法发布包。您必须先删除现有包。

安装包

要从包注册表安装包，请执行以下命令

cargo add {package_name}

参数	描述
package_name	包名。

支持的命令

cargo publish
cargo add
cargo install
cargo yank
cargo unyank
cargo search