├── .editorconfig ├── .gitattributes ├── .github ├── FUNDING.yml └── workflows │ ├── ci-sample.yml │ ├── ci.yml │ └── release-nuget.yml ├── .gitignore ├── LICENSE ├── README.md ├── nuget.png ├── samples ├── Plugin.Maui.FormsMigration.Sample.sln └── Plugin.Maui.FormsMigration.Sample │ ├── App.xaml │ ├── App.xaml.cs │ ├── AppShell.xaml │ ├── AppShell.xaml.cs │ ├── MainPage.xaml │ ├── MainPage.xaml.cs │ ├── MauiProgram.cs │ ├── Platforms │ ├── Android │ │ ├── AndroidManifest.xml │ │ ├── MainActivity.cs │ │ ├── MainApplication.cs │ │ └── Resources │ │ │ └── values │ │ │ └── colors.xml │ ├── MacCatalyst │ │ ├── AppDelegate.cs │ │ ├── Info.plist │ │ └── Program.cs │ ├── Tizen │ │ ├── Main.cs │ │ └── tizen-manifest.xml │ ├── Windows │ │ ├── App.xaml │ │ ├── App.xaml.cs │ │ ├── Package.appxmanifest │ │ └── app.manifest │ └── iOS │ │ ├── AppDelegate.cs │ │ ├── Entitlements.plist │ │ ├── Info.plist │ │ └── Program.cs │ ├── Plugin.Maui.FormsMigration.Sample.csproj │ ├── Properties │ └── launchSettings.json │ └── Resources │ ├── AppIcon │ ├── appicon.svg │ └── appiconfg.svg │ ├── Fonts │ ├── OpenSans-Regular.ttf │ └── OpenSans-Semibold.ttf │ ├── Raw │ ├── AboutAssets.txt │ ├── dotnetbot.json │ └── ukelele.mp3 │ ├── Splash │ └── splash.svg │ └── Styles │ ├── Colors.xaml │ └── Styles.xaml └── src ├── Plugin.Maui.FormsMigration.sln └── Plugin.Maui.FormsMigration ├── AppProperties ├── Extensions.windows.cs ├── LegacyApplication.shared.cs ├── PropertiesDeserializer.android.cs ├── PropertiesDeserializer.ios.cs ├── PropertiesDeserializer.net.cs └── PropertiesDeserializer.windows.cs ├── Constants.shared.cs ├── Plugin.Maui.FormsMigration.csproj ├── SecureStorage ├── AndroidKeyStore.android.cs ├── KeyChain.ios.cs ├── LegacySecureStorage.android.cs ├── LegacySecureStorage.ios.cs └── LegacySecureStorage.windows.cs └── VersionTracking ├── LegacyPreferences.android.cs ├── LegacyPreferences.ios.cs ├── LegacyPreferences.net.cs ├── LegacyPreferences.shared.cs ├── LegacyPreferences.windows.cs └── LegacyVersionTracking.shared.cs /.editorconfig: -------------------------------------------------------------------------------- 1 | # Suppress: EC112 2 | # top-most EditorConfig file 3 | root = true 4 | 5 | # Default settings: 6 | # A newline ending every file 7 | # Use tabs as indentation 8 | [*] 9 | insert_final_newline = false 10 | indent_style = tab 11 | indent_size = 4 12 | 13 | # Code files 14 | [*.{cs,csx,vb,vbx}] 15 | indent_style = tab 16 | indent_size = 4 17 | 18 | # Code files 19 | [*.sln] 20 | indent_size = 4 21 | 22 | # Xml project files 23 | [*.{csproj,vbproj,vcxproj,vcxproj.filters,proj,projitems,shproj}] 24 | indent_size = 2 25 | 26 | # Xml config files 27 | [*.{props,targets,ruleset,config,nuspec,resx,vsixmanifest,vsct}] 28 | indent_size = 2 29 | 30 | # JSON files 31 | [*.json] 32 | indent_size = 2 33 | 34 | # XML files 35 | [*.xml] 36 | indent_size = 2 37 | 38 | [*.cs] 39 | 40 | # Organize usings 41 | dotnet_sort_system_directives_first = true 42 | 43 | # IDE0160: Use file scoped namespace 44 | csharp_style_namespace_declarations = file_scoped:error 45 | 46 | # CS4014: Because this call is not awaited, execution of the current method continues before the call is completed 47 | dotnet_diagnostic.CS4014.severity = error 48 | 49 | # Remove explicit default access modifiers 50 | dotnet_style_require_accessibility_modifiers = omit_if_default:error 51 | 52 | # CA1063: Implement IDisposable Correctly 53 | dotnet_diagnostic.CA1063.severity = error 54 | 55 | # Add braces (IDE0011) 56 | csharp_prefer_braces = true 57 | dotnet_diagnostic.IDE0011.severity = error 58 | 59 | # Pattern matching 60 | dotnet_style_object_initializer = true:suggestion 61 | dotnet_style_collection_initializer = true:suggestion 62 | dotnet_style_coalesce_expression = true:suggestion 63 | dotnet_style_null_propagation = true:suggestion 64 | dotnet_style_explicit_tuple_names = true:suggestion 65 | dotnet_style_prefer_is_null_check_over_reference_equality_method=true:suggestion 66 | 67 | csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion 68 | csharp_style_pattern_matching_over_as_with_null_check = true:suggestion 69 | csharp_style_inlined_variable_declaration = true:suggestion 70 | csharp_style_throw_expression = true:suggestion 71 | csharp_style_conditional_delegate_call = true:suggestions 72 | 73 | # Naming rules 74 | 75 | dotnet_diagnostic.IDE1006.severity = error 76 | 77 | ## Public Fields are kept Pascal Case 78 | dotnet_naming_symbols.public_symbols.applicable_kinds = field 79 | dotnet_naming_symbols.public_symbols.applicable_accessibilities = public 80 | 81 | dotnet_naming_style.first_word_upper_case_style.capitalization = first_word_upper 82 | 83 | dotnet_naming_rule.public_members_must_be_capitalized.symbols = public_symbols 84 | dotnet_naming_rule.public_members_must_be_capitalized.style = first_word_upper_case_style 85 | dotnet_naming_rule.public_members_must_be_capitalized.severity = suggestion 86 | 87 | ## Instance fields are camelCase 88 | dotnet_naming_rule.instance_fields_should_be_camel_case.severity = error 89 | dotnet_naming_rule.instance_fields_should_be_camel_case.symbols = instance_fields 90 | dotnet_naming_rule.instance_fields_should_be_camel_case.style = instance_field_style 91 | 92 | dotnet_naming_symbols.instance_fields.applicable_kinds = field 93 | 94 | dotnet_naming_style.instance_field_style.capitalization = camel_case 95 | dotnet_naming_style.instance_field_style.required_prefix = 96 | 97 | ## Static fields are camelCase 98 | dotnet_naming_rule.static_fields_should_be_camel_case.severity = error 99 | dotnet_naming_rule.static_fields_should_be_camel_case.symbols = static_fields 100 | dotnet_naming_rule.static_fields_should_be_camel_case.style = static_field_style 101 | 102 | dotnet_naming_symbols.static_fields.applicable_kinds = field 103 | dotnet_naming_symbols.static_fields.required_modifiers = static 104 | dotnet_naming_symbols.static_fields.applicable_accessibilities = internal, private, protected, protected_internal, private_protected 105 | 106 | dotnet_naming_style.static_field_style.capitalization = camel_case 107 | dotnet_naming_style.static_field_style.required_prefix = 108 | 109 | # Modifier preferences 110 | csharp_prefer_static_local_function = true:suggestion 111 | csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:error -------------------------------------------------------------------------------- /.gitattributes: -------------------------------------------------------------------------------- 1 | # Auto detect text files and perform LF normalization 2 | * text=auto 3 | -------------------------------------------------------------------------------- /.github/FUNDING.yml: -------------------------------------------------------------------------------- 1 | # These are supported funding model platforms 2 | 3 | github: jfversluis 4 | -------------------------------------------------------------------------------- /.github/workflows/ci-sample.yml: -------------------------------------------------------------------------------- 1 | name: Build Sample App for CI 2 | 3 | on: 4 | push: 5 | branches: [ "main" ] 6 | paths-ignore: 7 | - "**.md" 8 | pull_request: 9 | branches: [ "main" ] 10 | 11 | jobs: 12 | build-sample-ci: 13 | 14 | runs-on: windows-latest 15 | 16 | steps: 17 | - uses: actions/checkout@v3 18 | - name: Build 19 | run: dotnet build samples\Plugin.Maui.FormsMigration.Sample.sln -c Release 20 | -------------------------------------------------------------------------------- /.github/workflows/ci.yml: -------------------------------------------------------------------------------- 1 | name: Build for CI 2 | 3 | on: 4 | push: 5 | branches: [ "main" ] 6 | paths-ignore: 7 | - "**.md" 8 | pull_request: 9 | branches: [ "main" ] 10 | 11 | jobs: 12 | build-plugin-ci: 13 | 14 | runs-on: windows-latest 15 | 16 | steps: 17 | - uses: actions/checkout@v3 18 | - name: Build 19 | run: dotnet build src\Plugin.Maui.FormsMigration.sln -c Release 20 | -------------------------------------------------------------------------------- /.github/workflows/release-nuget.yml: -------------------------------------------------------------------------------- 1 | name: Create a (Pre)release on NuGet 2 | 3 | on: 4 | push: 5 | tags: 6 | - "v[0-9]+.[0-9]+.[0-9]+" 7 | - "v[0-9]+.[0-9]+.[0-9]+-preview[0-9]+" 8 | jobs: 9 | release-nuget: 10 | 11 | runs-on: windows-latest 12 | 13 | steps: 14 | - uses: actions/checkout@v3 15 | - name: Verify commit exists in origin/main 16 | run: | 17 | git fetch --no-tags --prune --depth=1 origin +refs/heads/*:refs/remotes/origin/* 18 | git branch --remote --contains | grep origin/main 19 | - name: Get version information from tag 20 | id: get_version 21 | uses: battila7/get-version-action@v2 22 | - name: Pack 23 | run: dotnet pack src\Plugin.Maui.FormsMigration.sln -c Release -p:PackageVersion=${{ steps.get_version.outputs.version-without-v }} 24 | - name: Push 25 | run: dotnet nuget push src\Plugin.Maui.FormsMigration\bin\Release\Plugin.Maui.FormsMigration.${{ steps.get_version.outputs.version-without-v }}.nupkg -s https://api.nuget.org/v3/index.json -k ${{ secrets.NUGET_API_KEY }} 26 | env: 27 | GITHUB_TOKEN: ${{ secrets.NUGET_API_KEY }} 28 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | ## Ignore Visual Studio temporary files, build results, and 2 | ## files generated by popular Visual Studio add-ons. 3 | ## 4 | ## Get latest from https://github.com/github/gitignore/blob/main/VisualStudio.gitignore 5 | 6 | # User-specific files 7 | *.rsuser 8 | *.suo 9 | *.user 10 | *.userosscache 11 | *.sln.docstates 12 | 13 | # User-specific files (MonoDevelop/Xamarin Studio) 14 | *.userprefs 15 | 16 | # Mono auto generated files 17 | mono_crash.* 18 | 19 | # Build results 20 | [Dd]ebug/ 21 | [Dd]ebugPublic/ 22 | [Rr]elease/ 23 | [Rr]eleases/ 24 | x64/ 25 | x86/ 26 | [Ww][Ii][Nn]32/ 27 | [Aa][Rr][Mm]/ 28 | [Aa][Rr][Mm]64/ 29 | bld/ 30 | [Bb]in/ 31 | [Oo]bj/ 32 | [Ll]og/ 33 | [Ll]ogs/ 34 | 35 | # Visual Studio 2015/2017 cache/options directory 36 | .vs/ 37 | # Uncomment if you have tasks that create the project's static files in wwwroot 38 | #wwwroot/ 39 | 40 | # Visual Studio 2017 auto generated files 41 | Generated\ Files/ 42 | 43 | # MSTest test Results 44 | [Tt]est[Rr]esult*/ 45 | [Bb]uild[Ll]og.* 46 | 47 | # NUnit 48 | *.VisualState.xml 49 | TestResult.xml 50 | nunit-*.xml 51 | 52 | # Build Results of an ATL Project 53 | [Dd]ebugPS/ 54 | [Rr]eleasePS/ 55 | dlldata.c 56 | 57 | # Benchmark Results 58 | BenchmarkDotNet.Artifacts/ 59 | 60 | # .NET Core 61 | project.lock.json 62 | project.fragment.lock.json 63 | artifacts/ 64 | 65 | # ASP.NET Scaffolding 66 | ScaffoldingReadMe.txt 67 | 68 | # StyleCop 69 | StyleCopReport.xml 70 | 71 | # Files built by Visual Studio 72 | *_i.c 73 | *_p.c 74 | *_h.h 75 | *.ilk 76 | *.meta 77 | *.obj 78 | *.iobj 79 | *.pch 80 | *.pdb 81 | *.ipdb 82 | *.pgc 83 | *.pgd 84 | *.rsp 85 | *.sbr 86 | *.tlb 87 | *.tli 88 | *.tlh 89 | *.tmp 90 | *.tmp_proj 91 | *_wpftmp.csproj 92 | *.log 93 | *.tlog 94 | *.vspscc 95 | *.vssscc 96 | .builds 97 | *.pidb 98 | *.svclog 99 | *.scc 100 | 101 | # Chutzpah Test files 102 | _Chutzpah* 103 | 104 | # Visual C++ cache files 105 | ipch/ 106 | *.aps 107 | *.ncb 108 | *.opendb 109 | *.opensdf 110 | *.sdf 111 | *.cachefile 112 | *.VC.db 113 | *.VC.VC.opendb 114 | 115 | # Visual Studio profiler 116 | *.psess 117 | *.vsp 118 | *.vspx 119 | *.sap 120 | 121 | # Visual Studio Trace Files 122 | *.e2e 123 | 124 | # TFS 2012 Local Workspace 125 | $tf/ 126 | 127 | # Guidance Automation Toolkit 128 | *.gpState 129 | 130 | # ReSharper is a .NET coding add-in 131 | _ReSharper*/ 132 | *.[Rr]e[Ss]harper 133 | *.DotSettings.user 134 | 135 | # TeamCity is a build add-in 136 | _TeamCity* 137 | 138 | # DotCover is a Code Coverage Tool 139 | *.dotCover 140 | 141 | # AxoCover is a Code Coverage Tool 142 | .axoCover/* 143 | !.axoCover/settings.json 144 | 145 | # Coverlet is a free, cross platform Code Coverage Tool 146 | coverage*.json 147 | coverage*.xml 148 | coverage*.info 149 | 150 | # Visual Studio code coverage results 151 | *.coverage 152 | *.coveragexml 153 | 154 | # NCrunch 155 | _NCrunch_* 156 | .*crunch*.local.xml 157 | nCrunchTemp_* 158 | 159 | # MightyMoose 160 | *.mm.* 161 | AutoTest.Net/ 162 | 163 | # Web workbench (sass) 164 | .sass-cache/ 165 | 166 | # Installshield output folder 167 | [Ee]xpress/ 168 | 169 | # DocProject is a documentation generator add-in 170 | DocProject/buildhelp/ 171 | DocProject/Help/*.HxT 172 | DocProject/Help/*.HxC 173 | DocProject/Help/*.hhc 174 | DocProject/Help/*.hhk 175 | DocProject/Help/*.hhp 176 | DocProject/Help/Html2 177 | DocProject/Help/html 178 | 179 | # Click-Once directory 180 | publish/ 181 | 182 | # Publish Web Output 183 | *.[Pp]ublish.xml 184 | *.azurePubxml 185 | # Note: Comment the next line if you want to checkin your web deploy settings, 186 | # but database connection strings (with potential passwords) will be unencrypted 187 | *.pubxml 188 | *.publishproj 189 | 190 | # Microsoft Azure Web App publish settings. Comment the next line if you want to 191 | # checkin your Azure Web App publish settings, but sensitive information contained 192 | # in these scripts will be unencrypted 193 | PublishScripts/ 194 | 195 | # NuGet Packages 196 | *.nupkg 197 | # NuGet Symbol Packages 198 | *.snupkg 199 | # The packages folder can be ignored because of Package Restore 200 | **/[Pp]ackages/* 201 | # except build/, which is used as an MSBuild target. 202 | !**/[Pp]ackages/build/ 203 | # Uncomment if necessary however generally it will be regenerated when needed 204 | #!**/[Pp]ackages/repositories.config 205 | # NuGet v3's project.json files produces more ignorable files 206 | *.nuget.props 207 | *.nuget.targets 208 | 209 | # Microsoft Azure Build Output 210 | csx/ 211 | *.build.csdef 212 | 213 | # Microsoft Azure Emulator 214 | ecf/ 215 | rcf/ 216 | 217 | # Windows Store app package directories and files 218 | AppPackages/ 219 | BundleArtifacts/ 220 | Package.StoreAssociation.xml 221 | _pkginfo.txt 222 | *.appx 223 | *.appxbundle 224 | *.appxupload 225 | 226 | # Visual Studio cache files 227 | # files ending in .cache can be ignored 228 | *.[Cc]ache 229 | # but keep track of directories ending in .cache 230 | !?*.[Cc]ache/ 231 | 232 | # Others 233 | ClientBin/ 234 | ~$* 235 | *~ 236 | *.dbmdl 237 | *.dbproj.schemaview 238 | *.jfm 239 | *.pfx 240 | *.publishsettings 241 | orleans.codegen.cs 242 | 243 | # Including strong name files can present a security risk 244 | # (https://github.com/github/gitignore/pull/2483#issue-259490424) 245 | #*.snk 246 | 247 | # Since there are multiple workflows, uncomment next line to ignore bower_components 248 | # (https://github.com/github/gitignore/pull/1529#issuecomment-104372622) 249 | #bower_components/ 250 | 251 | # RIA/Silverlight projects 252 | Generated_Code/ 253 | 254 | # Backup & report files from converting an old project file 255 | # to a newer Visual Studio version. Backup files are not needed, 256 | # because we have git ;-) 257 | _UpgradeReport_Files/ 258 | Backup*/ 259 | UpgradeLog*.XML 260 | UpgradeLog*.htm 261 | ServiceFabricBackup/ 262 | *.rptproj.bak 263 | 264 | # SQL Server files 265 | *.mdf 266 | *.ldf 267 | *.ndf 268 | 269 | # Business Intelligence projects 270 | *.rdl.data 271 | *.bim.layout 272 | *.bim_*.settings 273 | *.rptproj.rsuser 274 | *- [Bb]ackup.rdl 275 | *- [Bb]ackup ([0-9]).rdl 276 | *- [Bb]ackup ([0-9][0-9]).rdl 277 | 278 | # Microsoft Fakes 279 | FakesAssemblies/ 280 | 281 | # GhostDoc plugin setting file 282 | *.GhostDoc.xml 283 | 284 | # Node.js Tools for Visual Studio 285 | .ntvs_analysis.dat 286 | node_modules/ 287 | 288 | # Visual Studio 6 build log 289 | *.plg 290 | 291 | # Visual Studio 6 workspace options file 292 | *.opt 293 | 294 | # Visual Studio 6 auto-generated workspace file (contains which files were open etc.) 295 | *.vbw 296 | 297 | # Visual Studio 6 auto-generated project file (contains which files were open etc.) 298 | *.vbp 299 | 300 | # Visual Studio 6 workspace and project file (working project files containing files to include in project) 301 | *.dsw 302 | *.dsp 303 | 304 | # Visual Studio 6 technical files 305 | *.ncb 306 | *.aps 307 | 308 | # Visual Studio LightSwitch build output 309 | **/*.HTMLClient/GeneratedArtifacts 310 | **/*.DesktopClient/GeneratedArtifacts 311 | **/*.DesktopClient/ModelManifest.xml 312 | **/*.Server/GeneratedArtifacts 313 | **/*.Server/ModelManifest.xml 314 | _Pvt_Extensions 315 | 316 | # Paket dependency manager 317 | .paket/paket.exe 318 | paket-files/ 319 | 320 | # FAKE - F# Make 321 | .fake/ 322 | 323 | # CodeRush personal settings 324 | .cr/personal 325 | 326 | # Python Tools for Visual Studio (PTVS) 327 | __pycache__/ 328 | *.pyc 329 | 330 | # Cake - Uncomment if you are using it 331 | # tools/** 332 | # !tools/packages.config 333 | 334 | # Tabs Studio 335 | *.tss 336 | 337 | # Telerik's JustMock configuration file 338 | *.jmconfig 339 | 340 | # BizTalk build output 341 | *.btp.cs 342 | *.btm.cs 343 | *.odx.cs 344 | *.xsd.cs 345 | 346 | # OpenCover UI analysis results 347 | OpenCover/ 348 | 349 | # Azure Stream Analytics local run output 350 | ASALocalRun/ 351 | 352 | # MSBuild Binary and Structured Log 353 | *.binlog 354 | 355 | # NVidia Nsight GPU debugger configuration file 356 | *.nvuser 357 | 358 | # MFractors (Xamarin productivity tool) working folder 359 | .mfractor/ 360 | 361 | # Local History for Visual Studio 362 | .localhistory/ 363 | 364 | # Visual Studio History (VSHistory) files 365 | .vshistory/ 366 | 367 | # BeatPulse healthcheck temp database 368 | healthchecksdb 369 | 370 | # Backup folder for Package Reference Convert tool in Visual Studio 2017 371 | MigrationBackup/ 372 | 373 | # Ionide (cross platform F# VS Code tools) working folder 374 | .ionide/ 375 | 376 | # Fody - auto-generated XML schema 377 | FodyWeavers.xsd 378 | 379 | # VS Code files for those working on multiple tools 380 | .vscode/* 381 | !.vscode/settings.json 382 | !.vscode/tasks.json 383 | !.vscode/launch.json 384 | !.vscode/extensions.json 385 | *.code-workspace 386 | 387 | # Local History for Visual Studio Code 388 | .history/ 389 | 390 | # Windows Installer files from build outputs 391 | *.cab 392 | *.msi 393 | *.msix 394 | *.msm 395 | *.msp 396 | 397 | # JetBrains Rider 398 | *.sln.iml 399 | .DS_Store 400 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2023 Gerald Versluis 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ![](nuget.png) 2 | # Plugin.Maui.FormsMigration 3 | 4 | `Plugin.Maui.FormsMigration` provides helpers to make your transition from Xamarin.Forms to .NET MAUI easier. 5 | 6 | ## Install Plugin 7 | 8 | [![NuGet](https://img.shields.io/nuget/v/Plugin.Maui.FormsMigration.svg?label=NuGet)](https://www.nuget.org/packages/Plugin.Maui.FormsMigration/) 9 | 10 | Available on [NuGet](http://www.nuget.org/packages/Plugin.Maui.FormsMigration). 11 | 12 | Install with the dotnet CLI: `dotnet add package Plugin.Maui.FormsMigration`, or through the NuGet Package Manager in Visual Studio. 13 | 14 | ### Supported Platforms 15 | 16 | The supported platforms for this library are Android, iOS and Windows. 17 | 18 | ## API Usage 19 | 20 | This library consists of three APIs that you can use for different scenarios: 21 | 22 | * [App Properties](#app-properties) 23 | * [SecureStorage](#securestorage) 24 | * [VersionTracking](#versiontracking) 25 | 26 | Each of these APIs will have their own way of using it. You can find the specifics below, or have a look at the [sample application](/samples/Plugin.Maui.FormsMigration.Sample/) that is included in this repository. 27 | 28 | > [!NOTE] 29 | > These APIs are meant for transition scenarios only. Use these APIs to retrieve data that is previously stored by your legacy Xamarin application and save them in a place where .NET MAUI can access that data from that point on. This is also the reason that these APIs are read-only. 30 | 31 | ### App Properties 32 | 33 | With Xamarin and Xamarin.Forms you had the possibility to save simple types through the `Properties` API like so: `Application.Current.Properties ["id"] = someClass.ID;`. In .NET MAUI, this is no longer possible. 34 | 35 | To help you transition from Xamarin to .NET MAUI, this library offers the `LegacyApplication` API to still be able to access previously saved properties. From there, save them through a newer API that is available in .NET MAUI. An example could be to use the [Preferences API](https://learn.microsoft.com/dotnet/maui/platform-integration/storage/preferences). See a simple example below. 36 | 37 | ```csharp 38 | int id; 39 | if (LegacyApplication.Current.Properties.ContainsKey("id")) 40 | { 41 | id = (int)LegacyApplication.Current.Properties["id"]; 42 | Preferences.Set("id", id); 43 | } 44 | ``` 45 | 46 | > [!NOTE] 47 | > For this API to work properly, you will have to make sure that the application identifier (or bundle identifier) is the same between your legacy Xamarin app and .NET MAUI app. This is needed so that the app gets installed in the same container on the operating system, which is needed to be able to read the property values that were stored previously. 48 | 49 | Also see this [Microsoft Learn Docs page](https://learn.microsoft.com/dotnet/maui/migration/app-properties) for more information. 50 | 51 | ### SecureStorage 52 | 53 | The [SecureStorage API](https://learn.microsoft.com/dotnet/maui/platform-integration/storage/secure-storage) is still available in .NET MAUI the same as it is in Xamarin and Xamarin.Forms. However, the name of the store where values were stored and some other details have changed which causes the .NET MAUI version of your app to not being able to retrieve the previously saved secure storage information. 54 | 55 | With the `LegacySecureStorage` you can retrieve the previously saved information in the secure storage of your legacy Xamarin application. From there you should resave them through the .NET MAUI secure storage API. An example of how to use this API can be found below. 56 | 57 | ```csharp 58 | // The code below assumes that there is a secure value saved with the key "oauth_token". Replace this key 59 | // with any value(s) you have stored in your legacy Xamarin app to get them out. 60 | 61 | string oauthToken = await LegacySecureStorage.GetAsync("oauth_token"); 62 | bool result = LegacySecureStorage.Remove("oauth_token"); 63 | await SecureStorage.SetAsync("oauth_token", oauthToken); 64 | ``` 65 | 66 | > [!NOTE] 67 | > For this API to work properly, you will have to make sure that the application identifier (or bundle identifier) is the same between your legacy Xamarin app and .NET MAUI app. This is needed so that the app gets installed in the same container on the operating system, which is needed to be able to read the secure store values that were stored previously. 68 | 69 | > [!WARNING] 70 | > For iOS, make sure you have a `Entitlements.plist` with the following entry: 71 | > 72 | > `keychain-access-groups` 73 | > 74 | > `$(AppIdentifierPrefix)$(CFBundleIdentifier)` 75 | > 76 | > `$(AppIdentifierPrefix)$(CFBundleIdentifier)` can stay in place and will be replaced at build time or you can replace it with a hardcoded value. 77 | > Additionally make sure that the `Entitlements.plist` file is set in the Custom Entitlements field for Bundle Signing. For more information, refer to the [Microsoft Learn Docs page about entitlements](https://learn.microsoft.com/dotnet/maui/ios/entitlements). 78 | 79 | Also see this [Microsoft Learn Docs page](https://learn.microsoft.com/dotnet/maui/migration/secure-storage) for more information. 80 | 81 | ### VersionTracking 82 | 83 | The [VersionTracking API](https://learn.microsoft.com/dotnet/maui/platform-integration/appmodel/version-tracking) is still available in .NET MAUI the same as it is in Xamarin and Xamarin.Forms. However, the name of the store where values were stored and some other details have changed which causes the .NET MAUI version of your app to not being able to retrieve the previously saved version tracking information. 84 | 85 | > [!NOTE] 86 | > For this API to work properly, you will have to make sure that the application identifier (or bundle identifier) is the same between your legacy Xamarin app and .NET MAUI app. This is needed so that the app gets installed in the same container on the operating system, which is needed to be able to read the version information that was stored previously. 87 | 88 | > [!WARNING] 89 | > Make sure that the app version of your .NET MAUI app is **higher** than your legacy Xamarin application. Failing to do so might have unexpected results. 90 | 91 | Also see this [Microsoft Learn Docs page](https://learn.microsoft.com/dotnet/maui/migration/version-tracking) for more information. 92 | 93 | # Acknowledgements 94 | 95 | This project could not have came to be without these projects and people, thank you! <3 96 | 97 | The code in the plugin is mostly based on the original code in [Xamarin.Forms](https://github.com/xamarin/Xamarin.Forms) and [Xamarin.Essentials](https://github.com/xamarin/Essentials/). It has been adapted for the Microsoft Learn Docs by [David Britch](https://github.com/davidbritch). 98 | -------------------------------------------------------------------------------- /nuget.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/jfversluis/Plugin.Maui.FormsMigration/b6918d8c909a178f382d5cf9437d4087c112d030/nuget.png -------------------------------------------------------------------------------- /samples/Plugin.Maui.FormsMigration.Sample.sln: -------------------------------------------------------------------------------- 1 | Microsoft Visual Studio Solution File, Format Version 12.00 2 | # Visual Studio Version 17 3 | VisualStudioVersion = 17.0.31611.283 4 | MinimumVisualStudioVersion = 10.0.40219.1 5 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Plugin.Maui.FormsMigration.Sample", "Plugin.Maui.FormsMigration.Sample\Plugin.Maui.FormsMigration.Sample.csproj", "{490BB138-9606-4FFF-8AAD-841C5B1ED059}" 6 | EndProject 7 | Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Plugin.Maui.FormsMigration", "..\src\Plugin.Maui.FormsMigration\Plugin.Maui.FormsMigration.csproj", "{B60F3174-E978-4F2B-B117-F6F0327594C8}" 8 | 9 | EndProject 10 | Global 11 | GlobalSection(SolutionConfigurationPlatforms) = preSolution 12 | Debug|Any CPU = Debug|Any CPU 13 | Release|Any CPU = Release|Any CPU 14 | EndGlobalSection 15 | GlobalSection(ProjectConfigurationPlatforms) = postSolution 16 | {490BB138-9606-4FFF-8AAD-841C5B1ED059}.Debug|Any CPU.ActiveCfg = Debug|Any CPU 17 | {490BB138-9606-4FFF-8AAD-841C5B1ED059}.Debug|Any CPU.Build.0 = Debug|Any CPU 18 | {490BB138-9606-4FFF-8AAD-841C5B1ED059}.Debug|Any CPU.Deploy.0 = Debug|Any CPU 19 | {490BB138-9606-4FFF-8AAD-841C5B1ED059}.Release|Any CPU.ActiveCfg = Release|Any CPU 20 | {490BB138-9606-4FFF-8AAD-841C5B1ED059}.Release|Any CPU.Build.0 = Release|Any CPU 21 | {490BB138-9606-4FFF-8AAD-841C5B1ED059}.Release|Any CPU.Deploy.0 = Release|Any CPU 22 | {B60F3174-E978-4F2B-B117-F6F0327594C8}.Debug|Any CPU.ActiveCfg = Debug|Any CPU 23 | {B60F3174-E978-4F2B-B117-F6F0327594C8}.Debug|Any CPU.Build.0 = Debug|Any CPU 24 | {B60F3174-E978-4F2B-B117-F6F0327594C8}.Release|Any CPU.ActiveCfg = Release|Any CPU 25 | {B60F3174-E978-4F2B-B117-F6F0327594C8}.Release|Any CPU.Build.0 = Release|Any CPU 26 | EndGlobalSection 27 | GlobalSection(SolutionProperties) = preSolution 28 | HideSolutionNode = FALSE 29 | EndGlobalSection 30 | GlobalSection(ExtensibilityGlobals) = postSolution 31 | SolutionGuid = {61F7FB11-1E47-470C-91E2-47F8143E1572} 32 | EndGlobalSection 33 | EndGlobal 34 | -------------------------------------------------------------------------------- /samples/Plugin.Maui.FormsMigration.Sample/App.xaml: -------------------------------------------------------------------------------- 1 |  2 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | -------------------------------------------------------------------------------- /samples/Plugin.Maui.FormsMigration.Sample/App.xaml.cs: -------------------------------------------------------------------------------- 1 | namespace Plugin.Maui.FormsMigration.Sample; 2 | 3 | public partial class App : Application 4 | { 5 | public App() 6 | { 7 | InitializeComponent(); 8 | 9 | MainPage = new AppShell(); 10 | } 11 | } -------------------------------------------------------------------------------- /samples/Plugin.Maui.FormsMigration.Sample/AppShell.xaml: -------------------------------------------------------------------------------- 1 |  2 | 8 | 9 | 12 | 13 | 14 | -------------------------------------------------------------------------------- /samples/Plugin.Maui.FormsMigration.Sample/AppShell.xaml.cs: -------------------------------------------------------------------------------- 1 | namespace Plugin.Maui.FormsMigration.Sample; 2 | 3 | public partial class AppShell : Shell 4 | { 5 | public AppShell() 6 | { 7 | InitializeComponent(); 8 | } 9 | } -------------------------------------------------------------------------------- /samples/Plugin.Maui.FormsMigration.Sample/MainPage.xaml: -------------------------------------------------------------------------------- 1 |  2 | 6 | 7 | 8 |