Come esportare un APK da VULK

Aggiornato il 17 luglio 2026 — rinfrescato con l'esportazione AAB, i requisiti di piano attuali e dati verificati della piattaforma.

Come si esporta un APK da VULK?

La risposta completa: apri il tuo progetto Flutter nell'editor di VULK, verifica che giri senza errori nell'anteprima, poi clicca Export APK nella toolbar. VULK risolve le dipendenze del tuo pubspec.yaml, compila il tuo codice Dart ahead-of-time in codice macchina ARM nativo, impacchetta gli asset, assembla e firma l'APK — tipicamente in 30-90 secondi — e ti consegna un .apk installabile su qualsiasi dispositivo Android. L'esportazione AAB (il formato richiesto da Google Play) è disponibile allo stesso modo. Ti servono un progetto Flutter e un piano con esportazione: l'esportazione APK/AAB è inclusa in Builder (19,99 $/mese), Pro, Team, Max e Business.

Questo è il passo che la maggior parte dei builder di app IA non sa fare: generano codice mobile, ma per ottenere un binario devi montare una toolchain locale. Su VULK, Flutter è la piattaforma #2 (5,6% dei progetti con stack rilevabile) e la piattaforma più richiesta nei prompt (dati della piattaforma VULK, luglio 2026) — e il prompt-fino-all'APK-installabile è la ragione.

Cosa ti serve prima di esportare?

Prima di esportare, assicurati che il tuo progetto soddisfi questi requisiti:

• Il progetto deve essere un progetto Flutter. L'esportazione APK compila app Flutter. Se non sei sicuro, controlla l'albero dei file — i progetti Flutter hanno una cartella lib/ con file .dart e un pubspec.yaml.
• L'app deve compilare nell'anteprima. Se l'anteprima mostra errori, anche la build dell'APK fallirà. Correggi prima qualsiasi problema di compilazione chiedendo a VULK di risolverlo in chat.
• Ti serve un piano con esportazione. L'esportazione APK/AAB è disponibile sui piani Builder, Pro, Team, Max e Business.

Passo 1: Come verifichi l'app nell'anteprima?

Apri il tuo progetto Flutter nell'editor di VULK. Il pannello destro mostra l'anteprima della tua app — una vera compilazione server-side flutter build web del tuo codice Dart. Naviga in ogni schermata e testa le interazioni principali:

• Tutte le route di navigazione funzionano? Percorri la barra di navigazione inferiore, il menu drawer o la barra dei tab.
• I moduli validano correttamente? Prova a inviare campi vuoti.
• Le liste si renderizzano con i dati attesi?
• Ci sono difetti visivi — errori di overflow, elementi disallineati o immagini mancanti?

Correggi i problemi prima di esportare. È molto più veloce iterare nell'anteprima del browser che ricompilare un APK per ogni correzione. Usa prompt di follow-up come:

La schermata del profilo ha un errore di overflow del testo con nomi utente lunghi. Correggilo aggiungendo l'ellissi di overflow e un vincolo di larghezza massima.

Le icone della barra di navigazione inferiore non si evidenziano quando cambio tab. Assicurati che il selectedIndex si aggiorni correttamente.

Passo 2: cosa succede quando clicchi export APK?

Quando la tua app è stabile nell'anteprima, individua il pulsante Export APK nella toolbar dell'editor. Si trova nella barra delle azioni in alto, accanto al pulsante Deploy. Cliccalo per avviare il processo di build.

Cosa succede dietro le quinte:

1. Risoluzione delle dipendenze. VULK esegue l'equivalente di flutter pub get per installare tutti i pacchetti elencati nel tuo pubspec.yaml.
2. Compilazione Dart. Il tuo codice sorgente Dart viene compilato in codice macchina ARM nativo con il compilatore ahead-of-time (AOT) di Flutter. È diverso dall'anteprima web, che usa un target di compilazione JavaScript.
3. Impacchettamento delle risorse. Gli asset come font, immagini e file JSON referenziati nel tuo pubspec.yaml vengono impacchettati nell'APK.
4. Assemblaggio dell'APK. Il codice compilato, le risorse, il manifest Android e il motore Flutter vengono assemblati in un unico file .apk.
5. Firma. L'APK viene firmato con una chiave che VULK conserva per il tuo account, o con il tuo keystore una volta caricato nelle impostazioni di firma dell'app: così si installa su qualsiasi dispositivo Android senza distribuzione tramite Play Store, e le build successive si installano come aggiornamenti.

La build richiede tipicamente da 30 a 90 secondi a seconda della complessità del progetto e del numero di dipendenze.

Passo 3: Come scarichi l'APK?

Quando la build è completata, appare una finestra di download con il tuo file .apk. Il file prende il nome del tuo progetto — per esempio workout-tracker.apk. Clicca per scaricarlo sul tuo computer.

