開始為 Blockly 貢獻心力

Blockly 為開放原始碼,主要是由小型團隊維護。我們非常重視核心團隊外開發人員的貢獻;因為在沒有社群成員的情況下,我們無法建構所有要求的功能或修正所有回報的錯誤。本節提供的一般指南可能對您有所幫助,尤其是剛接觸開放原始碼的開發作業時。

如要瞭解您在封鎖之前應閱讀的 Blockly 相關資訊,請參閱在核心上貢獻內容為範例貢獻內容一節。

哪一個存放區?

存放區包含單一專案的所有檔案,Blockly 有兩個存放區:區塊核心和區塊範例。

Blockly Core 是 Blockly 程式庫的存放區。如果您想變更設定,以讓程式庫的所有使用者都能變更核心的 Blockly 行為,請使用這個存放區。

「Blockly 範例」是範例、外掛程式和程式碼研究室的存放區。當您要建立或修改外掛程式、編寫程式碼研究室、建立或修改範例時,請使用這個存放區。

操作方式

以下是您在進行變更時必須遵循的一般步驟。

  1. 按照「Tools」(工具) 區段中的連結安裝 Git 和節點。
  2. 建立分支並加以複製。GitHub 的教學課程存放區建立作業有很棒的教學課程。若要將其套用到區塊,只需根據您要使用的存放區,將每個 octocat/Spoon-Knife 執行個體替換為 google/blocklygoogle/blockly-samples 即可。
  3. 同步處理分支。GitHub 也提供了同步處理分支的教學課程。
  4. 請查看主要分支版本。在區塊核心中,這是 develop 分支版本。在區塊範例中,這是 master 分支。
  5. 安裝依附元件,並在根目錄執行 npm install 以建構工具。
  6. 在終端機中執行 git checkout -b myBranchName建立新的分支版本。這個名稱應有助於您記住自己目前的工作。
  7. 進行所需變更。
  8. 按照核心範例指南驗證變更
  9. 使用 git commit -am "fix: My commit message" 儲存變更進一步瞭解修訂版本訊息
  10. 使用 git push origin myBranchName 將變更推送至 GitHub。
  11. 在程式碼準備就緒時開啟提取要求。Blockly 團隊成員會檢閱您所做的變更,並在核准後合併至 Blockly。詳情請參閱 PR 審核程序