Partager via

Mise à jour d’applications existantes vers l’API unifiée

  • Article

Important

L’API Xamarin Classic, qui a précédé l’API unifiée, a été dépréciée.

  • La dernière version de Xamarin.iOS pour prendre en charge l’API classique (monotouch.dll) était Xamarin.iOS 9.10.
  • Xamarin.Mac prend toujours en charge l’API classique, mais elle n’est plus mise à jour. Étant donné qu’elle est déconseillée, les développeurs doivent déplacer leurs applications vers l’API unifiée.

Comment mettre à jour vos applications

Il existe trois étapes pour mettre à jour vos applications :

  1. Corrigez les avertissements du compilateur dans votre code existant, en particulier ceux liés aux API dépréciées.

  2. Utilisez l’outil de migration intégré pour Visual Studio pour Mac mettre à jour vos fichiers projet et espaces de noms.

  3. Corrigez les erreurs restantes du compilateur liées aux nouveaux types 64 et autres API qui ont changé. Consultez ces conseils pour plus d’informations sur les mises à jour manuelles qui peuvent être nécessaires.

Des guides spécifiques sont disponibles pour chaque produit pour vous aider à mettre à jour vos applications vers l’API Unifiée et la prise en charge 64 bits :

Applications Xamarin.iOS

Les applications Xamarin.iOS existantes peuvent être mises à jour vers l’API Unifiée à l’aide de l’outil de migration automatisée intégré à Visual Studio pour Mac. Des correctifs supplémentaires peuvent ensuite être nécessaires, comme expliqué dans ces instructions et conseils.

Applications Xamarin.Mac

Les applications Xamarin.Mac existantes peuvent être mises à jour vers l’API unifiée à l’aide de l’outil de migration automatisée intégré à Visual Studio pour Mac. Des correctifs supplémentaires peuvent ensuite être nécessaires, comme expliqué dans ces instructions et conseils.

Applications Xamarin.Forms

Suivez ces instructions pour mettre à jour une solution Xamarin.Forms existante avec un projet iOS afin d’utiliser l’API Unifiée. La prise en charge de l’API unifiée n’est disponible que dans Xamarin.Forms 1.3 et versions ultérieures. Les instructions expliquent également comment mettre à jour votre application Xamarin.Forms vers la version 1.3. Ces conseils peuvent vous aider à mettre à jour tout code iOS natif dans les renderers personnalisés ou les services de dépendance.

Utilisation de types natifs dans des applications multiplateformes

Cet article traite de l’utilisation des nouveaux types natifs d’API unifiée iOS (nint, nuint, nfloat) dans une application multiplateforme où le code est partagé avec des appareils non iOS tels qu’Android ou Windows Phone systèmes d’exploitation. Il fournit des informations sur le moment où les types natifs doivent être utilisés et fournit plusieurs solutions possibles aux cas où le nouveau type doit être utilisé avec du code multiplateforme.

Mettre à jour des liaisons vers l’API unifiée

Les clients qui ont créé des liaisons avec Objective-C des bibliothèques devront mettre à jour le projet de liaison pour refléter les modifications apportées à l’API sous-jacente (où certains types seront désormais 64 bits). Suivez ces instructions pour mettre à jour un projet de liaison existant afin de prendre en charge l’API Unifiée.