排除開發人員工具

Blockly 開發人員工具是一項網頁式開發人員工具,可協助您建構自訂區塊,並加入應用程式。

顯示工具箱和各種輸出區域的 Block Factory 螢幕截圖

定義區塊

Block Factory 工作區一開始會有空白的設定區塊。您可以在工具箱中,拖曳工具箱中各個類別內的區塊,藉此將「輸入內容」和「欄位」新增至區塊。您也可以修改設定區塊,為區塊設定工具提示文字、說明網址、顏色和連線檢查。

Block Factory 一次只能建立一種類型的區塊。如果想設計多個連接在一起的區塊,您必須分別設計這些區塊,並在工具箱定義中加以連結。此外,區塊可以有變動器等進階功能,但這些進階功能無法在 Factory 中建立。建立區塊的基本格式後,您必須根據說明文件修改區塊定義。

當您修改工作區中的設定區塊時,區塊的預覽也會自動更新。您必須新增至應用程式的程式碼也會自動更新。

輸出設定

Blockly 支援各種定義區塊和自行載入 Blockly 的方法,以及提供多種內建程式碼產生器語言。定義區塊和區塊程式碼產生器的方式取決於這些因素,因此您可以在 Block Factory 設定這些因素,藉此變更程式碼的輸出內容。

輸出設定面板的螢幕截圖,其中包含區塊匯入格式、區塊定義格式和程式碼產生器語言的選取器

區塊匯入格式

您可以透過 HTML 中的 <script> 標記載入 Blockly,或者,如果您將建構工具與應用程式搭配使用,則可使用 import 陳述式。您的選擇會影響您參照 Blockly API 特定部分的方式。如要進一步瞭解要選擇哪個選項,請參閱載入 Blockly 的說明文件。無論您使用哪種方法,請務必在 Block Factory 中選取對應的選項,以便您新增至應用程式的程式碼準確無誤。

封鎖定義格式

Blockly 支援以 JSON 或 JavaScript 定義區塊。偏好使用 JSON 格式,但如果您要新增變數等進階功能,可以使用 JavaScript 格式。

程式碼產生器語言

出貨時提供多種程式碼產生器語言。請選擇應用程式需要的語言,即可顯示對應的區塊程式碼產生器虛設常式。如果您使用自訂語言產生器,只要將程式碼複製到應用程式,就可以修改自訂 CodeGenerator 類別的名稱。

程式碼輸出內容

Block Factory 的後續章節會顯示您必須複製到應用程式的程式碼,才能載入您建立的區塊。您複製程式碼的位置取決於應用程式的建構方式,但一般來說,您必須在定義和區塊程式碼產生器之前執行程式碼標頭、區塊定義才能使用工具箱,以及在嘗試產生工作區程式碼之前。在每個區段中,您可以使用複製按鈕,複製該區段的整個程式碼區塊。

如果您還是不確定如何使用程式碼輸出內容,可以考慮使用範例應用程式,其中包含自訂區塊和區塊程式碼產生器的範例。

程式碼標頭

「Code Headers」區段顯示載入核心 Blockly 程式庫所需的程式碼,以及您選擇的語言產生器。此處可能也有其他設定;例如,您可能會在區塊中加入的部分欄位來自 Blockly 外掛程式。這些外掛程式會有自己的匯入陳述式,可能也需要執行其他程式碼來初始化欄位。這個程式碼應加在以下程式碼區段之前。

封鎖定義

「區塊定義」可讓您告知 Blockly 的形狀,例如它具有哪些欄位和輸入內容、顏色等。執行這段程式碼後,Blockly 會瞭解如何僅根據其 type 建立區塊。

如果您使用的是範例應用程式,可以將這段程式碼放入 blocks/ 目錄下的檔案。如果您有自己的應用程式結構,請務必加入這個程式碼,再嘗試依名稱參照區塊 (例如在工具箱定義中)。無論哪種方式,請確定程式碼標頭位於包含此程式碼的檔案中。

發電機虛設常式

區塊程式碼產生器可讓您說明應為區塊產生的程式碼。Block Factory 建立的產生器虛設常式會提供基本程式碼,可讓您取得區塊上的輸入值和欄位值。您可自行決定將這些值組合到即將產生的最終程式碼!

如果您使用的是範例應用程式,可以將這段程式碼放入 generators/ 目錄下的檔案。如果您有自己的應用程式結構,請務必先加入此程式碼,再嘗試為包含自訂區塊的工作區產生程式碼。無論使用哪種方式,請確認程式碼標頭位於包含這段程式碼的檔案中。

影片逐步操作說明

這部影片會詳細說明定義區塊的步驟。UI 版本過舊,但醒目顯示的封鎖功能仍較不準確。

封鎖程式庫

每當您對區塊進行變更,區塊就會自動儲存在瀏覽器的本機儲存空間中。您可以按一下頂端工具列中的對應按鈕,建立新的區塊或載入本機儲存空間中的現有區塊。

從舊版封鎖工廠匯入

如果您使用舊版區塊工廠,且想將現有的區塊定義遷移至新工具,請按照下列步驟操作:

  1. 在舊版區塊工廠中,按一下工具列上的 Export Block Library 按鈕。系統會下載包含所有封鎖定義的檔案。

    舊版 Block Factory 的螢幕截圖,其中醒目顯示「Export Block Library」按鈕

  2. 在新的 Block Factory 中按一下工具列中的 Load block 按鈕。

  3. 選取選單中的 [Import from Block Factory] 選項。

    醒目顯示「Load block」和「Import」按鈕的 Block Factory 螢幕截圖

  4. 上傳您在步驟 1 中下載的檔案。

  5. 封鎖定義應該會自動轉換為新格式,且現可在 Load block 選單中查看。如果與現有區塊發生衝突,區塊可能已重新命名。

  6. 如果剖析任何區塊時發生錯誤,就無法載入。您可以為區塊範例回報錯誤,並附上無法剖析的檔案,協助我們改進。