forgetChild() 方法必須呼叫 super

近期針對全域 key 重複偵測的重構，現在要求 Element 子類別若有覆寫 forgetChild()，必須呼叫 super()。

當遇到全域 key 重複且該問題會在元素重建時被清除時， 我們不應回報全域 key 重複。 先前的實作在偵測到重複時會立即拋出錯誤， 而不會等待重建（即使該重複的全域 key 元素即將被重建）。

新的實作會在一次建構週期內追蹤所有全域 key 重複情形， 並僅在該週期結束時才驗證全域 key 是否重複， 而不是立即拋出錯誤。作為重構的一部分， 我們實作了一套機制，若發生重建，則會在 forgetChild 中移除先前的全域 key 重複紀錄。 然而，這需要所有覆寫 forgetChild 的 Element 子類別 都必須呼叫 super 方法。

抽象類別 Element 的 forgetChild 具有基礎實作， 用於移除全域 key 保留， 並透過 @mustCallSuper meta 標籤強制執行。 所有覆寫該方法的子類別都必須呼叫 super； 否則，分析器會顯示 lint 錯誤， 且全域 key 重複偵測可能會拋出非預期錯誤。

以下範例中，某個應用程式的 Element 子類別覆寫了 forgetChild 方法。

遷移前的程式碼：

class CustomElement extends Element {
​
    @override
    void forgetChild(Element child) {
        ...
    }
}

遷移後的程式碼：

class CustomElement extends Element {
​
    @override
    void forgetChild(Element child) {
        ...
        super.forgetChild(child);
    }
}

納入版本：1.16.3
穩定版發行：1.17

API 文件：

• Element
• forgetChild()

相關議題：

• Issue 43780

相關 PR：

• PR 43790: Fix global key error