42_发布crate

1. 创建账号

  • 发布crate.io前,需要在<crates.io>创建账号并获得API Token
  • 运行命令cargo login $API_TOKEN
    • 将会通知cargo,把你的API token存储在本地 ~/.cargo/credentials.toml
    • API Token可以在<crates.io>上进行撤销。

2. crate添加元数据

在发布crate之前,需要在Cargo.toml[package]区域为crate添加一些元数据:

  • name: crate需要指定位于的名称
  • description: 一两句话即可,会出现在crate搜索的结果里
  • license: 需要提供许可证的表示值,可以到spdx.org/licenses/查找,可以指定多个许可,使用OR隔开
  • version: 版本号
  • author: 作者

更多的原数据可以参考doc.rust-lang.org/cargo/refer...

下面是一个示例的原数据:

ini 复制代码
[package]
name = "first_crate_yinuo"
version = "0.1.0"
author = ["kotlindev"]
edition = "2021"
description = "A Rust tutorials"
license = "MIT"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies]

3. 发布crate

未提交代码使用cargo publish --allow-dirty测试。 使用cargo pushlish进行发布。要注意的是,如果发布失败,原因可能是因为你的<crates.io>的账号还没绑定验证的邮箱,或者你的crate的元信息缺失,需要根据错误提示补充即可。

crate一旦发布,就是永久性的:该版本无法覆盖,代码无法删除。因为<crates.io>希望成为永久的代码托管服务器,并且依赖于该版本的项目可以继续正常工作。如果允许开发者删除已经发布的代码,那么将无法达到这个目的。

4. 发布已存在的crate新版本

在修改crate的代码之后,当我们需要发布新版本时,需要先修改Cargo.toml里面的version值。可以参考语义化版本控制规范semver.org来定义你的语意版本。最后执行cargo publish进行发布。

5. 使用cargo yank从crates.io撤回版本

我们不可以删除之前的版本,不会删除任何代码,但可以防止其他项目把某个版本最为新的依赖,使用yank可撤回一个crate版本即可。该操作防止新项目依赖于该版本,但已经存在的项目可以继续将其作为依赖并可以下载。

yank意味着:所有已经产生Cargo.lock的项目不会中断,同时任何将来新生成的Cargo.lock文件都不会使用被yank的版本。

撤回命令如下示例:

bash 复制代码
cargo yank --version 1.0.1

取消撤回如下命令

bash 复制代码
cargo yank --version 1.0.1 --undo
相关推荐
灰灰勇闯IT1 小时前
Flutter for OpenHarmony:布局组件实战指南
前端·javascript·flutter
⑩-1 小时前
Vue框架学习
前端·vue.js·学习
a程序小傲1 小时前
京东Java面试被问:基于Gossip协议的最终一致性实现和收敛时间
java·开发语言·前端·数据库·python·面试·状态模式
小二·1 小时前
Python Web 开发进阶实战:AI 原生应用商店 —— 在 Flask + Vue 中构建模型即服务(MaaS)与智能体分发平台
前端·人工智能·python
Devlive 开源社区1 小时前
技术日报|推理RAG文档索引PageIndex登顶日增1374星,React视频工具Remotion二连冠进前二
前端·react.js·前端框架
xkxnq1 小时前
第三阶段:Vue 路由与状态管理(第 45 天)(路由与状态管理实战:开发一个带登录权限的单页应用)
前端·javascript·vue.js
方方洛2 小时前
技术实践总结:schema-bridgion:json、xml、yaml、toml文件相互转换
xml·前端·typescript·node.js·json
object not found2 小时前
基于uniapp开发小程序自定义顶部导航栏状态栏标题栏
前端·javascript·小程序·uni-app
We་ct2 小时前
LeetCode 28. 找出字符串中第一个匹配项的下标:两种实现与深度解析
前端·算法·leetcode·typescript
xzl042 小时前
小智服务端chat入口工具调用流程
java·服务器·前端