Converti SB3 in APK

Un progetto Scratch necessita del packaging Android quando deve essere installato da un launcher Android, essere eseguito senza aprire Scratch o essere distribuito come file app. Il risultato è un’applicazione Android contenente il progetto e un runtime compatibile con Scratch, non un sostituto modificabile del progetto originale.

Contenuto dei file SB3 e APK

.sb3 è il formato di progetto utilizzato da Scratch e da editor compatibili come TurboWarp. È un archivio basato su ZIP contenente project.json, script, costumi degli sprite, suoni e altre risorse; gli utenti di Scratch, gli educatori e gli studenti lo usano per salvare e modificare i progetti.

.apk è un package applicativo Android contenente un manifest Android, codice dell’app, risorse e una firma digitale. Un APK può essere installato direttamente per i test o la distribuzione privata, può apparire nel launcher delle app Android e può includere risorse del progetto per l’uso offline. Google Play normalmente richiede un Android App Bundle (.aab) per le nuove applicazioni, non un APK.

Android non può eseguire autonomamente un file .sb3. Il packaging deve fornire un runtime Scratch basato sul web e inserirlo in un’applicazione Android.

Creare il package del progetto con TurboWarp e Android Studio

TurboWarp Packager è lo strumento online appropriato per trasformare un progetto compatibile con Scratch in un’applicazione HTML standalone. Non è un convertitore di file generico: esegue il packaging del progetto insieme al runtime necessario per eseguirlo. Phosphorus è obsoleto per i moderni progetti Scratch 3 e i servizi website-wrapper come AppsGeyser non eseguono in modo affidabile il packaging del runtime del progetto, delle risorse, delle autorizzazioni o della configurazione di signing.

1. In Scratch, usa File → Save to your computer per conservare il file .sb3 originale.
2. Apri TurboWarp Packager, scegli Load from your computer e seleziona il file .sb3. Testa l’anteprima, inclusi suoni, controlli, sprite ed estensioni.
3. Seleziona l’output HTML/web e scarica il package HTML self-contained. Se il download si chiama project.html, crea una cartella denominata www e rinomina il file in www/index.html.
4. Installa Node.js e Android Studio. In un terminale, crea un progetto Capacitor e aggiungi il supporto Android:

mkdir scratch-android && cd scratch-android
npm init -y
npm install @capacitor/core @capacitor/cli @capacitor/android
npx cap init "My Scratch App" "com.example.myscratchapp" --web-dir=www
npx cap add android
npx cap sync android
npx cap open android

Copia la cartella www preparata nella directory del progetto prima di eseguire npx cap sync android. Usa un application ID lowercase in formato reverse-domain, come com.example.myscratchapp; deve essere univoco al momento della pubblicazione.

5. In Android Studio, imposta il version code, il version name, l’icona dell’app e le eventuali autorizzazioni necessarie. Usa Build → Generate Signed Bundle / APK; seleziona APK per l’installazione diretta oppure Android App Bundle per Google Play, quindi crea o seleziona un release keystore.
6. Installa l’APK firmato su un dispositivo Android fisico per i test. Android potrebbe richiedere che al file manager, al browser o all’app di condivisione che riceve il file sia consentito installare app sconosciute.

Limiti di compatibilità e distribuzione

Esegui i test sulle versioni Android e sulle dimensioni dello schermo che riceveranno l’app. I controlli touch, l’orientamento dello schermo, il comportamento dell’autoplay audio, le prestazioni e le ipotesi relative alla tastiera hardware possono differire dal browser desktop.

Funzionalità di sensing di Scratch come fotocamera, microfono, geolocalizzazione, clipboard, selezione dei file e simili possono richiedere autorizzazioni nel manifest Android e approvazione runtime. Alcune API del browser ed estensioni personalizzate richiedono modifiche native Android o non funzioneranno all’interno di una WebView.

Le variabili cloud di Scratch e le funzionalità dell’account Scratch non sono affidabili in un’app sottoposta a packaging perché dipendono dal web service di Scratch e dal comportamento della sessione. Usa un backend separato o un servizio di variabili cloud compatibile se l’app richiede dati online condivisi.

Conserva il file .sb3 originale per future modifiche e per l’archiviazione. Un APK o un AAB è un package di deployment; la sua estrazione non fornisce un progetto pratico per la modifica in Scratch.