Condividi tramite

Aggiornamento di app esistenti all'API unificata

  • Articolo

Importante

L'API classica di Xamarin, che precedeva l'API unificata, è stata deprecata.

  • L'ultima versione di Xamarin.iOS per supportare l'API classica (monotouch.dll) era Xamarin.iOS 9.10.
  • Xamarin.Mac supporta ancora l'API classica, ma non viene più aggiornata. Poiché è deprecato, gli sviluppatori devono spostare le applicazioni nell'API unificata.

Come aggiornare le app

Esistono tre passaggi per aggiornare le app:

  1. Correggere eventuali avvisi del compilatore nel codice esistente, in particolare quelli relativi alle API deprecate.

  2. Usare lo strumento di migrazione integrato per Visual Studio per Mac per aggiornare i file di progetto e gli spazi dei nomi.

  3. Correggere gli errori rimanenti del compilatore relativi ai nuovi 64 tipi e ad altre API modificate. Per altre informazioni sugli aggiornamenti manuali che potrebbero essere necessari, vedere questi suggerimenti.

Sono disponibili guide specifiche per ogni prodotto che consentono di aggiornare le app all'API unificata e al supporto a 64 bit:

App Xamarin.iOS

Le app Xamarin.iOS esistenti possono essere aggiornate all'API unificata usando lo strumento di migrazione automatizzato integrato per Visual Studio per Mac. Potrebbero quindi essere necessarie alcune correzioni aggiuntive, come illustrato in queste istruzioni e suggerimenti.

App Xamarin.Mac

Le app Xamarin.Mac esistenti possono essere aggiornate all'API unificata usando lo strumento di migrazione automatizzato integrato per Visual Studio per Mac. Potrebbero quindi essere necessarie alcune correzioni aggiuntive, come illustrato in queste istruzioni e suggerimenti.

App Xamarin.Forms

Seguire queste istruzioni per aggiornare una soluzione Xamarin.Forms esistente con un progetto iOS per usare l'API unificata. Il supporto unificato delle API è disponibile solo in Xamarin.Forms 1.3 e versioni successive, quindi le istruzioni spiegano anche come aggiornare l'app Xamarin.Forms alla versione 1.3. Questi suggerimenti possono essere utili per aggiornare qualsiasi codice iOS nativo nei renderer personalizzati o nei servizi di dipendenza.

Utilizzo di tipi nativi nelle app multipiattaforma

Questo articolo illustra l'uso dei nuovi tipi nativi dell'API unificata iOS (nint, nuint, nfloat) in un'applicazione multipiattaforma in cui il codice viene condiviso con dispositivi non iOS, ad esempio Android o Windows Telefono OSes. Fornisce informazioni dettagliate sull'uso dei tipi nativi e offre diverse possibili soluzioni ai casi in cui il nuovo tipo deve essere usato con codice multipiattaforma.

Aggiornare le associazioni all'API unificata

I clienti che hanno creato associazioni alle Objective-C librerie dovranno aggiornare il progetto di associazione in modo da riflettere le modifiche nell'API sottostante (dove alcuni tipi saranno ora a 64 bit). Seguire queste istruzioni per aggiornare un progetto di associazione esistente per supportare l'API unificata.