跳到主要內容

保持相容性

一旦人們用您的擴充功能建置專案，以錯誤的方式更改它實際上會損壞那些專案：積木消失、引數移位、值破壞。下面的規則關於不做那樣的事。

根本原因是專案儲存的方式。儲存的專案透過內部識別符號（擴充功能 ID、積木操作碼和引數名）引用您的積木，而不是它們的標籤。重新命名這些識別符號中的任何一個，儲存的專案就無法再找到積木。

絕不能更改的內容​

擴充功能 ID​

getInfo() {
  return {
    id: 'fetch', // 絕不能更改
    // ...
  };
}

積木操作碼和型別​

不要重新命名操作碼或改變它的用途。不要更改積木的 blockType，有兩個安全例外：REPORTER 到 BOOLEAN，以及 HAT 到 EVENT。其他任何更改（例如 HAT 到 BOOLEAN）都會破壞專案。要替換積木，新增一個新積木並隱藏舊的（見下文）。

移除積木​

永遠不要刪除專案可能使用的積木。用 hideFromPalette: true 隱藏它。現有的副本繼續工作；它只是不再出現在積木區中。

引數識別符號和型別​

引數的鍵（text: 'block [INPUT]' 中的 INPUT）及其 type 不得更改或移除。

向現有積木新增引數​

不要向已經存在的積木新增引數。而是新增一個新積木，並用新積木重新實現舊的：

blocks: [
  {
    blockType: Scratch.BlockType.REPORTER,
    opcode: 'oldBlock',
    text: 'old [INPUT1]',
    arguments: { INPUT1: { /* ... */ } },
    hideFromPalette: true
  },
  {
    blockType: Scratch.BlockType.REPORTER,
    opcode: 'newBlock',
    text: 'new [INPUT1] [INPUT2]',
    arguments: { INPUT1: { /* ... */ }, INPUT2: { /* ... */ } }
  }
]
oldBlock(args) {
  return this.newBlock({ ...args, INPUT2: 'Default value' });
}
newBlock(args) {
  // ...
}

isTerminal​

如果 COMMAND 積木還沒有 isTerminal: true，不要新增它。在下面連線了積木的現有專案會損壞。請新增一個新積木。

選單上的 acceptReporters​

永遠不要在欄位（acceptReporters: false）和輸入（acceptReporters: true）之間切換選單。它會損壞專案。建立新選單和積木。

行為​

瑣碎的 bug 修復通常沒問題。顯著改變積木的作用可能破壞依賴舊行為的專案。唯一可靠的保障是徹底測試。

可以安全更改的內容​

擴充功能後設資料：name、docsURI、color1/color2/color3、menuIconURI、blockIconURI。

每個積木和引數：

  • text，只要它仍然包含相同的引數（重新排序沒問題）
  • disableMonitor（開啟它隱藏核取方塊但保留現有監視器）
  • hideFromPalette
  • filter（新增它從積木區隱藏積木但保留現有副本）
  • defaultValue
  • 影像輸入上的 dataURI 和 flipRTL

對於選單，您可以自由更改專案 text，但更改專案的 value 有風險。新增選單專案總是安全的；移除它們是危險的。

當您確實必須破壞相容性時​

有時沒有相容的路徑。在這種情況下，製作一個帶新 ID 的全新擴充功能，並讓舊的原樣不動。如果 fetch 需要重新設計，發佈 fetch2 並保持 fetch 工作。

下一步​

接下來，C 形積木：自訂迴圈和條件。