Konwertuj SB3 na APK

Projekt Scratch wymaga pakowania na Androida, gdy musi być instalowany z poziomu launchera Androida, działać bez otwierania Scratcha lub być dystrybuowany jako plik aplikacji. Rezultatem jest aplikacja Android zawierająca projekt i zgodny ze Scratch runtime, a nie edytowalny zamiennik oryginalnego projektu.

Co zawierają pliki SB3 i APK

.sb3 to format projektu używany przez Scratch i zgodne edytory, takie jak TurboWarp. Jest to archiwum oparte na ZIP, zawierające project.json, skrypty, kostiumy duszków, dźwięki i inne zasoby; użytkownicy Scratcha, nauczyciele i uczniowie używają go do zapisywania i edytowania projektów.

.apk to pakiet aplikacji Android zawierający manifest Androida, kod aplikacji, zasoby i podpis cyfrowy. Plik APK można instalować bezpośrednio w celu testowania lub prywatnej dystrybucji, może pojawiać się w launcherze aplikacji Androida i może zawierać zasoby projektu do użytku offline. Google Play zwykle wymaga pakietu Android App Bundle (.aab) dla nowych aplikacji, a nie pliku APK.

Android nie może samodzielnie uruchomić pliku .sb3. Pakowanie musi dostarczyć webowy runtime Scratcha i opakować go w aplikację Android.

Pakowanie projektu za pomocą TurboWarp i Android Studio

TurboWarp Packager to odpowiednie narzędzie online do przekształcania projektu zgodnego ze Scratch w samodzielną aplikację HTML. Nie jest to ogólny konwerter plików: pakuje projekt wraz z runtime wymaganym do jego uruchomienia. Phosphorus jest przestarzały w przypadku współczesnych projektów Scratch 3, a usługi typu website-wrapper, takie jak AppsGeyser, nie zapewniają niezawodnego pakowania runtime projektu, zasobów, uprawnień ani konfiguracji podpisywania.

1. W Scratch użyj File → Save to your computer, aby zachować oryginalny plik .sb3.
2. Otwórz TurboWarp Packager, wybierz Load from your computer i wskaż plik .sb3. Przetestuj podgląd, w tym dźwięki, elementy sterujące, duszki i rozszerzenia.
3. Wybierz wyjście HTML/web i pobierz samodzielny pakiet HTML. Jeśli pobrany plik nosi nazwę project.html, utwórz folder o nazwie www i zmień nazwę pliku na www/index.html.
4. Zainstaluj Node.js i Android Studio. W terminalu utwórz projekt Capacitor i dodaj obsługę Androida:

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

Skopiuj przygotowany folder www do katalogu projektu przed uruchomieniem npx cap sync android. Użyj małych liter w identyfikatorze aplikacji w formacie reverse-domain, takim jak com.example.myscratchapp; podczas publikowania musi on być unikatowy.

5. W Android Studio ustaw version code, version name, ikonę aplikacji oraz wszelkie wymagane uprawnienia. Użyj Build → Generate Signed Bundle / APK; wybierz APK w przypadku bezpośredniej instalacji lub Android App Bundle w przypadku Google Play, a następnie utwórz albo wybierz release keystore.
6. Zainstaluj podpisany plik APK na fizycznym urządzeniu Android w celu przetestowania. Android może wymagać zezwolenia menedżerowi plików, przeglądarce lub aplikacji do udostępniania otrzymującej plik na instalowanie nieznanych aplikacji.

Ograniczenia zgodności i dystrybucji

Testuj aplikację na wersjach Androida i rozmiarach ekranów, na których będzie używana. Sterowanie dotykowe, orientacja ekranu, zachowanie automatycznego odtwarzania dźwięku, wydajność oraz założenia dotyczące klawiatury sprzętowej mogą różnić się od tych w przeglądarce desktopowej.

Kamera, mikrofon, geolokalizacja, schowek, wybór plików i podobne funkcje wykrywania Scratcha mogą wymagać uprawnień w manifeście Androida oraz zatwierdzenia w czasie działania. Niektóre browser APIs i niestandardowe rozszerzenia wymagają natywnych zmian w Androidzie lub nie będą działać wewnątrz WebView.

Zmienne chmurowe Scratcha i funkcje kont Scratcha nie są niezawodne w spakowanej aplikacji, ponieważ zależą od web service Scratcha i zachowania sesji. Jeśli aplikacja wymaga współdzielonych danych online, użyj osobnego backendu lub zgodnej usługi cloud variables.

Zachowaj oryginalny plik .sb3 do późniejszej edycji i archiwizacji. APK lub AAB to pakiet wdrożeniowy; jego wyodrębnienie nie zapewnia praktycznego projektu do edycji w Scratchu.