Convertir SB3 en APK

Un projet Scratch nécessite un packaging Android lorsqu’il doit être installé depuis un lanceur Android, s’exécuter sans ouvrir Scratch ou être distribué sous forme de fichier d’application. Le résultat est une application Android contenant le projet et un runtime compatible avec Scratch, et non un remplacement modifiable du projet original.

Contenu des fichiers SB3 et APK

.sb3 est le format de projet utilisé par Scratch et par des éditeurs compatibles tels que TurboWarp. Il s’agit d’une archive basée sur ZIP contenant project.json, les scripts, les costumes des sprites, les sons et d’autres ressources ; les utilisateurs de Scratch, les enseignants et les élèves l’utilisent pour enregistrer et modifier leurs projets.

.apk est un package d’application Android contenant un manifeste Android, le code de l’application, des ressources et une signature numérique. Un APK peut être installé directement à des fins de test ou de distribution privée, apparaître dans le lanceur d’applications Android et inclure les ressources du projet pour une utilisation hors ligne. Google Play exige normalement un Android App Bundle (.aab) pour les nouvelles applications, et non un APK.

Android ne peut pas exécuter seul un fichier .sb3. Le packaging doit fournir un runtime Scratch basé sur le web et l’intégrer dans une application Android.

Packager le projet avec TurboWarp et Android Studio

TurboWarp Packager est l’outil en ligne approprié pour transformer un projet compatible avec Scratch en application HTML autonome. Il ne s’agit pas d’un convertisseur de fichiers générique : il package le projet avec le runtime nécessaire à son exécution. Phosphorus est obsolète pour les projets Scratch 3 modernes, et les services d’encapsulation de sites web tels qu’AppsGeyser ne packagent pas de manière fiable le runtime du projet, les ressources, les autorisations ou la configuration de signature.

1. Dans Scratch, utilisez File → Save to your computer pour conserver le fichier .sb3 original.
2. Ouvrez TurboWarp Packager, choisissez Load from your computer, puis sélectionnez le fichier .sb3. Testez l’aperçu, notamment les sons, les commandes, les sprites et les extensions.
3. Sélectionnez la sortie HTML/web et téléchargez le package HTML autonome. Si le téléchargement est nommé project.html, créez un dossier nommé www et renommez le fichier en www/index.html.
4. Installez Node.js et Android Studio. Dans un terminal, créez un projet Capacitor et ajoutez la prise en charge d’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

Copiez le dossier www préparé dans le répertoire du projet avant d’exécuter npx cap sync android. Utilisez un identifiant d’application en notation reverse-domain et en minuscules, tel que com.example.myscratchapp ; il doit être unique lors de la publication.

5. Dans Android Studio, définissez le code de version, le nom de version, l’icône de l’application et les autorisations requises. Utilisez Build → Generate Signed Bundle / APK ; sélectionnez APK pour une installation directe ou Android App Bundle pour Google Play, puis créez ou sélectionnez un keystore de release.
6. Installez l’APK signé sur un appareil Android physique pour effectuer les tests. Android peut exiger que le gestionnaire de fichiers, le navigateur ou l’application de partage qui reçoit le fichier soit autorisé à installer des applications inconnues.

Compatibilité et limites de distribution

Effectuez des tests sur les versions d’Android et les tailles d’écran qui recevront l’application. Les commandes tactiles, l’orientation de l’écran, le comportement de lecture automatique de l’audio, les performances et les hypothèses liées au clavier matériel peuvent différer de celles d’un navigateur de bureau.

L’appareil photo, le microphone, la géolocalisation, le presse-papiers, la sélection de fichiers et les fonctionnalités de détection Scratch similaires peuvent nécessiter des autorisations dans le manifeste Android ainsi qu’une approbation lors de l’exécution. Certaines API de navigateur et extensions personnalisées nécessitent des modifications natives d’Android ou ne fonctionneront pas dans une WebView.

Les variables cloud Scratch et les fonctionnalités de compte Scratch ne sont pas fiables dans une application packagée, car elles dépendent du service web Scratch et du comportement de session. Utilisez un backend distinct ou un service de variables cloud compatible si l’application nécessite des données en ligne partagées.

Conservez le fichier .sb3 original pour les modifications et l’archivage futurs. Un APK ou un AAB est un package de déploiement ; son extraction ne fournit pas un projet Scratch pratique à modifier.