1 unstable release
| 0.1.0 | Oct 4, 2021 |
|---|
#290 in Template engine
200KB
Crates.io
创建并登录Crates.io账号
发布crate前, 需要在 crates.io 创建账号(使用github授权登录)并获得API token
运行命令: cargo login [你的API token]
- 通知cargo, 你的 API token 存储在本地
~/.cargo/credentials文件中
- revoke 撤销之前设置的token
为新的 crate 添加元数据
在发布 crate 之前, 需要在 Cargo.toml 的 [package] 区域为 crate 添加一些元数据:
- crate 需要唯一的名称(name)
- 在 Crates.io 上搜一下, 看是否已被占用
- description: 一两句话即可, 会出现在 crate 搜索的结果里
- license: 需要提高许可证标识值 (可到 http://spdx.org/licenses/ 查找)
- 可指定多个 license, 用 OR 隔开
- version
- author
cargo publish发布
cargo publish
一旦发布, 就是永久性的
crate 一旦发布, 就是永久性的
- 版本无法覆盖
- 代码无法删除
这是因为 Crates.io 希望成为一个永久的代码文档服务器, 并保证所有依赖于 Crates.io 的包都能一直正常构建
如果允许开发者删除已经发布的版本, 那就根本无法达到这个目的。
发布已存在 crate 的新版本
修改 crate 后, 需要先修改 Cargo.toml 里面的 version 值, 再进行重新发布
参照 http://semver.org/ 来更新你的语义版本
报错汇总
- 登入 Crates.io 的账号必须要验证邮箱
Cargo.toml 内必须包含的[package]元信息如本次提交所示
cargo yank撤回
cargo yank命令可以从 Crates.io 撤回版本
cargo yank --vers 1.0.0
这里的撤回 并不是指 删除之前发布的版本,
而只是防止其它新的项目把它作为新的依赖
并不会影响已经存在的项目继续将其（这个版本）作为依赖和下载
- 即那些已经记录在 Cargo.lock 中的项目并不会中断对该版本的使用
- 但任何在我们撤回动作之后项目 都无法使用这个被 yank 的版本
取消撤回
我们还能取消我们的撤回
cargo yank --vers 1.0.0 --undo