{"id":49186,"date":"2022-05-10T08:35:52","date_gmt":"2022-05-10T15:35:52","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/xamarin\/?p=49186"},"modified":"2022-05-10T20:00:58","modified_gmt":"2022-05-11T03:00:58","slug":"tips-for-porting-your-xamarin-library-to-dotnet-maui","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/xamarin\/tips-for-porting-your-xamarin-library-to-dotnet-maui\/","title":{"rendered":"Tips for Moving Your Xamarin Library to .NET MAUI"},"content":{"rendered":"
\n

Note: This is a Guest Blog Post by Microsoft MVP Luis Matos<\/a>. Luis is a System Engineer who specializes in helping companies and professionals create value in their software products.<\/p>\n<\/blockquote>\n

If you are a Xamarin.Forms Library maintainer and haven’t yet ported your library to .NET MAUI, then you are in the right place! In this post, I will be sharing the tips that I learned porting my NuGet Package, Plugin.ValidationRules<\/a> to support .NET MAUI.<\/p>\n

Refactor or Rewrite or Bifurcate?<\/h3>\n

Your Xamarin.Forms SDK library is likely targeting .NET Standard, Xamarin.iOS and Xamarin.Android. Some of your code may be ready to come along for the ride, and some may not. You will go through a process involving sorting through the projects and determining what to upgrade, abandon, or rewrite.<\/p>\n

Once you change update the Target Frameworks (TFMs) to net6.0<\/code>, net6.0-ios<\/code> and net6.0-android<\/code>, you will have to look at each of your projects one-by-one and see if you have any compatibility issues. You may find that you simply don\u2019t have to do anything. And in some cases, you may have to update some code.<\/p>\n

Refactoring<\/strong> involves updating existing code to work in the new environment under .NET 6.<\/p>\n

Bifurcation<\/strong> means copying old code and pasting it into a new .NET 6 project. If you\u2019re coming from .NET Standard you probably don\u2019t need to do this, but you may need to update some namespaces.<\/p>\n

Understand your dependencies<\/h3>\n

If your library has dependencies on other libraries or projects, you should take the time to examine their dependencies and determine what you can or cannot migrate. The external NuGet Packages that your projects depend on cannot target Xamarin.iOS or Xamarin.Android; they must instead target net6.0-ios<\/code> and net6.0-android<\/code>.<\/p>\n

Upgrade the CSPROJ Project<\/h3>\n

The new CSPROJ format is known as SDK style.<\/p>\n

\ud83d\udea8 IMPORTANT \ud83d\udea8<\/p>\n

If your library uses the MSBuild.Sdk.Extras<\/code> SDK, you must change it to use Microsoft.NET.Sdk<\/code>:<\/p>\n

<!-- Old SDK reference -->\n<Project Sdk=\"MSBuild.Sdk.Extras\">\n   ...\n<\/Project>\n\n<!-- New SDK reference -->\n<Project Sdk=\"Microsoft.NET.Sdk\">\n   ...\n<\/Project><\/code><\/pre>\n
Implement Single-Project Multitargeting<\/h3>\n
To learn more about Single-Project Multitargeting<\/a>, I recommend to first read through Microsoft’s Documentation<\/a>.<\/p>\n
When your projects use the SDK Style project format, you can target multiple frameworks in the same project using <TargetFrameworks><\/code>:<\/p>\n
<Project Sdk=\"Microsoft.NET.Sdk\">\n  <PropertyGroup>\n    <TargetFrameworks>net6.0;net6.0-android;net6.0-ios<\/TargetFrameworks>\n    ...\n  <\/PropertyGroup>\n<\/Project><\/code><\/pre>\n
Fix Code Issues<\/h3>\n
Targeting the newer .NET 6 frameworks may cause some compilation and dependency issues. Some .NET libraries may not have versions compatible with .NET 6. You’ll need to correct all the compiler issues that appear.<\/p>\n
If .NET 6 is missing a library that you use, you will need to find an alternative or write the code yourself. The best thing is to replace it with a more recent, supported, library.<\/p>\n
You can take this opportunity to refactor your existing code and add unit tests. You should be able to upgrade all your projects without changing too much of the original code.<\/p>\n
\ud83d\udca1TIP<\/p>\n
Where .NET 6 is incompatible with legacy code, you can use #if !NET6<\/code> so that the old code stays exactly the same.<\/p>\n
Leverage Existing Code<\/h3>\n
Your previous code may still work on .NET 6 with a few small tweaks, so you can usually find a way to reuse your code.<\/p>\n
Keep filenames the same during the whole process. If you move files into new folders etc. you will have a lot of difficulty with merging.<\/p>\n
Conclusion<\/h3>\n
If you want your libraries to be consumed for the .NET MAUI community you must update your library to support net6.0<\/code>, net6.0-ios<\/code>, and net6.0-android<\/code>.<\/p>\n
Upgrading your codebase in most scenarios can be easy.<\/p>\n
And hey! You are not alone, if you need help just ask on Twitter with the hashtags #dotnetmaui<\/code> #dotnet<\/code> and we will be there for you. And you can always write to me on Twitter at @luismatosluna<\/a>.<\/p>\n
I hope you find this blog post useful. A hug, and until next time.<\/p>\n","protected":false},"excerpt":{"rendered":"
Join me as I share the tips that I learned porting my NuGet Package, Plugin.ValidationRules to support .NET MAUI<\/p>\n","protected":false},"author":90770,"featured_media":49187,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[9211,556,1,367],"tags":[8867,8061,27],"class_list":["post-49186","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net-maui","category-integrations","category-xamarin","category-xamarin-forms","tag-net-maui","tag-libraries","tag-xamarin"],"acf":[],"blog_post_summary":"
Join me as I share the tips that I learned porting my NuGet Package, Plugin.ValidationRules to support .NET MAUI<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/49186","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/users\/90770"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/comments?post=49186"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/49186\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media\/49187"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media?parent=49186"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/categories?post=49186"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/tags?post=49186"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}