Problemi Xcode 27 con MAUI.net

Problemi Xcode 27 con MAUI.net

Problemi Xcode 27 con MAUI.net

Con Xcode 27 Apple non accetta più app iOS e Mac Catalyst che non adottano il ciclo di vita UIScene. Le app .NET MAUI create con i template precedenti a settembre 2026 si compilano senza errori, ma si chiudono subito dopo la splash screen sui dispositivi con iOS 27. La correzione richiede una classe C# e una chiave in Info.plist, ma tocca anche URL di ritorno, deep link, notifiche e codice di avvio. Questo articolo spiega cosa succede, come verificare se siete coinvolti e come intervenire, con esempi di codice.

Indice dei contenuti – Problemi Xcode 27 con MAUI.net

1. Cosa cambia con Xcode 27

2. Cos’è il UIScene lifecycle

3. Perché le app MAUI sviluppate prima di settembre 2026 vanno in crash

4. Come verificare se la tua app è coinvolta

5. Esempio pratico: la correzione in due file

6. Esempio pratico: migrare il codice personalizzato di AppDelegate

7. Test e controlli prima del rilascio

8. Conclusioni e formazione professionale

1. Cosa cambia con Xcode 27

Iniziamo a parlare deii Problemi Xcode 27 con MAUI.net . Apple ha preparato il passaggio per gradi, e lo racconta la sua documentazione ufficiale (Technote TN3187). Da iOS 18.4 UIKit scrive nel log un avviso per le app che non adottano le scene. Con iOS 26 il messaggio diventa più netto. Nella major release successiva a iOS 26 il ciclo di vita UIScene diventa obbligatorio per chi compila con l’SDK più recente: senza, l’app non parte. Apple precisa che serve solo l’adozione delle scene; supportare più finestre è incoraggiato ma facoltativo.

Per chi gestisce una pipeline il punto cruciale è questo: il vincolo scatta sull’SDK con cui compilate, non sul sistema operativo del telefono. Il team MAUI lo ha verificato durante la validazione dei nuovi template. Un’app generata dal vecchio template e compilata con gli SDK 27 termina dopo la splash screen su iOS 27, mentre lo stesso binario si avvia regolarmente su iOS 26.5. Un test su un dispositivo con iOS 26 può quindi risultare positivo su un’app che andrà in crash per tutti i clienti con iOS 27.

Il calendario lato .NET è serrato. MAUI 10.0.110, con i template aggiornati, è uscita il 22 settembre 2026. La release di .NET for iOS con il supporto a Xcode 27.0 (workload set 10.0.401.1) è arrivata il 29 settembre. Da quel giorno chiunque aggiorni il Mac e ricompili un’app esistente la costruisce con l’SDK iOS 27, anche se nel repository non è cambiato nulla.

2. Cos’è il UIScene lifecycle – Problemi Xcode 27 con MAUI.net

Immaginate un edificio con un solo ufficio. Finché c’è una sola finestra, il portinaio apre il portone, accoglie i visitatori e gestisce anche la scrivania. Con le scene l’edificio ha una gestione generale (il processo dell’app) e ogni ufficio (la scena) ha il suo responsabile. Nel modello classico l’oggetto UIApplicationDelegate è il portinaio che fa tutto. Nel modello a scene si divide il lavoro in due parti, come descrive TN3187: il ciclo di vita dell’applicazione, cioè l’avvio del processo, e il ciclo di vita dell’interfaccia visibile, incarnato dalla scena e dal suo UISceneDelegate.

Apple fornisce una tabella di corrispondenza per spostare la logica esistente dall’application delegate al scene delegate:

UIApplicationDelegateUISceneDelegate
applicationDidBecomeActivesceneDidBecomeActive
applicationWillResignActivesceneWillResignActive
applicationDidEnterBackgroundsceneDidEnterBackground
applicationWillEnterForegroundsceneWillEnterForeground

In MAUI il lavoro pesante esiste già nel framework. MauiUIApplicationDelegate usa l’avvio a scene quando trova il manifest UIApplicationSceneManifest e risponde a UIKit con una configurazione dal nome fisso, __MAUI_DEFAULT_SCENE_CONFIGURATION__. MauiUISceneDelegate crea la finestra MAUI per quella configurazione e inoltra le callback di scena agli eventi cross-platform di Window (Created, Activated, Deactivated e gli altri). Per questo la correzione è piccola: manca solo la dichiarazione. La documentazione Microsoft Learn elenca già gli hook di scena disponibili, per esempio SceneWillConnect, SceneOpenUrl e SceneContinueUserActivity.

3. Perché le app MAUI sviluppate prima di settembre 2026 vanno in crash

