Convertir SB3 a APK

Un proyecto de Scratch necesita empaquetarse para Android cuando debe instalarse desde un lanzador de Android, ejecutarse sin abrir Scratch o distribuirse como un archivo de aplicación. El resultado es una aplicación Android que contiene el proyecto y un runtime compatible con Scratch, no un reemplazo editable del proyecto original.

Qué contienen los archivos SB3 y APK

.sb3 es el formato de proyecto utilizado por Scratch y por editores compatibles como TurboWarp. Es un archivo comprimido basado en ZIP que contiene project.json, scripts, disfraces de sprites, sonidos y otros assets; los usuarios de Scratch, educadores y estudiantes lo utilizan para guardar y editar proyectos.

.apk es un paquete de aplicación Android que contiene un manifest de Android, código de la aplicación, recursos y una firma digital. Un APK puede instalarse directamente para realizar pruebas o distribuirse de forma privada, puede aparecer en el lanzador de aplicaciones de Android e incluir assets del proyecto para su uso sin conexión. Google Play normalmente requiere un Android App Bundle (.aab) para las aplicaciones nuevas, no un APK.

Android no puede ejecutar un archivo .sb3 por sí mismo. El empaquetado debe proporcionar un runtime de Scratch basado en la web y envolverlo en una aplicación Android.

Empaquetar el proyecto con TurboWarp y Android Studio

TurboWarp Packager es la herramienta online adecuada para convertir un proyecto compatible con Scratch en una aplicación HTML independiente. No es un conversor de archivos genérico: empaqueta el proyecto con el runtime necesario para ejecutarlo. Phosphorus está obsoleto para los proyectos modernos de Scratch 3, y los servicios de envoltorio de sitios web, como AppsGeyser, no empaquetan de forma fiable el runtime del proyecto, los assets, los permisos ni la configuración de firma.

1. En Scratch, utiliza File → Save to your computer para conservar el archivo .sb3 original.
2. Abre TurboWarp Packager, selecciona Load from your computer y elige el archivo .sb3. Prueba la vista previa, incluidos los sonidos, controles, sprites y extensiones.
3. Selecciona la salida HTML/web y descarga el paquete HTML autocontenido. Si la descarga se llama project.html, crea una carpeta llamada www y cambia el nombre del archivo a www/index.html.
4. Instala Node.js y Android Studio. En una terminal, crea un proyecto de Capacitor y añade la compatibilidad con 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 carpeta www preparada en el directorio del proyecto antes de ejecutar npx cap sync android. Utiliza un ID de aplicación de dominio inverso en minúsculas, como com.example.myscratchapp; debe ser único al publicar.

5. En Android Studio, establece el código de versión, el nombre de versión, el icono de la aplicación y los permisos necesarios. Utiliza Build → Generate Signed Bundle / APK; selecciona APK para la instalación directa o Android App Bundle para Google Play y, a continuación, crea o selecciona un keystore de release.
6. Instala el APK firmado en un dispositivo Android físico para realizar pruebas. Es posible que Android requiera que se permita al gestor de archivos, navegador o aplicación de uso compartido que recibe el archivo instalar aplicaciones desconocidas.

Compatibilidad y límites de distribución

Realiza pruebas en las versiones de Android y los tamaños de pantalla que recibirán la aplicación. Los controles táctiles, la orientación de la pantalla, el comportamiento de reproducción automática del audio, el rendimiento y las suposiciones sobre el teclado físico pueden diferir de los del navegador de escritorio.

La cámara, el micrófono, la geolocalización, el portapapeles, la selección de archivos y otras funciones de detección de Scratch similares pueden requerir permisos en el manifest de Android y aprobación durante la ejecución. Algunas API del navegador y extensiones personalizadas necesitan cambios nativos en Android o no funcionarán dentro de un WebView.

Las variables en la nube de Scratch y las funciones de cuenta de Scratch no son fiables en una aplicación empaquetada porque dependen del servicio web de Scratch y del comportamiento de la sesión. Utiliza un backend independiente o un servicio compatible de variables en la nube si la aplicación necesita datos online compartidos.

Conserva el archivo .sb3 original para futuras ediciones y archivado. Un APK o AAB es un paquete de implementación; extraerlo no proporciona un proyecto práctico para editar en Scratch.