Costruire e rilasciare un’app iOS

Questa guida fornisce un passo-passo attraverso il rilascio di un’app Flutter per l’App Store e TestFlight.

Preliminari

Prima di iniziare il processo di rilascio della tua app, assicurati che soddisfi le linee guida di App Review di Apple.

Per pubblicare la tua app sull’App Store, devi prima iscriverti all’Apple Developer Program. Puoi leggere di più sulle varie opzioni di adesione nella guida di Apple “Scegliere un’adesione”.

Registra la tua app su App Store Connect

Gestisci il ciclo di vita della tua app suApp Store Connect (ex iTunes Connect).

Registrare la tua app comporta due passaggi: registrare un ID Bundle unico e creare un record di applicazione su App Store Connect.

Per una panoramica dettagliata di App Store Connect, vedi la guidaApp Store Connect.

Registrare un Bundle ID

Ogni applicazione iOS è associata a un Bundle ID, un identificatore unico registrato con Apple.

1. Apri la pagina App IDs del tuo account sviluppatore.
2. Clicca + per creare un nuovo Bundle ID.
3. Inserisci il nome dell’app, seleziona Explicit App ID e inserisci un ID.
4. Seleziona i servizi che la tua app usa, poi clicca su Continue.
5. Nella pagina successiva, conferma i dettagli e clicca su Register per registrare il tuo Bundle ID.

Creare un record di applicazione su App Store Connect

Registra la tua app su App Store Connect:

1. Apri App Store Connect nel tuo browser.
2. Nella landing page di App Store Connect, clicca su Le mie app.
3. Fai clic su + nell’angolo in alto a sinistra della pagina Le mie app, quindi seleziona Nuova app.
4. Compila i dettagli della tua app nel modulo che appare.

Nella sezione Piattaforme, assicurati che sia selezionato iOS. Poiché Flutter attualmente non supporta tvOS, lascia la casella deselezionata. Clicca su Create.

5. Passa ai dettagli dell’applicazione per la tua app e selezionaApp Information dalla barra laterale.
6. Nella sezione General Information, seleziona il Bundle ID che hai registrato nel passo precedente.

Per una panoramica dettagliata, vedi Add an app to your account.

Review Xcode project settings

Questo passo riguarda la revisione delle impostazioni più importanti nell’area di lavoro Xcode.Per procedure e descrizioni dettagliate, vediPreparare la distribuzione dell’app.

Visita le impostazioni del tuo obiettivo in Xcode:

1. In Xcode, apri Runner.xcworkspace nella cartella ios della tua app.
2. Per visualizzare le impostazioni della tua app, seleziona il progetto Runner nel navigatore Xcodeproject. Poi, nella barra laterale della vista principale, seleziona il Runnertarget.
3. Seleziona la scheda General.

Verifica le impostazioni più importanti.

Nella sezione Identity:

Display NameIl nome visualizzato della tua app.Bundle IdentifierL’App ID che hai registrato su App Store Connect.

Nella sezione Signing & Capabilities:

Automatically manage signingSe Xcode deve gestire automaticamente la firma e il provisioning delle app. Questo è impostatotruedi default, che dovrebbe essere sufficiente per la maggior parte delle app. Per scenari più complessi, vedi la Code Signing Guide.TeamSeleziona il team associato al tuo Apple Developeraccount registrato. Se necessario, selezionare Add Account…, quindi aggiornare questa impostazione.

Nella sezione Build Settings:

iOS Deployment TargetLa versione minima di iOS che la tua app supporta.Flutter supporta iOS 8.0 e successivi. Se la tua app include codice Objective-C o Swift che fa uso di API che non erano disponibili in iOS 8, aggiorna questa impostazione in modo appropriato.

La scheda Generale delle impostazioni del progetto dovrebbe assomigliare alla seguente:

Per una panoramica dettagliata sulla firma delle app, vediCreare, esportare ed eliminare i certificati di firma.

Aggiornare la versione di distribuzione dell’app

Se hai cambiato Deployment Target nel tuo progetto Xcode, apri ios/Flutter/AppframeworkInfo.plist nella tua app Flutter e aggiorna il valore MinimumOSVersion per farlo corrispondere.

Aggiornare il numero di versione dell’app

Il numero di versione predefinito dell’app è 1.0.0.Per aggiornarlo, vai al file pubspec.yaml e aggiorna la seguente linea:

version: 1.0.0+1

Il numero di versione è costituito da tre numeri separati da punti, come 1.0.0 nell’esempio precedente, seguito da un numero di costruzione opzionale come 1 nell’esempio precedente, separato da un +.