Continuiamo a parlare dei Problemi Xcode 27 con MAUI.net. I template MAUI precedenti alla 10.0.110 non generavano né una classe SceneDelegate né la chiave UIApplicationSceneManifest nell’Info.plist delle app iOS e Mac Catalyst. La pull request che ha introdotto la correzione (numero 38601 nel repository dotnet/maui) descrive l’effetto: l’app si compila, poi termina dopo la splash screen con un messaggio di UIKit che dice che “UIScene life cycle is required for apps built with this SDK”. Il controllo avviene a livello nativo, quindi non aspettatevi un’eccezione gestita da intercettare con try/catch.

La regola da ricordare è che conta il template con cui il progetto è stato creato, non il pacchetto MAUI che referenziate oggi. Il team MAUI lo scrive esplicitamente: le modifiche ai template non vengono applicate retroattivamente alle app esistenti, che devono aggiungere manifest e delegate a mano in ogni head Apple. Aggiornare Microsoft.Maui.Controls alla 10.0.110 non tocca il vostro Info.plist e non aggiunge file al progetto.

Il problema riguarda anche Mac Catalyst, perché le app Catalyst sono app UIKit e il requisito è di UIKit. C’è poi una modifica separata ma collegata: l’SDK Mac Catalyst 27 rifiuta un SupportedOSPlatformVersion pari a 15.0 nei progetti app, e i nuovi template usano 17.0 (macOS 14). Chi deve supportare versioni più vecchie di macOS deve restare su un SDK 26.x con il target più basso.

Riassumendo gli scenari, in base a quanto verificato dal team MAUI e a quanto dichiarato da Apple:

ScenarioDispositivoEsito
App senza scene compilata con SDK 26iOS 27Si avvia (il vincolo non scatta)
App senza scene compilata con SDK 27iOS 27Termina dopo la splash screen
App senza scene compilata con SDK 27iOS 26.5Si avvia
App con scene compilata con SDK 27iOS 26 e 27Si avvia

4. Come verificare se la tua app è coinvolta

Apple indica due condizioni che richiedono la migrazione: la chiave UIApplicationSceneManifest manca dall’Info.plist oppure non ha configurazioni, e nell’app delegate non è implementato il metodo che fornisce la configurazione della scena. In un progetto MAUI il controllo si riduce a due ricerche. Eseguitele dalla radice della soluzione:

# 1. Il manifest è presente in tutti gli Info.plist delle piattaforme Apple?

grep -rL "UIApplicationSceneManifest" --include=Info.plist .

# 2. Esiste una classe SceneDelegate per iOS e Mac Catalyst?

find . -name "SceneDelegate.cs" -path "*Platforms*"

Il primo comando elenca i file Info.plist che non contengono la chiave: ogni file in elenco è un problema. Se avete più configurazioni di build (per esempio Dev, Stage e Prod con Info.plist separati), il manifest va aggiunto in tutti. Una dimenticanza produce un’app che si blocca solo in una configurazione, ed è il tipo di errore che si scopre il venerdì pomeriggio.

Controllate poi la toolchain della macchina di build:

dotnet --version        # SDK installato

dotnet workload list    # workload e versioni

xcodebuild -version     # Xcode selezionato

5. Esempio pratico: la correzione in due file – Problemi Xcode 27 con MAUI.net

Scenario: GestioneInterventi, un’app MAUI per tecnici di assistenza creata nel 2025 con il template .NET 10 originale. Compila con Xcode 27 senza warning, ma sui telefoni con iOS 27 si chiude dopo la splash screen. Servono due interventi per ogni head Apple, senza aggiornare alcun pacchetto NuGet, perché MauiUISceneDelegate fa già parte di MAUI.

Passo 1. Aggiungete il file Platforms/iOS/SceneDelegate.cs:

using Foundation;

namespace GestioneInterventi;

// Il nome registrato deve coincidere con UISceneDelegateClassName nell'Info.plist

[Register("SceneDelegate")]

public class SceneDelegate : MauiUISceneDelegate

{

    // Può restare vuota: la classe base crea la finestra MAUI

    // e inoltra gli eventi di scena agli eventi cross-platform di Window.

    // Non aggiungete un inoltro manuale, o riceverete ogni evento due volte.

}

Passo 2. Dichiarate la scena in Platforms/iOS/Info.plist, dentro il dizionario principale:

<key>UIApplicationSceneManifest</key>

<dict>

    <key>UIApplicationSupportsMultipleScenes</key>

    <false/>

    <key>UISceneConfigurations</key>

    <dict>

        <key>UIWindowSceneSessionRoleApplication</key>

        <array>

            <dict>

                <key>UISceneConfigurationName</key>

                <string>__MAUI_DEFAULT_SCENE_CONFIGURATION__</string>

                <key>UISceneDelegateClassName</key>

                <string>SceneDelegate</string>

            </dict>

        </array>

    </dict>

</dict>