La dimensione del file dipende dalla complessità della tua app. Un tipico APK Flutter generato da VULK va da 15 MB a 40 MB. Questo include il motore Flutter (~10 MB), il tuo codice Dart compilato ed eventuali asset inclusi.

Passo 4: Come installi l'APK sul tuo dispositivo Android?

Ci sono due modi per portare l'APK sul tuo telefono.

Opzione A: Trasferimento diretto

1. Collega il tuo dispositivo Android al computer via USB.
2. Copia il file .apk nella cartella Download del dispositivo.
3. Sul telefono, apri un file manager e vai in Download.
4. Tocca il file .apk.
5. Android ti chiederà di consentire l'installazione da origini sconosciute (dato che non arriva dal Play Store). Abilitala per il tuo file manager.
6. Tocca Installa.

Opzione B: Auto-invio

1. Carica il file .apk su Google Drive o Dropbox, o invialo a te stesso via email o app di messaggistica.
2. Sul tuo dispositivo Android, apri il file dal servizio cloud o dal messaggio.
3. Segui gli stessi passaggi di installazione dell'Opzione A.

Dopo l'installazione, la tua app appare nel drawer delle app come qualsiasi altra app Android. Ha l'icona predefinita di Flutter, a meno che tu non abbia specificato un'icona launcher personalizzata nel prompt.

Cosa contiene l'APK esportato?

• Il tuo codice Dart compilato in esecuzione nativa su ARM — niente web view, niente bridge JavaScript
• Componenti Material Design compilati in widget nativi
• Asset inclusi — immagini, font, file di dati referenziati nel tuo progetto
• Il motore Flutter — il runtime C++ che alimenta la pipeline di rendering

Per Google Play, esporta invece un AAB (App Bundle), oppure scarica il sorgente e compila in locale una release firmata con flutter build appbundle --release.

Quali sono i problemi comuni e come si risolvono?

La build fallisce con errori di dipendenze

Alcuni pacchetti Flutter richiedono versioni specifiche dell'SDK o hanno dipendenze specifiche di piattaforma in conflitto. VULK blocca le versioni delle dipendenze durante la generazione per mantenere verdi le build server-side, ma se la build fallisce, controlla il messaggio di errore nella finestra di esportazione e chiedi:

La build è fallita per un conflitto di dipendenze. Aggiorna il pacchetto http all'ultima versione e assicurati che tutte le dipendenze siano compatibili.

L'app crasha all'avvio

Di solito significa un errore di runtime nel tuo codice Dart che non è emerso nell'anteprima web. Le cause comuni includono chiamate ai platform channel (tentare di accedere a un'API nativa che funziona diversamente su Android vs web) o errori di riferimento nullo nella gestione dei dati. Controlla attentamente l'anteprima e correggi i problemi prima di riesportare.

L'app appare diversa sul telefono vs l'anteprima

L'anteprima web usa il rendering di Flutter Web, mentre l'APK usa il renderer nativo basato su Skia. Piccole differenze nel rendering del testo, nella qualità delle ombre e nell'antialiasing sono attese. Se il layout è significativamente diverso, è probabilmente un problema di responsività — l'iframe dell'anteprima può avere una larghezza diversa dallo schermo del tuo telefono. Aggiungi controlli responsive:

Fai in modo che il layout della schermata home si adatti a larghezze di schermo diverse. Su schermi più stretti di 360dp, usa un layout a colonna singola invece della griglia a due colonne.

L'APK è troppo grande

Gli APK Flutter includono il motore, che aggiunge circa 10 MB. Se la tua app include asset grandi (immagini ad alta risoluzione, dataset JSON inclusi), la dimensione aumenta. Per ridurla, usa immagini caricate dalla rete invece di asset inclusi, e valuta di scaricare il sorgente per compilare APK per architettura con --split-per-abi (~8 MB per arm64).

Cosa viene dopo l'APK?

L'APK esportato è ideale per test, demo e condivisione con gli stakeholder. Per pubblicare su Google Play:

1. Esporta un AAB da VULK — il formato App Bundle richiesto da Google Play.
2. Carica il tuo keystore di release nelle impostazioni di firma dell'app se ne hai già uno per questa app; altrimenti VULK firma con la chiave che conserva per il tuo account.
3. Personalizza l'icona dell'app con il pacchetto flutter_launcher_icons.
4. Inviala alla Google Play Console per la distribuzione.

Puoi anche scaricare il codice sorgente (esportazione ZIP) in qualsiasi momento e continuare in Android Studio o VS Code.

VULK ti porta dall'idea a un'app Android funzionante in pochi minuti — su tutta la piattaforma, il tempo mediano dalla registrazione alla prima app generata è di 47 secondi (dati della piattaforma VULK, luglio 2026). L'esportazione APK ti permette di tenere quell'app in mano e mostrarla a utenti reali. Il percorso da lì al Play Store è un flusso standard di pubblicazione Flutter — il tuo codice è Dart pulito e standard, pronto per gli strumenti di produzione.