Convertir TGZ en APK

Un appareil Android accepte un APK, et non un TGZ. Un TGZ peut donc nécessiter un traitement lorsqu'une application a été fournie sous forme d'archive ou qu'un projet Android doit produire un package installable. L'opération correcte consiste à extraire et, si nécessaire, à compiler ; modifier l'extension du nom de fichier ne convertit pas le fichier.

Qu'est-ce que le format TGZ ?

TGZ est une archive tar compressée avec gzip, également écrite sous la forme .tar.gz. Les outils Unix et Linux, les référentiels de code source, les systèmes de build et les workflows de développement Android l'utilisent pour regrouper des répertoires tout en préservant les chemins et, lorsque cela est pris en charge, les permissions.

Dans le contexte du développement mobile, un TGZ peut contenir un projet Android Studio avec settings.gradle ou settings.gradle.kts, des fichiers de build Gradle, gradlew, un AndroidManifest.xml, du code source, des ressources et des bibliothèques natives. Il peut également contenir un APK finalisé ou des fichiers sans rapport. L'extension de l'archive n'identifie pas son contenu.

Qu'est-ce que le format APK ?

Un APK est le package d'application installable d'Android. Il s'agit d'un package basé sur ZIP contenant du code d'application compilé, des ressources, un manifeste, des bibliothèques natives facultatives et des données de signature Android. Le gestionnaire de packages d'Android vérifie la signature de l'APK, les permissions demandées, les exigences minimales et cibles du SDK, la politique de l'appareil et l'architecture CPU compatible avant l'installation.

Un APK est un résultat de build, et non une archive de projet Android. Android Gradle Plugin compile le code source et les ressources, les regroupe et signe le résultat. Par conséquent, une archive contenant du code source doit être compilée ; une archive contenant un APK existant doit seulement être extraite. Les APK prennent en charge les tests directs et le sideloading, y compris l'installation hors ligne, mais la publication sur le Play Store utilise généralement un Android App Bundle (.aab) à la place.

Comment traiter un TGZ contenant un APK

1. Extrayez le TGZ avec un utilitaire de bureau tel que 7-Zip ou PeaZip, ou avec la ligne de commande :

tar -xzf package.tgz -C extracted

2. Recherchez dans le répertoire extrait les fichiers se terminant par .apk. Examinez le nom et l'emplacement du fichier pour sélectionner la variante souhaitée, par exemple debug, release ou une build spécifique à l'appareil.
3. Copiez l'APK sur l'appareil et ouvrez-le, ou installez-le avec Android Debug Bridge :

adb install path/to/app-release.apk

Activez l'installation depuis la source inconnue appropriée lorsque vous effectuez un sideloading via un gestionnaire de fichiers, et n'installez pas d'APK provenant d'une source non fiable. Si le gestionnaire de packages le rejette, vérifiez la signature, la version d'Android, l'architecture CPU, la politique de l'appareil et l'existence éventuelle d'une autre installation utilisant une clé de signature différente.

Ne rétablissez l'extension .apk que si le fichier est réellement un APK dont le nom a été modifié. Un TGZ contient des données TAR compressées avec gzip ; le renommer en .apk ne peut pas le rendre installable. Un véritable APK est basé sur ZIP et peut être identifié grâce à sa structure de fichiers ou en l'ouvrant avec un outil d'archivage, mais le simple renommage ne doit pas être utilisé pour contourner les contrôles de sécurité.

Comment compiler un APK à partir d'un projet Android

1. Installez Android Studio, la version du JDK requise par l'Android Gradle Plugin du projet et les composants Android SDK nécessaires. Extrayez le TGZ dans un répertoire accessible en écriture.
2. Ouvrez le projet extrait dans Android Studio avec File → Open. Choisissez le répertoire contenant settings.gradle ou settings.gradle.kts, et non le fichier TGZ lui-même.
3. Laissez la synchronisation Gradle se terminer. Installez les plateformes SDK et les build tools demandés, puis résolvez les dépendances depuis les référentiels déclarés par le projet. Un projet auquel il manque des fichiers source, qui dépend de dépendances privées indisponibles ou qui utilise des versions incompatibles de Gradle et du plugin ne peut pas être compilé sans modification.
4. Pour une build de test, sélectionnez Build → Generate App Bundles or APKs → Generate APKs, puis choisissez le module et la variante requis. Android Studio place normalement le résultat sous app/build/outputs/apk/, bien que le nom du module et les product flavors puissent modifier ce chemin.
5. Pour la distribution, utilisez Build → Generate App Bundles or APKs → Generate Signed App Bundle or APK, sélectionnez APK et signez la variante release avec un keystore privé. Conservez le keystore et les mots de passe séparément du TGZ et du référentiel de code source.

Les commandes Gradle équivalentes, exécutées depuis le répertoire du projet, sont :

./gradlew assembleDebug
./gradlew assembleRelease

Sous Windows, utilisez gradlew.bat assembleDebug ou gradlew.bat assembleRelease. Les projets utilisant des flavors peuvent nécessiter une tâche telle que assembleFreeRelease ; répertoriez les tâches disponibles avec ./gradlew tasks.

Choix des outils en ligne et de bureau

7-Zip et PeaZip sont des extracteurs de bureau adaptés aux fichiers TGZ. Android Studio avec le Gradle wrapper du projet est l'outil de build local approprié ; l'utilisation du wrapper préserve la version de Gradle attendue par le projet.

Il n'existe pas de convertisseur générique TGZ vers APK fiable : un service web ne peut pas déterminer comment compiler un code source arbitraire, fournir des dépendances privées, sélectionner des versions compatibles du SDK ou produire une signature release en toute sécurité. Pour une build cloud, un service basé sur un référentiel tel que GitHub Actions ou Codemagic peut exécuter la build Gradle du projet, mais vous devez configurer vous-même le workflow, le SDK, les dépendances, les secrets de signature et la gestion des artefacts. Ne téléversez pas de code source propriétaire ni de keystores vers un convertisseur non vérifié.

Limites de compatibilité et de qualité

Un TGZ contenant des fichiers arbitraires, des binaires Linux, du code source incomplet ou uniquement un module de bibliothèque Android ne produit pas automatiquement un APK. Une build réussie ne garantit pas l'installation : le package peut nécessiter une version plus récente d'Android, une ABI non prise en charge, du matériel indisponible, des permissions bloquées par une politique ou une clé de signature entrant en conflit avec une version installée.

Les APK debug sont signés avec une clé de debug et sont destinés aux tests. Les APK release nécessitent une clé de signature contrôlée, et la modification de cette clé empêche la mise à jour d'une installation existante signée avec la clé d'origine. Si le projet prend en charge plusieurs architectures ou versions d'Android, compilez les variantes appropriées ou utilisez la configuration de packaging documentée par le projet.