Konversi SB3 menjadi APK

Sebuah proyek Scratch memerlukan packaging Android jika harus diinstal dari Android launcher, dijalankan tanpa membuka Scratch, atau didistribusikan sebagai file aplikasi. Hasilnya adalah aplikasi Android yang berisi proyek dan runtime yang kompatibel dengan Scratch, bukan pengganti yang dapat diedit untuk proyek asli.

Isi file SB3 dan APK

.sb3 adalah format proyek yang digunakan oleh Scratch dan editor yang kompatibel seperti TurboWarp. Format ini merupakan archive berbasis ZIP yang berisi project.json, scripts, sprite costumes, sounds, dan assets lainnya; pengguna Scratch, pendidik, dan siswa menggunakannya untuk menyimpan dan mengedit proyek.

.apk adalah Android application package yang berisi Android manifest, app code, resources, dan digital signature. APK dapat diinstal langsung untuk testing atau distribusi pribadi, dapat muncul di Android app launcher, dan dapat menyertakan project assets untuk penggunaan offline. Google Play biasanya mewajibkan Android App Bundle (.aab) untuk aplikasi baru, bukan APK.

Android tidak dapat menjalankan file .sb3 dengan sendirinya. Packaging harus menyediakan web-based Scratch runtime dan membungkusnya dalam aplikasi Android.

Package proyek dengan TurboWarp dan Android Studio

TurboWarp Packager adalah online tool yang sesuai untuk mengubah proyek yang kompatibel dengan Scratch menjadi standalone HTML application. Ini bukan generic file converter: tool ini melakukan packaging proyek bersama runtime yang diperlukan untuk menjalankannya. Phosphorus sudah obsolete untuk proyek Scratch 3 modern, dan website-wrapper services seperti AppsGeyser tidak secara andal melakukan packaging terhadap project runtime, assets, permissions, atau signing configuration.

1. Di Scratch, gunakan File → Save to your computer untuk menyimpan file .sb3 asli.
2. Buka TurboWarp Packager, pilih Load from your computer, lalu pilih file .sb3. Uji preview, termasuk sounds, controls, sprites, dan extensions.
3. Pilih HTML/web output dan download self-contained HTML package. Jika hasil download bernama project.html, buat folder bernama www dan ubah nama file menjadi www/index.html.
4. Instal Node.js dan Android Studio. Di terminal, buat proyek Capacitor dan tambahkan dukungan 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

Salin folder www yang telah disiapkan ke dalam project directory sebelum menjalankan npx cap sync android. Gunakan lowercase reverse-domain application ID seperti com.example.myscratchapp; ID tersebut harus unik saat dipublikasikan.

5. Di Android Studio, atur version code, version name, app icon, dan permissions yang diperlukan. Gunakan Build → Generate Signed Bundle / APK; pilih APK untuk direct installation atau Android App Bundle untuk Google Play, lalu buat atau pilih release keystore.
6. Instal signed APK pada perangkat Android fisik untuk testing. Android mungkin mengharuskan file manager, browser, atau sharing app yang menerima file tersebut diberi izin untuk menginstal unknown apps.

Batasan compatibility dan distribution

Uji pada versi Android dan screen sizes yang akan menerima aplikasi. Touch controls, screen orientation, audio autoplay behavior, performance, dan asumsi hardware keyboard dapat berbeda dari desktop browser.

Camera, microphone, geolocation, clipboard, file selection, dan fitur Scratch sensing serupa dapat memerlukan Android manifest permissions dan runtime approval. Beberapa browser APIs dan custom extensions memerlukan perubahan native Android atau tidak akan berfungsi di dalam WebView.

Scratch cloud variables dan Scratch account features tidak dapat diandalkan dalam packaged app karena bergantung pada Scratch web-service dan session behavior. Gunakan backend terpisah atau compatible cloud-variable service jika aplikasi memerlukan shared online data.

Simpan file .sb3 asli untuk editing dan archival di masa mendatang. APK atau AAB adalah deployment package; mengekstraknya tidak akan menyediakan practical Scratch editing project.