開始使用 Yeoman

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

許多產生器依賴於建構系統(例如 GruntGulp)和套件管理員(例如 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 指令會診斷並提供解決最常見問題的步驟。

建立產生器

請參閱 建立