xamarin-ios-migration

What problem does it solve?

Many teams have large Xamarin.iOS, Xamarin.Mac, or Xamarin.tvOS codebases that fail to build or run on modern .NET toolchains due to differences in project format, target frameworks, MSBuild properties, NuGet compatibility, and code signing. This Skill consolidates the migration decisions, property mappings, and platform-specific gotchas into a practical workflow so engineers can upgrade native Apple platform apps with confidence.

Core Features & Use Cases

• Project conversion workflow: Step-by-step guidance to create SDK-style .NET projects, move Info.plist values to the project file, and copy source and resources safely.
• Property and TFM mappings: Tables and recommendations for converting MtouchArch to RuntimeIdentifier(s), renaming properties like CodeSigningKey to CodesignKey, and adjusting HttpClient handlers.
• Dependency and binding migration: Guidance on NuGet compatibility, recompiling packages for netX.0-ios/macos/tvos, and tips for migrating binding libraries and Xamarin.Essentials usage.
• Use Case: A mobile engineering team migrating an enterprise iOS app can follow the checklist to convert the project, update NuGet packages, fix linker rules, and validate code signing on device.

Quick Start

Create a new .NET for iOS or macOS project, copy your source and resources, update MSBuild properties and SupportedOSPlatformVersion, convert NuGet dependencies or recompile packages, and verify code signing on a physical device.