Atom飛行手冊翻譯 4 5 4 8

atom中的一些包是node模組，而不是atom的包。如果你想要修改這些node模組，例如atom-keymap，你需要把它們鏈結到不同於普通atom包的開發環境中。

下面是執行node模組的本地版本的步驟，而不是atom中的apm。我們使用atom-keymap作為乙個例子：

$ git clone $ cd atom-keymap $ npm install $ npm link $ apm rebuild # this is the special step, it makes the npm work with atom's version of node $ cd where-you-cloned-atom $ npm link atom-keymap

$ atom # should work!

然後，當你修改了node模組的**時，你必須執行npm install和apm rebuild。

atom包可以通過叫做服務的帶有版本控制的api，和其它包進行互動。在你的package.json檔案中指定乙個或者多個版本號來提供服務，每個版本號都要帶有乙個包的主模組中的方法。

}}}

在你的包的主模組中實現上面的方法。這些方法會在乙個包被啟用的任何時候呼叫，它們會使用它們的通訊服務。它們應該返回實現了服務api的乙個值。

module.exports =
activate: -> # ...
providemyservicev1: ->
adapttolegacyapi(myservice)
providemyservicev2: ->
myservice

與之相似，指定乙個或多個版本範圍來使用乙個服務，每個都帶有乙個包的主模組中的方法。

}}}

這些方法會在乙個包被啟用的任何時候呼叫，它們會提供它們的通訊服務。它們會接受到乙個通訊物件作為乙個引數。你通常需要在包提供的服務失效的時間中，進行同種型別的清除工作。從你使用服務的方法中返回乙個disposable來完成它：

= require 'atom'
module.exports =
activate: -> # ...
consumeanotherservicev1: (service) ->
useservice(adaptservicefromlegacyapi(service))
new disposable -> stopusingservice(service)
consumeanotherservicev2: (service) ->
useservice(service)
new disposable -> stopusingservice(service)

雖然到目前為止，你在開發乙個包的時候，發布是最通常的行為，但是你還需要做一些其它的事情。

如果你錯誤地發布了你的包的乙個版本，或者你發現了乙個顯眼的bug或安全漏洞，你可能想要撤銷這個版本的發布。例如，如果你的包叫做package-name而且錯誤的版本是v1.2.3，你可以執行如下命令：

apm unpublish [email protected]

你也可以擁有屬於github組織的包。任何人如果屬於乙個組織，並且這個組織具有乙個包所在倉庫的的推送許可權，它就可以發布這個包的新版本。

這是乙個永久的改變，而且沒有辦法撤銷！

如果你想要把你的包的支援移交給其它人，你應該向新的擁有者轉移這個包的倉庫。

在刪除你的倉庫之前撤銷發布你的包非常重要。如果你首先刪除了倉庫，你就會失去對包的訪問途徑，並且在沒有協助之下不能將其恢復。

如果你不再對你的包提供支援，並且找不到任何人來接盤，你可以從中撤銷發布你的包。例如，如果你的包叫package-name，你可以執行如下命令：

apm unpublish package-name

如果由於任何原因你需要重新命名你的包，你可以使用一條簡單的命令apm publish --rename，來修改你的包的package.json檔案中的name字段，推送（push）乙個新的提交（commit）和打上標籤（tag），以及發布重新命名之後的包。向之前名字傳送的請求會重定向到新的名字。

一旦乙個包的名稱被使用，它就不能其它包復用，即使原來的包撤銷了發布。

apm publish --rename new-package-name

現在你應該對atom核心api和系統有了更深入的理解。

Atom飛行手冊翻譯 4 5 4 8

Atom飛行手冊翻譯 2 2 在Atom中移動

Atom飛行手冊翻譯 2 2 在Atom中移動

Atom飛行手冊翻譯 2 12 在Atom中寫作

Atom飛行手冊翻譯 4 5 4 8

Atom飛行手冊翻譯 2 2 在Atom中移動

Atom飛行手冊翻譯 2 2 在Atom中移動

Atom飛行手冊翻譯 2 12 在Atom中寫作

相關推薦