Le indicazioni del team MAUI sono precise, e conviene rispettarle alla lettera:

  • __MAUI_DEFAULT_SCENE_CONFIGURATION__ non va rinominato: deve corrispondere alla configurazione del framework.
  • Il valore di UISceneDelegateClassName deve coincidere con il nome nell’attributo [Register], non con il nome C# della classe o con il namespace.
  • Non aggiungete UISceneStoryboardFile e non modificate la configurazione di MauiSplashScreen o UILaunchStoryboardName: MAUI crea la finestra da codice.
  • Lasciate UIApplicationSupportsMultipleScenes a false per mantenere il comportamento a finestra singola. Se in futuro volete più finestre, cambiate questo valore in true. Su Mac Catalyst abilitare più scene attiva anche il raggruppamento automatico delle finestre in schede.

Se l’app ha come target anche Mac Catalyst, ripetete gli stessi due interventi in Platforms/MacCatalyst (SceneDelegate.cs e manifest nell’Info.plist di quella head) e alzate il target minimo nel file di progetto:

<!-- GestioneInterventi.csproj: verificate la condizione già presente nel vostro file -->

<SupportedOSPlatformVersion Condition="$([MSBuild]::GetTargetPlatformIdentifier('$(TargetFramework)')) == 'maccatalyst'">17.0</SupportedOSPlatformVersion>

Infine eliminate le cartelle bin e obj e ricompilate, così da non lasciare in uso un Info.plist elaborato in precedenza.

6. Esempio pratico: migrare il codice personalizzato di AppDelegate

Il template funziona con un SceneDelegate vuoto, ma le app reali di solito personalizzano l’AppDelegate. Con le scene cambia chi riceve cosa: URL, attività utente e shortcut non arrivano più nei vecchi metodi dell’app delegate e nel dizionario delle opzioni di lancio, ma attraverso le callback di scena e le opzioni di connessione della scena. Il README dei template MAUI lo dice chiaramente, e chiarisce che anche i gestori di link propri dell’app devono usare gli hook di scena, anche con una sola finestra.

Caso A: il ritorno da un login nel browser. GestioneInterventi autentica i tecnici in un browser di sistema, e il ritorno avviene tramite uno schema URL personalizzato. Prima della migrazione l’URL arrivava qui:

// AppDelegate.cs - PRIMA

public override bool OpenUrl(UIApplication app, NSUrl url, NSDictionary options)

{

    GestoreLogin.Completa(url);

    return base.OpenUrl(app, url, options);

}

Con il manifest presente questo override non riceve più nulla e il login resta sospeso. La soluzione è registrare gli hook di scena in MauiProgram, distinguendo l’avvio a freddo (app chiusa) dall’avvio a caldo (app già in esecuzione), che seguono due percorsi diversi:

using Microsoft.Maui.LifecycleEvents;

public static MauiApp CreateMauiApp()

{

    var builder = MauiApp.CreateBuilder();

    builder

        .UseMauiApp<App>()

        .ConfigureLifecycleEvents(events =>

        {

#if IOS || MACCATALYST

            events.AddiOS(ios => ios

                // Avvio a freddo: URL e attività nelle opzioni di connessione

                .SceneWillConnect((scene, session, options) =>

                {

                    foreach (var contesto in options.UrlContexts)

                        GestoreLogin.Completa(contesto.Url);

                    foreach (var attivita in options.UserActivities)

                        GestoreLink.Apri(attivita);

                })

                // Avvio a caldo: l'app era già in esecuzione

                .SceneOpenUrl((scene, contesti) =>

                {

                    foreach (var contesto in contesti)

                        GestoreLogin.Completa(contesto.Url);

                })

                // Universal link e Handoff

                .SceneContinueUserActivity((scene, attivita) =>

                    GestoreLink.Apri(attivita)));

#endif

        });

    return builder.Build();

}

Il flusso di autenticazione moderno integrato in MAUI (ASWebAuthenticationSession) riceve il risultato dalla propria sessione e non è coinvolto. Il problema riguarda gli schemi URL e i link gestiti dalla vostra app. Le firme dei delegate vanno verificate con l’IntelliSense nella versione di MAUI che usate, e il codice va testato nel vostro progetto prima del rilascio.

Caso B: codice di avvio che presuppone una finestra. Chi lanciava inizializzazioni asincrone dopo FinishedLaunching dava per scontato che la finestra esistesse già. Con le scene UIKit chiama ancora FinishedLaunching, ma la finestra viene creata dopo, quando la scena si connette. Il punto giusto per il codice che dipende dalla finestra è l’evento Created di Window :

public partial class App : Application

{

    protected override Window CreateWindow(IActivationState? activationState)

    {

        Window window = base.CreateWindow(activationState);

        // La finestra nativa esiste: qui si può avviare il bootstrap che la usa

        window.Created += (s, e) => _ = AvviaApplicazioneAsync();

        return window;

    }

}

