Yeoman 是一個通用腳手架系統,允許建立任何類型的應用程式。它允許快速開始新的專案,並簡化現有專案的維護。
Yeoman 與語言無關。它可以在任何語言(網路、Java、Python、C# 等)中產生專案。
Yeoman 本身不做出任何決定。每個決定都是由產生器做出的,這些產生器基本上是 Yeoman 環境中的外掛程式。有一個許多公開的產生器,而且很容易建立一個新的產生器來符合任何工作流程。Yeoman 總是您建立腳手架需求的正確選擇。
以下是一些常見的用例
- 快速建立新的專案
- 建立專案的新區段,例如具有單元測試的新控制器
- 建立模組或套件
- 建立新的服務
- 強制執行標準、最佳實務和風格指南
- 透過讓使用者開始使用範例應用程式來推廣新專案
- 等等
入門
yo
是 Yeoman 的命令列公用程式,允許使用建立腳手架範本(稱為產生器)的專案。Yo 和使用的產生器是使用 npm 安裝的。
安裝 yo 和一些產生器
首先使用 npm
安裝 yo
npm install -g yo
然後安裝所需的產生器。產生器是命名為 generator-XYZ
的 npm 套件。在 我們的網站 上或在執行 yo
時選取「安裝產生器」選單選項來搜尋它們。要安裝 webapp
產生器
npm install -g generator-webapp
新的 Node 和 npm 使用者可能會遇到權限問題。這些問題會在安裝時以 EACCESS
錯誤的形式出現。如果發生這種情況,請參閱 npm 修正權限指南。
npm 是 Node.js 的套件管理員,並附帶在其中。
在 Windows 上,我們建議使用更好的命令列工具,例如 cmder
或 PowerShell,以改善體驗。
基本建立腳手架
我們將在以下範例中使用 generator-webapp
。將 webapp
替換為產生器的名稱,以獲得相同的結果。
要建立新專案的腳手架,請執行
yo webapp
大多數產生器會詢問一系列問題以自訂新的專案。若要查看有哪些選項可用,請使用 help
指令
yo webapp --help
許多產生器依賴於建構系統(例如 Grunt 或 Gulp)和套件管理員(例如 npm 和 Bower)。請務必瀏覽產生器的網站,瞭解如何執行和維護新的應用程式。透過執行以下動作,輕鬆存取產生器的主頁
npm home generator-webapp
建立複雜架構的產生器可能提供其他產生器來建立專案較小的部分。這些產生器通常稱為子產生器,並存取為 generator:sub-generator
。
以 generator-angular
為例。一旦產生了完整的 Angular 應用程式,就可以新增其他功能。若要將新的控制器加入專案,請執行控制器子產生器
yo angular:controller MyNewController
其他 yo 指令
除了在前一段落提到的基礎知識之外,yo
也是一個完全互動式的工具。只要在終端機輸入 yo
,就會提供管理所有與產生器相關的選項清單:執行、更新、安裝、協助及其他公用程式。
Yo 還提供下列指令。
yo --help
存取完整的說明畫面yo --generators
列出所有已安裝的產生器yo --version
取得版本
疑難排解
執行下列進行診斷就能找出大多數問題
yo doctor
doctor
指令會診斷並提供解決最常見問題的步驟。
建立產生器
請參閱 建立。