Converti TGZ in APK

Un dispositivo Android accetta un APK, non un TGZ, quindi un TGZ può richiedere un'elaborazione quando un'app è stata fornita come archivio o quando un progetto Android deve produrre un pacchetto installabile. L'operazione corretta consiste nell'estrazione e, quando necessario, nella compilazione; modificare l'estensione del file non converte il file.

Cos'è il formato TGZ

TGZ è un archivio tar compresso con gzip, scritto anche come .tar.gz. Gli strumenti Unix e Linux, i repository del codice sorgente, i sistemi di build e i workflow di sviluppo Android lo usano per raggruppare directory preservando i percorsi e, quando supportato, le autorizzazioni.

Un TGZ in un contesto di sviluppo mobile può contenere un progetto Android Studio con settings.gradle o settings.gradle.kts, file di build Gradle, gradlew, un AndroidManifest.xml, codice sorgente, risorse e librerie native. Può invece contenere un APK già pronto o file non correlati. L'estensione dell'archivio non ne identifica il contenuto.

Cos'è il formato APK

Un APK è il pacchetto applicativo installabile di Android. È un pacchetto basato su ZIP contenente codice applicativo compilato, risorse, un manifest, eventuali librerie native e i dati di firma Android. Il package manager di Android verifica la firma dell'APK, le autorizzazioni richieste, i requisiti minimi e di target SDK, i criteri del dispositivo e l'architettura CPU compatibile prima dell'installazione.

Un APK è un output di build, non un archivio di progetto Android. Android Gradle Plugin compila il codice sorgente e le risorse, li inserisce nel pacchetto e firma il risultato. Pertanto, un archivio contenente codice sorgente deve essere compilato; un archivio contenente un APK esistente richiede soltanto l'estrazione. Gli APK supportano il testing diretto e il sideloading, inclusa l'installazione offline, ma per la pubblicazione sul Play Store viene generalmente utilizzato invece un Android App Bundle (.aab).

Come elaborare un TGZ contenente un APK

1. Estrai il TGZ con un'utilità desktop come 7-Zip o PeaZip, oppure dalla riga di comando:

tar -xzf package.tgz -C extracted

2. Cerca nella directory estratta i file che terminano con .apk. Esamina il nome e il percorso del file per selezionare la variante desiderata, ad esempio una build debug, release o specifica per un dispositivo.
3. Copia l'APK sul dispositivo e aprilo, oppure installalo con Android Debug Bridge:

adb install path/to/app-release.apk

Abilita l'installazione dall'impostazione pertinente relativa alle origini sconosciute quando esegui il sideloading tramite un file manager e non installare APK provenienti da fonti non attendibili. Se il package manager lo rifiuta, controlla la firma, la versione di Android, l'architettura CPU, i criteri del dispositivo e se esiste già un'altra installazione con una chiave di firma diversa.

Ripristina l'estensione .apk solo se il file è effettivamente un APK il cui nome è stato modificato. Un TGZ contiene dati TAR compressi con gzip; rinominarlo in .apk non può renderlo installabile. Un APK autentico è basato su ZIP e può essere identificato dalla sua struttura di file o aprendolo con uno strumento per archivi, ma la semplice ridenominazione non deve essere utilizzata per aggirare i controlli di sicurezza.

Come compilare un APK da un progetto Android

1. Installa Android Studio, la versione del JDK richiesta da Android Gradle Plugin del progetto e i componenti Android SDK necessari. Estrai il TGZ in una directory in cui sia possibile scrivere.
2. Apri il progetto estratto in Android Studio con File → Open. Scegli la directory contenente settings.gradle o settings.gradle.kts, non il file TGZ stesso.
3. Attendi il completamento della sincronizzazione Gradle. Installa le piattaforme SDK e gli strumenti di build richiesti e risolvi le dipendenze dai repository dichiarati dal progetto. Un progetto con file sorgente mancanti, dipendenze private non disponibili o versioni incompatibili di Gradle e dei plugin non può essere compilato senza modifiche.
4. Per una build di test, seleziona Build → Generate App Bundles or APKs → Generate APKs e scegli il modulo e la variante richiesti. Android Studio normalmente inserisce il risultato in app/build/outputs/apk/, anche se il nome del modulo e i product flavor possono modificare questo percorso.
5. Per la distribuzione, usa Build → Generate App Bundles or APKs → Generate Signed App Bundle or APK, seleziona APK e firma la variante release con un keystore privato. Conserva il keystore e le password separatamente dal TGZ e dal repository del codice sorgente.

I comandi Gradle equivalenti, eseguiti dalla directory del progetto, sono:

./gradlew assembleDebug
./gradlew assembleRelease

Su Windows, usa gradlew.bat assembleDebug o gradlew.bat assembleRelease. I progetti con flavor possono richiedere un task come assembleFreeRelease; elenca i task disponibili con ./gradlew tasks.

Scelta degli strumenti online e desktop

7-Zip e PeaZip sono estrattori desktop adatti ai file TGZ. Android Studio con il Gradle wrapper del progetto è lo strumento di build locale appropriato; l'utilizzo del wrapper mantiene la versione di Gradle prevista dal progetto.

Non esiste un convertitore online generico TGZ-to-APK affidabile: un servizio web non può dedurre come compilare un codice sorgente arbitrario, fornire dipendenze private, selezionare versioni SDK compatibili o produrre in modo sicuro una firma release. Per una cloud build, un servizio basato su repository come GitHub Actions o Codemagic può eseguire la build Gradle del progetto, ma devi configurare personalmente il workflow, l'SDK, le dipendenze, i secret di firma e la gestione degli artifact. Non caricare codice sorgente proprietario o keystore su un convertitore non verificato.

Limiti di compatibilità e qualità

Un TGZ contenente file arbitrari, binari Linux, codice sorgente incompleto o soltanto un modulo di libreria Android non produce automaticamente un APK. Una build completata correttamente non garantisce l'installazione: il pacchetto potrebbe richiedere una versione più recente di Android, un'ABI non supportata, hardware non disponibile, autorizzazioni bloccate dai criteri o una chiave di firma in conflitto con una versione installata.

Gli APK debug sono firmati con una chiave debug e sono destinati al testing. Gli APK release richiedono una chiave di firma controllata e la modifica di tale chiave impedisce un aggiornamento di un'installazione esistente firmata con la chiave originale. Se il progetto supporta diverse architetture o versioni di Android, compila le varianti appropriate o usa la configurazione di packaging documentata dal progetto.