Converti OBB in APK

Un dispositivo o un installer può accettare solo un APK anche quando un gioco Android fornisce un file di espansione OBB separato. I file non sono intercambiabili: installare l'APK e l'OBB corrispondenti oppure ricostruire l'applicazione dal codice sorgente includendo i dati di espansione.

Cos'è il formato OBB

OBB è un formato di file di espansione Android utilizzato per asset applicativi di grandi dimensioni, come modelli 3D, mappe, audio, video e dati di gioco. I precedenti pacchetti di espansione di Google Play e i giochi realizzati con Unity o altri engine lo utilizzano comunemente; le applicazioni Google Play più recenti utilizzano spesso Play Asset Delivery.

Un OBB contiene normalmente dati anziché codice applicativo eseguibile, un manifest Android, autorizzazioni o metadati di pacchetto installabili. Il suo nome file è solitamente associato al nome del pacchetto e alla versione, ad esempio main.123.com.example.game.obb o patch.123.com.example.game.obb. Il percorso previsto è Android/obb/<package-name>/.

Alcuni file OBB sono compatibili con ZIP e possono essere esaminati o estratti con 7-Zip, ma OBB non è una variante di APK. L'estrazione non crea un pacchetto installabile e un OBB può utilizzare una struttura proprietaria o crittografata.

Cos'è il formato APK

APK è il formato di pacchetto applicativo installabile di Android. Normalmente contiene codice compilato, risorse, un manifest Android, librerie native quando richieste e informazioni di firma. Android Package Manager può installarlo dopo aver convalidato la struttura e la firma del pacchetto.

Un APK è basato su ZIP, quindi rinominare file.obb in file.apk non aggiunge il codice, il manifest o la firma mancanti. Un APK può comunque richiedere un OBB separato durante l'esecuzione. Alcune applicazioni attuali sono distribuite come split APK generati da un Android App Bundle e richiedono l'installazione congiunta di diversi file APK.

Un APK è utile per il sideloading, l'archiviazione e l'installazione del pacchetto applicativo stesso; non è necessariamente una copia autonoma di tutti i dati dell'applicazione.

Come utilizzare un OBB con il relativo APK

Non esiste un convertitore generico OBB-to-APK affidabile. Per un APK e un OBB forniti insieme, conservare entrambi i file e installarli come set corrispondente.

1. Installare l'APK con Android Package Installer oppure utilizzare adb install app.apk. Per i pacchetti suddivisi, utilizzare adb install-multiple base.apk split_*.apk con tutti gli APK richiesti.
2. Confermare il nome del pacchetto e la versione. Su un desktop, aapt dump badging app.apk o apkanalyzer di Android SDK possono mostrare i metadati del pacchetto.
3. Creare /sdcard/Android/obb/<package-name>/ sul dispositivo e copiarvi l'OBB corrispondente senza modificarne il nome file. Una tipica sequenza ADB è adb shell mkdir -p /sdcard/Android/obb/com.example.game seguita da adb push main.123.com.example.game.obb /sdcard/Android/obb/com.example.game/.
4. Avviare l'applicazione. Il nome del pacchetto, il numero di versione, il nome file e la directory prevista dell'OBB devono corrispondere all'applicazione installata; in caso contrario potrebbe segnalare dati mancanti o incompatibili.

Android 11 e versioni successive limitano l'accesso dei normali file manager a Android/obb. Utilizzare l'installer supportato dal gioco, ADB o un file manager dotato di un metodo autorizzato di accesso ai file di sistema; le restrizioni di accesso variano in base alla versione di Android e al produttore del dispositivo.

Come creare un unico APK dai dati

Per un'applicazione di cui si è proprietari o che si è autorizzati a modificare, ricostruirla dal progetto Android Studio originale anziché convertire il file OBB binario.

1. Estrarre l'OBB con 7-Zip se è leggibile, quindi inserire gli asset richiesti in app/src/main/assets/ o in una directory di risorse appropriata.
2. Modificare il codice dell'applicazione affinché legga i nuovi percorsi degli asset interni invece di Android/obb/.
3. Regolare le impostazioni Gradle relative a pacchettizzazione, compressione e distribuzione degli asset per i file aggiunti.
4. Creare la build con ./gradlew assembleRelease, quindi firmare l'output con Android Studio tramite Build → Generate Signed Bundle/APK oppure con apksigner di Android SDK.
5. Testare l'APK firmato sulle versioni Android, configurazioni dello schermo e architetture CPU di destinazione.

Se sono disponibili solo file compilati, apktool può decodificare e ricostruire alcune risorse APK e 7-Zip può esaminare gli archivi, ma nessuno dei due converte un OBB in un APK. Il codice decompilato può essere incompleto, le librerie native richiedono una gestione separata e le chiavi di firma originali, il codice sorgente, la configurazione di build e le dipendenze lato server potrebbero non essere disponibili.

Limiti di compatibilità e qualità

L'inclusione dei dati di espansione può rendere l'APK troppo grande per il canale di distribuzione previsto, aumentare il tempo di installazione, duplicare la compressione e compromettere il codice che si aspetta un determinato percorso del file di espansione. L'OBB può inoltre essere crittografato, vincolato a una versione, specifico per un'architettura o dipendere da licenze e servizi online.

Un APK ricostruito deve essere firmato. Una nuova chiave di firma non può aggiornare un'installazione esistente firmata con una chiave diversa, quindi potrebbe essere necessario disinstallare l'applicazione originale, rimuovendo così i relativi dati privati. Il repackaging può inoltre non riuscire a causa delle licenze Google Play, dei controlli di integrità, delle dipendenze degli split APK, delle librerie native o della convalida del server.

Nessun convertitore online affidabile può fornire genericamente il codice applicativo e i metadati di pacchetto mancanti. Gli strumenti online per archivi possono visualizzare un OBB compatibile con ZIP, ma il caricamento di dati di giochi commerciali o asset privati può divulgare file protetti da copyright o riservati. Utilizzare 7-Zip per l'ispezione, Android Studio per una ricostruzione autorizzata e ADB o l'installer dell'applicazione per la distribuzione.