Skip to content

Commit

Permalink
Add a table index to Upgrade overview (#1586)
Browse files Browse the repository at this point in the history
* adding a table index

* Edit

---------

Co-authored-by: David Britch <[email protected]>
  • Loading branch information
davidortinau and davidbritch authored Jul 25, 2023
1 parent bbfd454 commit 8cebfaf
Showing 1 changed file with 20 additions and 3 deletions.
23 changes: 20 additions & 3 deletions docs/migration/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,36 @@ ms.date: 02/15/2023

# Upgrade from Xamarin to .NET

Xamarin projects can run on .NET, starting with .NET 6, after completing an upgrade process. This series of articles describe the process for migrating your Xamarin projects to .NET.
Xamarin projects can run on .NET, starting with .NET 6, after completing an upgrade process. The following table lists the Xamarin project types that can be upgraded to .NET:

| Project type | Upgrade | Guide |
|-------------------------|---------|---------------------------------------------------|
| Xamarin.Android || [Upgrade Xamarin native projects](native-projects.md) |
| Xamarin.iOS || [Upgrade Xamarin native projects](native-projects.md) |
| Xamarin.Mac || [Upgrade Xamarin native projects](native-projects.md) |
| Xamarin.tvOS || [Upgrade Xamarin native projects](native-projects.md) |
| Xamarin.Forms || [Upgrade Xamarin.Forms projects](forms-projects.md) |
| iOS App Extensions || [Upgrade Xamarin native projects](native-projects.md) |
| Android Wear || [Upgrade Xamarin native projects](native-projects.md) |
| Android Binding Library || Upgrade to SDK Style projects |
| iOS Binding Library || Upgrade to SDK Style projects |
| SpriteKit || [Upgrade Xamarin native projects](native-projects.md) |
| SceneKit || [Upgrade Xamarin native projects](native-projects.md) |
| Metal || [Upgrade Xamarin native projects](native-projects.md) |
| OpenGL | ❌ (iOS) | Removed from iOS since OpenTK isn't available |
| Xamarin.watchOS || Recommendation: bundle Swift extensions with .NET for iOS apps |

<!-- markdownlint-disable MD032 -->
> [!IMPORTANT]
> To migrate an app from Xamarin to .NET:
> To upgrade an app from Xamarin to .NET:
> - All projects **do** need to become SDK-style.
> - Projects **don't** need to be rewritten.
> - Multi-project solutions **don't** need to become a multi-targeted single project.
<!-- markdownlint-enable MD025 -->
To upgrade your Xamarin native projects to .NET, you'll first have to update the projects to be SDK-style projects and then update your dependencies to .NET 6+. For more information, see [Upgrade Xamarin.Android, Xamarin.iOS, and Xamarin.Mac apps to .NET](native-projects.md).

The .NET Upgrade Assistant is a command-line tool that can help you upgrade Xamarin.Forms projects to .NET Multi-platform App UI (.NET MAUI). After running the tool, in most cases the app will require additional effort to complete the migration. For more information, see [Upgrade a Xamarin.Forms app to .NET MAUI with the .NET Upgrade Assistant](upgrade-assistant.md).
The .NET Upgrade Assistant is a command-line tool that can help you upgrade Xamarin.Forms projects to .NET Multi-platform App UI (.NET MAUI). After running the tool, in most cases the app will require additional effort to complete the upgrade. For more information, see [Upgrade a Xamarin.Forms app to .NET MAUI with the .NET Upgrade Assistant](upgrade-assistant.md).

Alternatively, you can manually upgrade a Xamarin.Forms project to .NET MAUI with a two-step process:

Expand Down

0 comments on commit 8cebfaf

Please sign in to comment.