維護你的包 · Atom 飛行手冊中文版

# 維護你的包 # 雖然到目前為止，你在開發一個包的時候，發布是最通常的行為，但是你還需要做一些其它的事情。 ## 撤銷發布一個版本 ## 如果你錯誤地發布了你的包的一個版本，或者你發現了一個顯眼的bug或安全漏洞，你可能想要撤銷這個版本的發布。例如，如果你的包叫做`package-name`而且錯誤的版本是v1.2.3，你可以執行如下命令： ``` apm unpublish package-name@1.2.3 ``` 這會從 https://atom.io/ 包注冊處移除特定的版本。任何下載了這個版本的人會依然保留它，但是它不再對其它人提供安裝。 ## 添加協作人 ## 一些包對于一個人來說太大了。有時優先級會更改，或者其它人想要提供幫助。你可以在你的包的GitHub倉庫中，通過[添加它們到協作者](https://help.github.com/articles/adding-collaborators-to-a-personal-repository/)，來讓其它人幫忙或者創建共同擁有者。注意：任何具有你的倉庫推送（push）權限的人，都可以發布屬于這個倉庫的包的新版本。你也可以擁有屬于[Github組織](https://help.github.com/articles/creating-a-new-organization-account/)的包。任何人如果屬于一個組織，并且這個組織具有一個包所在倉庫的的推送權限，它就可以發布這個包的新版本。 ## 轉移控制權 ## 這是一個永久的改變，而且沒有辦法撤銷！如果你想要把你的包的支持移交給其它人，你應該向新的擁有者[轉移這個包的倉庫](https://help.github.com/articles/transferring-a-repository/)。 ## 撤銷發布你的包 ## 在刪除你的倉庫之前撤銷發布你的包非常重要。如果你首先刪除了倉庫，你就會失去對包的訪問途徑，并且在沒有協助之下不能將其恢復。如果你不再對你的包提供支持，并且找不到任何人來接盤，你可以從 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 ```