Nell’AppDelegate restano le inizializzazioni di processo, per esempio database e gestori globali di eccezioni. Tutto ciò che tocca Window, pagine o navigazione passa dopo la creazione della finestra.

Un ultimo punto riguarda i quick action della Home screen. Con MAUI 10.0.110 l’inoltro è gestito centralmente, ma il team ha introdotto un contratto nuovo: ogni gestore registrato per PerformActionForShortcutItem deve invocare il proprio callback di completamento esattamente una volta, con true se l’azione è gestita e false altrimenti. Questo vale anche per i gestori che si limitano a scrivere nel log. Un gestore che non risponde mai blocca il completamento nativo e non esiste alcun timeout.

7. Test e controlli prima del rilascio – Problemi Xcode 27 con MAUI.net

La sequenza più sicura è adottare le scene prima di cambiare toolchain. Il framework MAUI fornisce già il necessario e Apple impone l’obbligo solo a chi compila con l’SDK 27: potete quindi aggiungere SceneDelegate e manifest mentre costruite ancora con Xcode 26, rilasciare, osservare login e deep link per un ciclo di rilascio e solo dopo passare a Xcode 27. A quel punto l’aggiornamento diventa un non-evento.

Lo stack ufficiale per compilare con l’SDK iOS 27 è quello pubblicato da dotnet/macios il 29 settembre. Xcode 27.0 richiede macOS 26.6 o successivo. Gli SDK per iOS, tvOS, macOS e Mac Catalyst sono nella versione 27.0.10722, installabili con il workload set 10.0.401.1 dopo aver verificato che l’SDK .NET installato sia 10.0.401. Per MAUI è raccomandata la 10.0.110 o successiva. Tutta la release è pubblicata per .NET 10: se la vostra app è ancora su una versione precedente, l’aggiornamento a Xcode 27 comincia da una migrazione a .NET 10.

dotnet --version        # deve mostrare 10.0.401

dotnet workload install ios maccatalyst maui --version 10.0.401.1

dotnet workload --info  # verifica le versioni installate

Prima di dichiarare chiusa la migrazione, verificate questi punti:

  • SceneDelegate e manifest presenti in ogni head iOS e Mac Catalyst, compresi tutti gli Info.plist specifici per configurazione.
  • Mac Catalyst con SupportedOSPlatformVersion 17.0, oppure scelta consapevole di restare su SDK 26.x.
  • Override di OpenUrl e ContinueUserActivity spostati dall’AppDelegate agli hook di scena.
  • Avvio a freddo e avvio a caldo provati separatamente per login, deep link, notifiche e quick action.
  • Test su simulatore o dispositivo con iOS 27, oltre a iOS 26: da solo, un dispositivo iOS 26 non rivela il problema.
  • Pipeline di build con Xcode e workload bloccati su versioni esplicite, in modo che un aggiornamento automatico dell’agente non cambi la toolchain a metà sprint.

Comunicate chiaramente al team il meccanismo: basta che uno sviluppatore aggiorni il Mac e ricompili per produrre binari che si chiudono all’avvio sui telefoni con iOS 27, anche se il codice non è cambiato.

8. Conclusioni e formazione professionale

Questa storia non è una sorpresa tecnologica. Apple ha segnalato la transizione nel log di sistema da iOS 18.4, l’ha ribadita con iOS 26 e l’ha documentata in una technote pubblica. Chi seguiva le note di rilascio poteva adottare le scene con un anno di anticipo, senza fretta e senza crash. Chi no, ha scoperto il problema da un crash report nativo dopo aver aggiornato il Mac.

Il punto è questo: i framework multipiattaforma come .NET MAUI poggiano su SDK di terze parti che cambiano ogni anno, con tempi che non decidete voi. Un template invecchiato, un pacchetto aggiornato senza rileggere le note di migrazione o una pipeline non bloccata sono sufficienti a mettere fuori uso un’app in produzione. Gli strumenti non bastano: serve un team che conosca il ciclo di vita della piattaforma, sappia leggere la documentazione ufficiale e riconosca in anticipo i segnali. Solo la formazione continua degli sviluppatori permette di restare al passo con gli aggiornamenti tecnologici, trasformando questi cambiamenti in interventi pianificati invece che in emergenze.

Per questo consigliamo il Corso MAUI.net per aziende di Innovaformazione. Il corso è erogato in classe virtuale online su richiesta, con calendario da concordare in base alle esigenze del vostro team. La formazione dei dipendenti può essere finanziata con Fondimpresa o con altri fondi interprofessionali.

Contatti

Richiedete informazioni e preventivo: email info@innovaformazione.net, telefono 3471012275.

Per altri articoli tecnici consigliamo di navigare sul nostro blog QUI.

(fonte) (fonte) (fonte)

Ti potrebbe interessare

Articoli correlati