開發工具

Blockly 使用一些工具和程式庫進行開發,包括 Git、npm 和 Closure Compiler。本節會提供每項工具的基本說明,以及每項工具詳細資訊的連結。

我們透過指令碼使用許多這些工具。您不需要直接執行這些檔案。瞭解這些名稱仍有助於偵錯或回報問題/功能要求。

Git

Git 是版本管控系統,可用於追蹤及管理檔案變更。

GitHub

GitHub 是提供開放原始碼控管、協同合作及發布作業的託管平台。Git 會追蹤檔案;GitHub 提供流暢的介面,方便您查看程式碼、追蹤問題及查看變更記錄。

入門指南:如果您是 Git 和 GitHub 的新手,請逐步完成 GitHub 的quickstart教學課程,熟悉基本概念。

節點

Node.js 是在伺服器 (而非瀏覽器) 上執行 JavaScript 的方法,npm (詳見下文) 會在節點上執行。

npm

npm 具有兩件事:

  • 我們用來安裝依附元件及執行指令碼的指令列工具。
  • 我們用來發布程式碼的線上註冊資料庫,可讓其他開發人員輕鬆使用 Blockly。

開始使用安裝節點和 npm。

閉包編譯器

Closure Compiler 這項工具可以加快 JavaScript 下載和執行速度。我們利用這個 API 將所有 JavaScript 檔案合併成單一程式庫,也會用來檢查語法和類型。

開始使用:您不需要直接安裝或執行 Closure Compiler,系統會透過 npm 安裝並執行。

瞭解詳情:Closure 編譯器說明文件,瞭解 JavaScript 類型類型註解

ESLint

ESLint 是一種靜態分析工具,可找出 JavaScript 程式碼的問題。我們用來在程式碼集中定義及強制執行一致的樣式。有關程式碼的小問題 (缺少分號、空格不一致等) 通常稱為 Lint。當您傳送提取要求時,ESLint 會自動執行。您也可以在本機執行應用程式。

開始使用:在 Blockly 核心和區塊範例範例中,您可以使用 npm run lint 執行 ESLint。許多程式碼編輯器還提供 ESLint 整合功能,讓您在輸入時即時顯示問題。

瞭解詳情:每項 ESLint 規則都有說明文件頁面,其中說明瞭規則,並提供正確和錯誤程式碼的範例。

摩卡棕

Mocha 是 JavaScript 測試架構。我們使用它,在瀏覽器和 Node.js 中執行測試 (適用於無頭用途)。

開始使用:在 Blockly 核心和區塊範例中,您都可以使用 npm run test 執行 Mocha 測試。在 Blockly Core 中,這麼做也會執行其他測試。區塊核心的 Mocha 測試是在 tests/mocha 目錄中定義。

瞭解詳情:Mocha 可讓開發人員定義「掛鉤」,讓您為測試定義集中式設定和拆解函式。

奶茶色

Chai 是我們 Mocha 測試中所使用的斷言程式庫。

瞭解詳情:Chai 有多個「變種版本」,方便您與現有專案整合。封鎖使用 assert 變種版本。