Convertir OBB en APK

Un appareil ou un programme d'installation peut n'accepter qu'un APK même lorsqu'un jeu Android fournit un fichier d'extension OBB distinct. Les fichiers ne sont pas interchangeables : installez l'APK et l'OBB correspondants, ou reconstruisez l'application à partir du code source en y intégrant les données d'extension.

Qu'est-ce que le format OBB ?

OBB est un format de fichier d'extension Android utilisé pour les ressources volumineuses d'une application, telles que les modèles 3D, les cartes, l'audio, la vidéo et les données de jeu. Les anciens packages d'extension Google Play et les jeux conçus avec Unity ou d'autres moteurs l'utilisent couramment ; les applications Google Play plus récentes utilisent souvent Play Asset Delivery à la place.

Un OBB contient normalement des données plutôt que du code d'application exécutable, un manifeste Android, des permissions ou des métadonnées de package installables. Son nom de fichier est généralement lié au nom du package et à sa version, par exemple main.123.com.example.game.obb ou patch.123.com.example.game.obb. L'emplacement attendu est Android/obb/<package-name>/.

Certains fichiers OBB sont compatibles avec ZIP et peuvent être inspectés ou extraits avec 7-Zip, mais OBB n'est pas une variante d'APK. L'extraction ne crée pas de package installable, et un OBB peut utiliser une structure propriétaire ou chiffrée.

Qu'est-ce que le format APK ?

APK est le format de package d'application installable d'Android. Il contient normalement du code compilé, des ressources, un manifeste Android, des bibliothèques natives si nécessaire et des informations de signature. Android Package Manager peut l'installer après avoir validé la structure et la signature de son package.

Un APK est basé sur ZIP ; renommer file.obb en file.apk n'ajoute donc pas le code, le manifeste ou la signature manquants. Un APK peut néanmoins nécessiter un OBB distinct au moment de l'exécution. Certaines applications actuelles sont distribuées sous forme de split APKs générés à partir d'un Android App Bundle et nécessitent l'installation simultanée de plusieurs fichiers APK.

Un APK est utile pour le sideloading, l'archivage et l'installation du package de l'application lui-même ; il ne constitue pas nécessairement une copie autonome de toutes les données de l'application.

Comment utiliser un OBB avec son APK

Il n'existe pas de convertisseur générique OBB vers APK fiable. Pour un APK et un OBB fournis ensemble, conservez les deux fichiers et installez-les comme un ensemble correspondant.

1. Installez l'APK avec Android Package Installer ou utilisez adb install app.apk. Pour les split packages, utilisez adb install-multiple base.apk split_*.apk avec tous les APK requis.
2. Vérifiez le nom du package et la version. Sur un ordinateur de bureau, aapt dump badging app.apk ou apkanalyzer du Android SDK peuvent afficher les métadonnées du package.
3. Créez /sdcard/Android/obb/<package-name>/ sur l'appareil et copiez-y l'OBB correspondant sans modifier son nom de fichier. Une séquence ADB typique est adb shell mkdir -p /sdcard/Android/obb/com.example.game, suivie de adb push main.123.com.example.game.obb /sdcard/Android/obb/com.example.game/.
4. Démarrez l'application. Le nom du package, le numéro de version, le nom de fichier et le répertoire attendu de l'OBB doivent correspondre à l'application installée ; sinon, celle-ci peut signaler des données manquantes ou incompatibles.

Android 11 et les versions ultérieures restreignent l'accès des gestionnaires de fichiers ordinaires à Android/obb. Utilisez l'installateur pris en charge par le jeu, ADB ou un gestionnaire de fichiers disposant d'une méthode autorisée d'accès aux fichiers système ; les restrictions d'accès varient selon la version d'Android et le fabricant de l'appareil.

Comment créer un seul APK à partir des données

Pour une application dont vous êtes propriétaire ou que vous êtes autorisé à modifier, reconstruisez-la à partir du projet Android Studio d'origine plutôt que de convertir le binaire OBB.

1. Extrayez l'OBB avec 7-Zip s'il est lisible, puis placez les ressources nécessaires dans app/src/main/assets/ ou dans un répertoire de ressources approprié.
2. Modifiez le code de l'application afin qu'il lise les nouveaux chemins d'accès aux ressources internes au lieu de Android/obb/.
3. Adaptez les paramètres de packaging Gradle, de compression et de distribution des ressources pour les fichiers ajoutés.
4. Construisez avec ./gradlew assembleRelease, puis signez la sortie avec Android Studio via Build → Generate Signed Bundle/APK ou avec apksigner du Android SDK.
5. Testez l'APK signé sur les versions Android, configurations d'écran et architectures CPU ciblées.

Si seuls des fichiers compilés sont disponibles, apktool peut décoder et reconstruire certaines ressources APK, et 7-Zip peut inspecter les archives, mais aucun des deux ne convertit un OBB en APK. Le code décompilé peut être incomplet, les bibliothèques natives nécessitent une gestion distincte, et les clés de signature d'origine, le code source, la configuration de build et les dépendances côté serveur peuvent être indisponibles.

Limites de compatibilité et de qualité

L'intégration des données d'extension peut rendre l'APK trop volumineux pour le canal de distribution prévu, augmenter le temps d'installation, entraîner une compression redondante et empêcher le fonctionnement du code qui attend un chemin d'accès particulier au fichier d'extension. L'OBB peut également être chiffré, verrouillé sur une version, spécifique à une architecture ou dépendre de licences et de services en ligne.

Un APK reconstruit doit être signé. Une nouvelle clé de signature ne peut pas mettre à jour une installation existante signée avec une clé différente ; l'application d'origine peut donc devoir être désinstallée, ce qui peut supprimer ses données privées. Le repackaging peut également échouer en raison des licences Google Play, des contrôles d'intégrité, des dépendances de split APK, des bibliothèques natives ou de la validation côté serveur.

Aucun convertisseur en ligne réputé ne peut fournir de manière générique le code d'application et les métadonnées de package manquants. Les outils d'archivage en ligne peuvent afficher un OBB compatible avec ZIP, mais l'importation de données de jeux commerciaux ou de ressources privées peut divulguer des fichiers protégés par le droit d'auteur ou confidentiels. Utilisez 7-Zip pour l'inspection, Android Studio pour une reconstruction autorisée, et ADB ou l'installateur de l'application pour le déploiement.