Converter SB3 para APK

Um projeto Scratch precisa de empacotamento para Android quando deve ser instalado a partir de um inicializador do Android, ser executado sem abrir o Scratch ou ser distribuído como um arquivo de aplicativo. O resultado é um aplicativo Android que contém o projeto e um runtime compatível com Scratch, não um substituto editável do projeto original.

O que os arquivos SB3 e APK contêm

.sb3 é o formato de projeto usado pelo Scratch e por editores compatíveis, como TurboWarp. É um arquivo baseado em ZIP que contém project.json, scripts, fantasias de sprites, sons e outros recursos; usuários do Scratch, educadores e estudantes o utilizam para salvar e editar projetos.

.apk é um pacote de aplicativo Android que contém um manifesto do Android, código do aplicativo, recursos e uma assinatura digital. Um APK pode ser instalado diretamente para testes ou distribuição privada, pode aparecer no inicializador de aplicativos do Android e pode incluir recursos do projeto para uso offline. O Google Play normalmente exige um Android App Bundle (.aab) para novos aplicativos, não um APK.

O Android não pode executar um arquivo .sb3 por si só. O empacotamento deve fornecer um runtime Scratch baseado na web e encapsulá-lo em um aplicativo Android.

Empacote o projeto com TurboWarp e Android Studio

TurboWarp Packager é a ferramenta online apropriada para transformar um projeto compatível com Scratch em um aplicativo HTML autônomo. Ele não é um conversor de arquivos genérico: empacota o projeto com o runtime necessário para executá-lo. Phosphorus está obsoleto para projetos Scratch 3 modernos, e serviços de encapsulamento de sites, como AppsGeyser, não empacotam de forma confiável o runtime do projeto, os recursos, as permissões ou a configuração de assinatura.

1. No Scratch, use File → Save to your computer para manter o arquivo .sb3 original.
2. Abra o TurboWarp Packager, escolha Load from your computer e selecione o arquivo .sb3. Teste a prévia, incluindo sons, controles, sprites e extensões.
3. Selecione a saída HTML/web e baixe o pacote HTML autocontido. Se o download se chamar project.html, crie uma pasta chamada www e renomeie o arquivo para www/index.html.
4. Instale Node.js e Android Studio. Em um terminal, crie um projeto Capacitor e adicione o suporte ao 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

Copie a pasta www preparada para o diretório do projeto antes de executar npx cap sync android. Use um ID de aplicativo de domínio reverso em minúsculas, como com.example.myscratchapp; ele deve ser exclusivo ao publicar.

5. No Android Studio, defina o código da versão, o nome da versão, o ícone do aplicativo e quaisquer permissões necessárias. Use Build → Generate Signed Bundle / APK; selecione APK para instalação direta ou Android App Bundle para o Google Play e, em seguida, crie ou selecione um keystore de lançamento.
6. Instale o APK assinado em um dispositivo Android físico para testes. O Android pode exigir que o gerenciador de arquivos, o navegador ou o aplicativo de compartilhamento que receber o arquivo tenha permissão para instalar aplicativos desconhecidos.

Limites de compatibilidade e distribuição

Teste nas versões do Android e nos tamanhos de tela que receberão o aplicativo. Os controles por toque, a orientação da tela, o comportamento da reprodução automática de áudio, o desempenho e as suposições sobre o teclado físico podem ser diferentes dos do navegador para desktop.

Câmera, microfone, geolocalização, área de transferência, seleção de arquivos e recursos de detecção semelhantes do Scratch podem exigir permissões no manifesto do Android e aprovação em tempo de execução. Algumas APIs do navegador e extensões personalizadas precisam de alterações nativas no Android ou não funcionarão dentro de um WebView.

As variáveis de nuvem do Scratch e os recursos de conta do Scratch não são confiáveis em um aplicativo empacotado, pois dependem dos serviços web do Scratch e do comportamento da sessão. Use um backend separado ou um serviço compatível de variáveis de nuvem se o aplicativo exigir dados online compartilhados.

Mantenha o arquivo .sb3 original para futuras edições e arquivamento. Um APK ou AAB é um pacote de implantação; extraí-lo não fornece um projeto prático para edição no Scratch.