針對(duì)Telerik UI for WinForms的每個(gè)版本，技術(shù)團(tuán)隊(duì)都盡量避免引入影響公共 API 的更改。但是有時(shí)需要進(jìn)行此類更改才能使產(chǎn)品發(fā)展，這可能會(huì)導(dǎo)致應(yīng)用程序升級(jí)到最新的 Telerik 版本時(shí)出現(xiàn)問題，這時(shí)就需要Telerik升級(jí)API Analyzer，其目的是通過比較兩個(gè)版本并確定有問題的區(qū)域，使您的升級(jí)過程更容易。

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

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

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

為什么需要這個(gè)工具？

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

注意：在此開發(fā)階段，Telerik Upgrade API Analyzer 僅檢查應(yīng)用程序的 C# 代碼。

從哪里獲得Telerik Upgrade API Analyzer？

Telerik Upgrade API Analyzer是一個(gè) ClickOnce 應(yīng)用程序，您可以直接從下載安裝文件。

注意：該工具依賴于 Microsoft .NET Framework 4.5.2，如果您的機(jī)器上沒有該框架，該工具的設(shè)置會(huì)自動(dòng)安裝它。

如何使用該工具？

運(yùn)行 Telerik Upgrade API Analyzer 會(huì)打開圖 1 所示的屏幕。

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

您需要做的就是：

1. 選擇平臺(tái)。
2. 選擇您正在使用的 Telerik 程序集的當(dāng)前版本。
3. 選擇您要升級(jí)到的版本。這三個(gè)組合框會(huì)根據(jù)您的選擇即時(shí)填充，因此您應(yīng)該連續(xù)選擇所需的值。
4. 打開您計(jì)劃升級(jí)的解決方案。

注意：您還可以通過單擊Compatibility按鈕從升級(jí)項(xiàng)目向?qū)н\(yùn)行Telerik Upgrade API Analyzer。在這種情況下，該工具將打開，其中包含向?qū)е兄赋龅募夹g(shù)、您的版本和升級(jí)版本參數(shù)。 當(dāng) Upgrade API Analyzer 直接通過 Compatibility 按鈕啟動(dòng)而不先安裝工具時(shí)，安裝會(huì)自動(dòng)開始。 如果您的計(jì)算機(jī)上不存在 .NET Framework 4.5.2，應(yīng)用程序會(huì)在安裝結(jié)束時(shí)提示您手動(dòng)安裝。

圖 2：升級(jí)項(xiàng)目向?qū)е械腃ompatibility按鈕

該工具開始分析代碼，如圖 3 所示，并列出在兩個(gè)版本之間發(fā)現(xiàn)的所有更改，如圖 4 所示。

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

圖 4：Upgrade API Analyzer列表發(fā)現(xiàn)的差異

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

對(duì)于每個(gè)更改，您可以看到以下信息：

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

默認(rèn)情況下，Modified更改不會(huì)顯示，因?yàn)樗鼈儗?shí)際上表明方法/類中存在內(nèi)部更改，這不會(huì)影響其整體功能，也不需要您進(jìn)行任何操作。 盡管如此，您仍然可以通過更新差異列的過濾器來看到修改的更改，如圖 5 所示。

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

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

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

圖 6：API Analyzer提供到HTML文檔的導(dǎo)出

Telerik UI for WinForms| 下載試用

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

更多產(chǎn)品正版授權(quán)詳情及優(yōu)惠，歡迎咨詢