Sia la versione che il numero di build possono essere sovrascritti nello sbuild di Flutter specificando --build-name e --build-number, rispettivamente.

In iOS, build-name usa CFBundleShortVersionString mentre build-number usa CFBundleVersion.

Aggiungere un’icona dell’app

Quando viene creata una nuova app Flutter, viene creato un set di icone segnaposto.Questo passo riguarda la sostituzione di queste icone segnaposto con le icone della tua app:

1. Rivedere le linee guida sulle icone delle app iOS.
2. Nel navigatore del progetto Xcode, selezionate Assets.xcassets nella cartellaRunner. Aggiorna le icone segnaposto con le icone della tua app.
3. Verifica che l’icona sia stata sostituita eseguendo la tua app usandoflutter run.

Crea un archivio di build

Questo passo riguarda la creazione di un archivio di build e il caricamento della tua build su App Store Connect.

Durante lo sviluppo, hai costruito, debuggato e testato con build di debug. Quando sei pronto a spedire la tua app all’App Store o a TestFlight, devi preparare una build di rilascio.A questo punto, potresti considerare di offuscare il tuo codice Dart per renderlo più difficile da decodificare. L’offuscamento del vostro codice comporta l’aggiunta di un paio di flag al vostro comando di build.

In Xcode, configurate la versione dell’app e la build:

1. In Xcode, aprite Runner.xcworkspace nella cartella ios della vostra app.
2. Selezionare Runner nel navigatore del progetto Xcode, quindi selezionare l’obiettivo Runner nella barra laterale delle impostazioni.
3. Nella sezione Identity, aggiornare la versione al numero di versione rivolto all’utente che si desidera pubblicare.
4. Nella sezione Identity, aggiorna l’identificatore Build a un numero di build unico usato per tracciare questa build su App Store Connect.Ogni caricamento richiede un numero di build unico.

Finalmente, crea un archivio di build e caricalo su App Store Connect:

1. Esegui flutter build ipa per produrre un archivio di build.

2. Aprire build/ios/archive/MyApp.xcarchive in Xcode.

3. Fare clic sul pulsante Validate App. Se viene segnalato qualche problema, risolvilo e produci un’altra build. Puoi riutilizzare lo stesso ID di build fino a quando non carichi un archivio.

4. Dopo che l’archivio è stato validato con successo, clicca suDistribuisci App. Puoi seguire lo stato della tua build nella schedaAttività della pagina dei dettagli della tua app suApp Store Connect.

Dovresti ricevere un’email entro 30 minuti che ti notifica che la tua build è stata convalidata ed è disponibile per il rilascio su TestFlight. A questo punto puoi scegliere se rilasciare su TestFlight, o andare avanti e rilasciare la tua app su App Store.

Per maggiori dettagli, vedi Caricare un’app su App Store Connect.

Rilascia la tua app su TestFlight

TestFlight permette agli sviluppatori di inviare le loro app a tester interni ed esterni. Questo passo opzionale riguarda il rilascio della tua build su TestFlight.

1. Passa alla scheda TestFlight della pagina dei dettagli dell’applicazione della tua app su App Store Connect.
2. Seleziona Internal Testing nella barra laterale.
3. Seleziona la build da pubblicare ai tester, quindi fai clic su Save.
4. Aggiungi gli indirizzi e-mail di tutti i tester interni. Puoi aggiungere altri utenti interni nella pagina Utenti e ruoli di App Store Connect, disponibile dal menu a discesa nella parte superiore della pagina.

Per maggiori dettagli, vedi Distribuire un’app usando TestFlight.

Rilascia la tua app all’App Store

Quando sei pronto a rilasciare la tua app al mondo, segui questi passi per inviare la tua app per la revisione e il rilascio all’App Store:

1. Seleziona Prezzi e disponibilità dalla barra laterale della pagina dei dettagli dell’applicazione della tua app suApp Store Connect e completa le informazioni richieste.
2. Seleziona lo stato dalla barra laterale. Se questa è la prima release di questa app, il suo stato è1.0 Prepare for Submission. Completa tutti i campi richiesti.
3. Clicca Submit for Review.

Apple ti notifica quando il processo di revisione dell’app è completo.La tua app viene rilasciata secondo le istruzioni che hai specificato nella sezione Version Release.

Per maggiori dettagli, vediDistribuire un’app attraverso l’App Store.

Risoluzione dei problemi

La guida alla distribuzione dell’app fornisce una panoramica dettagliata del processo di rilascio di un’app sull’App Store.