將 Fabric 項目從 1.6.3 升級到 3.6.x

Question

在我的一個 canvas 項目中，我已經使用 fabric.js 很長時間了。 目前，我的項目是建立在 1.6.3 版的 fabric 之上的。

現在，由於它對動畫的限制，在最近的版本中已經解決了同樣的問題。 我想將它升級到 3.6.x 但在這樣做的同時，我意識到它有大量的折舊和升級。 我的項目目前有大約 20k 行代碼。 手動執行此操作當然不是一個可行的選擇。

任何人都可以提出更好的解決方案嗎？ 可能是一個遷移腳本或類似的東西來拯救自己。

Answer 1

據我所知，沒有升級/遷移腳本可以自動執行讓您的代碼在最新版本的 Fabric.js 下運行的過程。 不過，為了讓您入門，這里有一些提示。

從 v1.6.3 升級到 v2.x

Fabric.js 版本 v2.x 可能是主要版本中最大的突破性變化。 除了已刪除的幾種方法之外，為了適應新的圖像裁剪功能，處理圖像高度和寬度的方式也發生了重大變化。 以下指南概述了這些更改，還包括一些示例代碼以幫助反序列化 pre-v2.0 JSON 字符串。

• http://fabricjs.com/changes-introduction
• http://fabricjs.com/v2-break-changes
• http://fabricjs.com/v2-break-changes-2

從 v2.4.0 開始，添加了clipPath支持，允許您使用另一個 Fabric object 剪輯 object 或 canvas。 以前執行此操作的clipTo方法現在被標記為已棄用，因此如果您的項目使用clipTo ，您應該真正開始進行此轉換。 請參閱此 4 部分指南以更好地了解新功能。

• http://fabricjs.com/clippath-part1
• http://fabricjs.com/clippath-part2
• http://fabricjs.com/clippath-part3
• http://fabricjs.com/clippath-part4

從 v2.x 升級到 v3.x

Fabric.js v3.x 的重大更改比 v2.x 少。 刪除了對節點 4 和 6 的支持，並且現在在某些情況下需要 object 緩存而不是可選的，但這次升級更多的是關於新功能而不是重大變化。

有關每個版本的詳細更改列表，請參閱http://fabricjs.com/changelog 。

從 v3.x 升級到 v4.x

我也包含了這一部分，因為盡管此時 v4.x 分支仍處於測試階段，但有很多重大更改主要涉及刪除舊方法。 如果您現在進行這些更改，您仍然可以在 v3.x 分支上運行您的項目，直到 v4.x 退出測試版。

一個很大的變化是clipTo方法終於被刪除了，所以如果你還在使用clipTo ，你需要轉而使用clipPath 。

v4.x 中最大的改進是一個新的自定義控制界面。 使用此系統，您將能夠自定義每個控件的 function，添加圖標，甚至為您的對象添加新控件。 有關新系統的幫助，請參閱以下演示。

• http://fabricjs.com/custom-control-render
• http://fabricjs.com/custom-controls-polygon

請參閱https://github.com/fabricjs/fabric.js/releases以獲取 v4.x 分支中當前更改和刪除方法的列表。

玩得開心！