使用try-convert將.NET Framework項目遷移到.NET Core

工具地址:GitHub - dotnet/try-convert:幫助 .NET 開發人員將他們的項目移植到 .NET Core!

這是一個簡單的工具,有助於將.NET Framework項目遷移到.NET Core。

如何使用它

在此處將其作爲全局工具安裝:

dotnet tool install -g try-convert
 

如果您已經安裝了它,請確保更新:

dotnet tool update -g try-convert
 

如果您再次使用該工具,請確保您使用的是最新版本:https://github.com/dotnet/try-convert/releases

如何使用該工具

嘮叨到解決方案的根目錄,只需執行:

try-convert
 

或者,您可以做

try-convert -w .
 

如果只想轉換特定的子文件夾、解決方案或項目,請鍵入:

try-convert -w path-to-folder-or-solution-or-project
 

如果需要該工具的更多幫助,請運行:

try-convert -h
 

由於這是用於轉換較舊的.NET Framework(Windows)項目,因此該工具僅適用於Windows。

注意:不要從 Visual Studio 開發人員命令提示符使用此工具。那裏發生了特殊的MSBuild分辨率,最終與該工具不兼容。請使用普通的終端應用程序。

如何構建

簡單:克隆存儲庫並運行

build.cmd
 

若要在本地使用該工具,需要從源代碼生成它。一旦構建完成,該工具將存在於:

/artifacts/bin/try-convert/Debug/net6.0/try-convert.exe
 

或者,您可以查看以下目錄並將其複製到計算機上的其他位置:

mv /artifacts/bin/try-convert/Debug/net6.0/publish C:/Users/<user>/try-convert
 

您也可以從發佈目錄調用該工具。

支持政策

此工具不受任何支持。沒有人會爲解決它的任何問題而陷入困境,也沒有人有義務構建此工具的人添加任何請求的功能。

這是一個由 .NET 團隊成員在業餘時間構建的開源項目。儘管如果人們要求,我們將努力解決問題並添加功能,但提交的任何問題的默認答案將是“我們將審查實現此請求的拉取請求”。

這個工具是爲誰準備的?

此工具適用於希望獲得一些幫助將其項目遷移到 .NET Core(或 .NET SDK 樣式的項目)的任何人。

顧名思義,此工具不能保證將項目完全轉換爲 100% 工作狀態。該工具是保守的,可以儘可能好地確保轉換後的項目仍然可以加載到Visual Studio中並生成。但是,有大量因素可能導致項目可能無法加載或構建此工具明確未涵蓋的項目。其中包括:

  • 解決方案中可能具有的複雜自定義生成
  • 與 .NET Core 不兼容的 API 使用
  • 不受支持的項目類型(如 Xamarin、Web 窗體或 WCF 項目)

如果大部分代碼庫通常能夠遷移到 .NET Core(例如許多沒有特定於平臺的代碼的類庫),那麼此工具應該會有很大幫助。

強烈建議您在受源代碼管理的項目上使用此工具。

該工具有什麼作用?

它加載給定的項目並對其進行評估以獲取所有屬性和項的列表。然後,它將內存中的項目替換爲基於 .NET SDK 的簡單模板,然後重新評估它。

它在同一項目文件夾中執行第二次評估,以便通過通配自動拾取的項也將是已知的。然後,它應用有關已知屬性和項的規則,最終生成兩種狀態的差異以標識以下內容:

  • 現在可以從項目中刪除的屬性,因爲它們已由 SDK 隱式定義,並且項目具有默認值
  • 需要保留在項目中的屬性,因爲它們覆蓋了默認值或未在 SDK 中定義。
  • 可以刪除的項目,因爲它們是由 SDK 中的 glob 隱式引入的
  • 需要更改爲語法的項,因爲儘管它們是由 SDK 引入的,但會添加額外的元數據。Update
  • 需要保留的項,因爲它們不是 SDK 中隱式的。

此差異用於轉換給定的項目文件。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章