Converter TGZ para APK

Um dispositivo Android aceita um APK, não um TGZ; portanto, um TGZ pode precisar ser processado quando um aplicativo foi fornecido como um archive ou quando um projeto Android precisa produzir um pacote instalável. A operação correta é a extração e, quando necessário, a compilação; alterar a extensão do nome do arquivo não converte o arquivo.

O que é o formato TGZ

TGZ é um archive tar compactado com gzip, também escrito como .tar.gz. Ferramentas Unix e Linux, repositórios de código-fonte, sistemas de build e fluxos de trabalho de desenvolvimento Android usam esse formato para agrupar diretórios preservando caminhos e, quando compatível, permissões.

Um TGZ em um contexto de desenvolvimento mobile pode conter um projeto Android Studio com settings.gradle ou settings.gradle.kts, arquivos de build do Gradle, gradlew, um AndroidManifest.xml, código-fonte, recursos e bibliotecas nativas. Ele também pode conter um APK pronto ou arquivos não relacionados. A extensão do archive não identifica seu conteúdo.

O que é o formato APK

Um APK é o pacote de aplicativo instalável do Android. É um pacote baseado em ZIP que contém código de aplicativo compilado, recursos, um manifest, bibliotecas nativas opcionais e dados de assinatura do Android. O package manager do Android verifica a assinatura do APK, as permissões solicitadas, os requisitos de SDK mínimo e de destino, a política do dispositivo e a arquitetura de CPU compatível antes da instalação.

Um APK é uma saída de build, não um archive de projeto Android. O Android Gradle Plugin compila o código-fonte e os recursos, empacota-os e assina o resultado. Portanto, um archive que contém código-fonte precisa ser compilado; um archive que contém um APK existente só precisa ser extraído. APKs permitem testes diretos e sideloading, incluindo instalação offline, mas a publicação na Play Store geralmente usa um Android App Bundle (.aab).

Como processar um TGZ que contém um APK

1. Extraia o TGZ com um utilitário de desktop, como 7-Zip ou PeaZip, ou com a linha de comando:

tar -xzf package.tgz -C extracted

2. Procure no diretório extraído por arquivos que terminem em .apk. Inspecione o nome e o local do arquivo para selecionar a variante desejada, como debug, release ou um build específico para o dispositivo.
3. Copie o APK para o dispositivo e abra-o, ou instale-o com o Android Debug Bridge:

adb install path/to/app-release.apk

Ative a instalação a partir da configuração relevante de fontes desconhecidas ao fazer sideloading por meio de um gerenciador de arquivos e não instale um APK de uma fonte não confiável. Se o package manager o rejeitar, verifique a assinatura, a versão do Android, a arquitetura de CPU, a política do dispositivo e se já existe outra instalação com uma chave de assinatura diferente.

Restaure a extensão .apk somente se o arquivo for realmente um APK cujo nome foi alterado. Um TGZ contém dados TAR compactados com gzip; renomeá-lo para .apk não pode torná-lo instalável. Um APK legítimo é baseado em ZIP e pode ser identificado por sua estrutura de arquivos ou aberto com uma ferramenta de archive, mas não se deve usar apenas a alteração do nome para contornar controles de segurança.

Como compilar um APK a partir de um projeto Android

1. Instale o Android Studio, a versão do JDK exigida pelo Android Gradle Plugin do projeto e os componentes do Android SDK necessários. Extraia o TGZ em um diretório com permissão de escrita.
2. Abra o projeto extraído no Android Studio com File → Open. Escolha o diretório que contém settings.gradle ou settings.gradle.kts, não o próprio arquivo TGZ.
3. Permita que a sincronização do Gradle seja concluída. Instale as plataformas do SDK e as ferramentas de build solicitadas e resolva as dependências dos repositórios declarados pelo projeto. Um projeto com arquivos de código-fonte ausentes, dependências privadas indisponíveis ou versões incompatíveis do Gradle e do plugin não pode ser compilado sem modificações.
4. Para um build de teste, selecione Build → Generate App Bundles or APKs → Generate APKs e escolha o módulo e a variante necessários. O Android Studio normalmente coloca o resultado em app/build/outputs/apk/, embora o nome do módulo e os product flavors possam alterar esse caminho.
5. Para distribuição, use Build → Generate App Bundles or APKs → Generate Signed App Bundle or APK, selecione APK e assine a variante release com um keystore privado. Mantenha o keystore e as senhas separados do TGZ e do repositório de código-fonte.

Os comandos equivalentes do Gradle, executados a partir do diretório do projeto, são:

./gradlew assembleDebug
./gradlew assembleRelease

No Windows, use gradlew.bat assembleDebug ou gradlew.bat assembleRelease. Projetos com flavors podem exigir uma task como assembleFreeRelease; liste as tasks disponíveis com ./gradlew tasks.

Opções de ferramentas online e de desktop

7-Zip e PeaZip são extractors de desktop adequados para arquivos TGZ. O Android Studio com o Gradle wrapper do projeto é a ferramenta de build local apropriada; usar o wrapper preserva a versão do Gradle esperada pelo projeto.

Não existe um conversor online genérico e confiável de TGZ para APK: um serviço web não pode determinar como um código-fonte arbitrário deve ser compilado, fornecer dependências privadas, selecionar versões compatíveis do SDK ou produzir uma assinatura de release com segurança. Para um build na nuvem, um serviço baseado em repositório, como GitHub Actions ou Codemagic, pode executar o build do Gradle do projeto, mas configure por conta própria o workflow, o SDK, as dependências, os secrets de assinatura e o gerenciamento dos artifacts. Não envie código-fonte proprietário ou keystores para um conversor não verificado.

Limites de compatibilidade e qualidade

Um TGZ que contenha arquivos arbitrários, binários Linux, código-fonte incompleto ou apenas um módulo de biblioteca Android não produz automaticamente um APK. Um build bem-sucedido não garante a instalação: o pacote pode exigir uma versão mais recente do Android, uma ABI não compatível, hardware indisponível, permissões bloqueadas por uma política ou uma chave de assinatura que entre em conflito com uma versão instalada.

APKs debug são assinados com uma chave debug e destinam-se a testes. APKs release exigem uma chave de assinatura controlada, e alterá-la impede uma atualização sobre uma instalação existente assinada com a chave original. Se o projeto for compatível com várias arquiteturas ou versões do Android, compile as variantes apropriadas ou use a configuração de empacotamento documentada do projeto.