维护你的包


维护你的包

虽然到目前为止,你在开发一个包的时候,发布是最通常的行为,但是你还需要做一些其它的事情。

撤销发布一个版本

如果你错误地发布了你的包的一个版本,或者你发现了一个显眼的bug或安全漏洞,你可能想要撤销这个版本的发布。例如,如果你的包叫做package-name而且错误的版本是v1.2.3,你可以执行如下命令:

apm unpublish package-name@1.2.3

这会从 https://atom.io/ 包注册处移除特定的版本。任何下载了这个版本的人会依然保留它,但是它不再对其它人提供安装。

添加协作人

一些包对于一个人来说太大了。有时优先级会更改,或者其它人想要提供帮助。你可以在你的包的GitHub仓库中,通过添加它们到协作者,来让其它人帮忙或者创建共同拥有者。注意:任何具有你的仓库推送(push)权限的人,都可以发布属于这个仓库的包的新版本。

你也可以拥有属于Github组织的包。任何人如果属于一个组织,并且这个组织具有一个包所在仓库的的推送权限,它就可以发布这个包的新版本。

转移控制权

这是一个永久的改变,而且没有办法撤销!

如果你想要把你的包的支持移交给其它人,你应该向新的拥有者转移这个包的仓库。

撤销发布你的包

在删除你的仓库之前撤销发布你的包非常重要。如果你首先删除了仓库,你就会失去对包的访问途径,并且在没有协助之下不能将其恢复。

如果你不再对你的包提供支持,并且找不到任何人来接盘,你可以从 https://atom.io/ 中撤销发布你的包。例如,如果你的包叫package-name,你可以执行如下命令:

apm unpublish package-name

这个命令会从 https://atom.io/ 包注册处移除你的包。任何下载了你的包的副本的人依然会保留,以及能够使用它,但是它不再对其它人提供安装。

重命名你的包

如果由于任何原因你需要重命名你的包,你可以使用一条简单的命令apm publish --rename,来修改你的包的package.json文件中的name字段,推送(push)一个新的提交(commit)和打上标签(tag),以及发布重命名之后的包。向之前名字发送的请求会重定向到新的名字。

一旦一个包的名称被使用,它就不能其它包复用,即使原来的包撤销了发布。

apm publish --rename new-package-name