Migración de proyectos de Xamarin Apple

  • Artículo

Un proyecto de .NET 8 para una aplicación de .NET para iOS es similar al ejemplo siguiente:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0-ios</TargetFramework>
    <OutputType>Exe</OutputType>
    <Nullable>enable</Nullable>
    <ImplicitUsings>true</ImplicitUsings>
    <SupportedOSPlatformVersion>13.0</SupportedOSPlatformVersion>
  </PropertyGroup>
</Project>

Para un proyecto de biblioteca, omite la propiedad $(OutputType) por completo o especifica Library como valor de propiedad.

Cambios en las propiedades de MSBuild

En la tabla siguiente se muestra cómo asignar propiedades en proyectos de Xamarin Apple a proyectos de .NET:

Propiedad Descripción .NET Conversión de proyectos
MtouchExtraArgs Argumentos adicionales para mtouch. Algunos argumentos siguen siendo aplicables, algunos argumentos no. Copiar
MtouchArch Arquitectura(s) de la aplicación N/D Convertir en RuntimeIdentifier. Para obtener más información, consulta Conversión a RuntimeIdentifier.
XamMacArch Arquitectura(s) de la aplicación N/D Convertir en RuntimeIdentifier. Para obtener más información, consulta Conversión a RuntimeIdentifier.
HttpClientHandler El valor predeterminado HttpClientHandler.. UseNativeHttpHandler Convertir en UseNativeHttpHandler. Para obtener más información, consultaConversión a UseNativeHttpHandler.
MtouchHttpClientHandler El valor predeterminado MtouchHttpClientHandler. UseNativeHttpHandler Convertir en UseNativeHttpHandler. Para obtener más información, consultaConversión a UseNativeHttpHandler.
EnableCodeSigning Especifica si la firma de código está habilitada. Copiar
CodeSigningKey Especifica la clave de firma de código. Cambia el nombre a CodesignKey
CodesignKey Especifica la clave de firma de código. Copiar
CodesignProvision Especifica el perfil de aprovisionamiento. Copiar
CodesignEntitlements La ruta de acceso al archivo de derechos. Copiar
CodesignExtraArgs Argumentos de firma de código adicionales. Copiar
PackageSigningKey Especifica la clave de firma de código para firmar el paquete. Copiar
PackagingExtraArgs Especifica los argumentos adicionales para la herramienta de empaquetado. Copiar
ProductDefinition La ruta de acceso al archivo de definición de producto que se va a usar al realizar el empaquetado. Copiar
MtouchEnableSGenConc Cambia el nombre del objeto a EnableSGenConc.
EnableSGenConc Copiar

Conversión a RuntimeIdentifier

En la tabla siguiente se muestra cómo convertir las propiedades MtouchArch y XamMacArch en la propiedad RuntimeIdentifier, o la propiedad RuntimeIdentifiers, al migrar un proyecto de Xamarin.iOS a .NET para iOS:

Valor RuntimeIdentifier RuntimeIdentifiers
ARMv7 ios-arm
ARMv7s ios-arm
ARMv7+ARMv7s ios-arm
ARM64 ios-arm64
ARMv7+ARM64 ios-arm;ios-arm64
ARMv7+ARMv7s+ARM64 ios-arm;ios-arm64
x86_64 iossimulator-x64
i386 iossimulator-x86
x86_64+i386 iossimulator-x86;iossimulator-x64

Importante

Si tienes varios identificadores en tiempo de ejecución, usa la propiedad RuntimeIdentifiers en lugar de la propiedad RuntimeIdentifier.

En la tabla siguiente se muestra cómo convertir las propiedades MtouchArch y XamMacArch en la propiedad RuntimeIdentifier al migrar un proyecto de Xamarin.iOS a .NET para iOS:

Propiedad RuntimeIdentifier
x86_64 osx-x64

En la tabla siguiente se muestra cómo convertir las propiedades MtouchArch y XamMacArch en la propiedad RuntimeIdentifier al migrar un proyecto de Xamarin.tvOS a .NET para tvOS:

Propiedad RuntimeIdentifier
ARM64 tvos-arm64
x86_64 tvossimulator-x64

Para obtener más información sobre la propiedad RuntimeIdentifier, consulta RuntimeIdentifier. Para obtener más información sobre los identificadores en tiempo de ejecución (RID), consulta el Catálogo de identificadores de entorno de ejecución (RID) de .NET.

Conversión a UseNativeHttpHandler

En la tabla siguiente se muestra cómo convertir las propiedades HttpClientHandler y MtouchHttpClientHandler en la propiedad UseNativeHttpHandler al migrar un proyecto de Apple de Xamarin a .NET 8:

Valor UseNativeHttpHandler
HttpClientHandler false
NSUrlSessionHandler no establecer
CFNetworkHandler no establecer

Cambios en otros elementos

En la tabla siguiente se muestra cómo asignar otros elementos en proyectos de Apple de Xamarin a proyectos de .NET:

Elemento Descripción .NET Conversión de proyectos
LinkDescription Archivos XML adicionales al enlazador administrado. Idénticos Copiar

Cambios en Info.plist

Algunos valores se han movido de Info.plist al archivo del proyecto.

MinimumOSVersion y LSMinimumSystemVersion

Las propiedades MinimumOSVersion y LSMinimumSystemVersion se deben convertir en la propiedad SupportedOSPlatformVersion en proyectos de .NET 8. Para obtener más información, consulta Asegurarse de que MinimumOSVersion es coherente con SupportedOSPlatformVersion.

Consulta también