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 變種版本。