search

dotnet / docs-maui

This repository contains documentation for .NET Multi-platform App UI (MAUI).
https://docs.microsoft.com/dotnet/maui
Creative Commons Attribution 4.0 International
231 stars 202 forks source link

Migrate from Xamarin.Essentials.VersionTracking to .NET MAUI VersionTracking #1691

Closed davidbritch closed 1 year ago

davidbritch commented 1 year ago

Users updating their apps from Xamarin.Forms to .NET MAUI may hit an issue if they stored data in their Forms app using Xamarin.Essentials Preferences.

Essentials Preferences has two options for storing data:

  1. Not specifying a value for the name of the data store (used by the Preferences API). Users who used the Preferences API in a Xamarin.Forms app should have no problems reading that data from a .NET MAUI app that uses the same package id.
  2. A shared name. The shared name is only used by the VersionTracking API and is {your-app-package-id}.xamarinessentials.versiontracking. In .NET MAUI the shared name is your-app-package-id}.microsoft.maui.essentials.versiontracking.

Therefore, there's no need to provide a doc on migrating data stored with the Essentials Preferences API to the MAUI Preferences API. But there may be a need to provide a doc on migrating their VersionTracking data from Essentials to MAUI.

https://github.com/xamarin/Essentials/blob/main/Xamarin.Essentials/Preferences/Preferences.shared.cs https://github.com/dotnet/maui/blob/main/src/Essentials/src/Preferences/Preferences.shared.cs

Associated WorkItem - 167747

davidbritch commented 1 year ago

In Essentials, the VersionTracking API uses a named store of {your-app-package-id}.xamarinessentials.versiontracking.