針對Telerik UI for WinForms的每個版本，技術團隊都盡量避免引入影響公共 API 的更改。但是有時需要進行此類更改才能使產品發展，這可能會導致應用程序升級到最新的 Telerik 版本時出現問題，這時就需要Telerik升級API Analyzer，其目的是通過比較兩個版本并確定有問題的區域，使您的升級過程更容易。

Telerik Upgrade API Analyzer可用于升級桌面應用程序（如 WPF 或 WinForms）以及 Silverlight 或 ASP.NET Web 應用程序。

Telerik Upgrade API Analyzer目前支持從 R1 2015 到當前的Telerik 版本，可以根據要求添加其他版本。

注意：如果您收到一條消息說找不到 DataFlow 程序集，您可能需要安裝 Microsoft build tools。

為什么需要這個工具？

Telerik Upgrade API Analyzer 工具將幫助您將 Telerik 控件升級到更新版本，它會徹底分析您的項目代碼，并提供在當前使用的版本和您計劃升級到的版本之間發現的更改列表。 此類更改可能包括過時和刪除的方法和屬性，以及修改后的方法和屬性。 此外，該工具會指出受特定更改影響的確切代碼段，并且在涉及過時方法/屬性的情況下，該工具會提供有關如何修改該代碼的建議。

注意：在此開發階段，Telerik Upgrade API Analyzer 僅檢查應用程序的 C# 代碼。

從哪里獲得Telerik Upgrade API Analyzer？

Telerik Upgrade API Analyzer是一個 ClickOnce 應用程序，您可以直接從下載安裝文件。

注意：該工具依賴于 Microsoft .NET Framework 4.5.2，如果您的機器上沒有該框架，該工具的設置會自動安裝它。

如何使用該工具？

運行 Telerik Upgrade API Analyzer 會打開圖 1 所示的屏幕。

圖 1：Telerik Upgrade API Analyzer 的初始屏幕

您需要做的就是：

1. 選擇平臺。
2. 選擇您正在使用的 Telerik 程序集的當前版本。
3. 選擇您要升級到的版本。這三個組合框會根據您的選擇即時填充，因此您應該連續選擇所需的值。
4. 打開您計劃升級的解決方案。

注意：您還可以通過單擊Compatibility按鈕從升級項目向導運行Telerik Upgrade API Analyzer。在這種情況下，該工具將打開，其中包含向導中指出的技術、您的版本和升級版本參數。 當 Upgrade API Analyzer 直接通過 Compatibility 按鈕啟動而不先安裝工具時，安裝會自動開始。 如果您的計算機上不存在 .NET Framework 4.5.2，應用程序會在安裝結束時提示您手動安裝。

圖 2：升級項目向導中的Compatibility按鈕

該工具開始分析代碼，如圖 3 所示，并列出在兩個版本之間發現的所有更改，如圖 4 所示。

圖 3：一旦您打開解決方案，該工具就會開始分析

圖 4：Upgrade API Analyzer列表發現的差異

Upgrade API Analyzer以方便的方式提供了兩個版本之間發現差異的詳細列表，以供查看。 該工具使用 RadGridView for WPF 來呈現結果，因此您可以從其排序、過濾和調整列大小等功能中受益。

對于每個更改，您可以看到以下信息：

• Difference：它可以是過時的、刪除的和修改的。

默認情況下，Modified更改不會顯示，因為它們實際上表明方法/類中存在內部更改，這不會影響其整體功能，也不需要您進行任何操作。 盡管如此，您仍然可以通過更新差異列的過濾器來看到修改的更改，如圖 5 所示。

圖 5：顯示找到的所有更改，包括已修改的更改

• Kind：可以是類型、屬性、方法和字段。
• Node：類型/屬性/方法/字段的名稱。
• Assembly：發現更改的程序集。
• Message：呈現一種“現在做什么？” 信息；提供關于應該對具體更改采取什么操作以使升級完美無缺的附加信息。
• Project：更改所在的項目。
• Source：項目中發現更改的文件。
• Line：源文件中的確切行。
• Character：先前設置的行中的字符。

此外，Upgrade API Analyzer 提供了通過右上角的Export按鈕保存收集到的信息以供稍后使用的選項，如圖 6 所示。數據將被排列并導出到 HTML 文檔，導出的信息包括網格中當前可見（已過濾）的數據。

圖 6：API Analyzer提供到HTML文檔的導出

Telerik UI for WinForms| 下載試用

Telerik UI for WinForms擁有適用Windows Forms的110多個令人驚嘆的UI控件。所有的UI for WinForms控件都具有完整的主題支持，可以輕松地幫助開發人員在桌面和平板電腦應用程序提供一致美觀的下一代用戶體驗。

更多產品正版授權詳情及優惠，歡迎咨詢