Converter ZIP para AAR

Uma biblioteca Android pode ser distribuída como um ZIP, mesmo que o Android Studio ou o Gradle exija uma dependência AAR. A ação necessária é reconstruir o projeto da biblioteca ou confirmar que o ZIP já possui o layout de um AAR; alterar .zip para .aar normalmente não é uma conversão.

O que é o formato ZIP

ZIP é um formato de arquivo de uso geral para agrupar e compactar arquivos. Desenvolvedores o utilizam para projetos de código-fonte Android, pacotes de SDK, código de exemplo, arquivos compilados e distribuições de lançamento; Windows, macOS, Linux, 7-Zip e sistemas de build podem criá-lo e extraí-lo.

ZIP não impõe nenhuma estrutura de diretórios específica do Android. Inspecione o arquivo antes de escolher um método de conversão: ele pode conter um projeto Gradle completo, uma biblioteca já empacotada, arquivos de código-fonte ou arquivos não relacionados.

O que é o formato AAR

AAR, ou Android Archive, é o formato de pacote produzido para um módulo de biblioteca Android. O Android Gradle Plugin e o Android Studio podem usá-lo como uma dependência local, e um repositório Maven pode distribuí-lo com os metadados correspondentes.

Um AAR é tecnicamente um arquivo ZIP com um layout de biblioteca Android. Um AAR normal contém AndroidManifest.xml, classes.jar, res/ e R.txt; ele também pode conter assets/, jni/, libs/, prefab/, public.txt, proguard.txt, lint.jar e outras entradas compatíveis. Ele pode empacotar bytecode Java ou Kotlin compilado, recursos Android, declarações de manifesto, bibliotecas nativas e regras R8 ou ProGuard para consumidores. Diferentemente de um JAR simples, ele pode conter recursos Android e componentes nativos.

Como converter um ZIP que contém um projeto de biblioteca

1. Extraia o ZIP com o 7-Zip, o utilitário de arquivos do sistema ou o Android Studio. Encontre settings.gradle ou settings.gradle.kts e um módulo que contenha build.gradle ou build.gradle.kts.
2. Confirme se o módulo de destino aplica o plugin de biblioteca Android, como com.android.library, em vez de com.android.application. Não altere um módulo de aplicação para uma biblioteca sem verificar o manifesto, as dependências e a configuração de build.
3. Abra o projeto extraído no Android Studio, instale as versões do SDK e das build-tools solicitadas pelo projeto e permita que a sincronização do Gradle seja concluída. Resolva os repositórios, plugins e dependências ausentes antes de fazer o build.
4. Faça o build da variante de release no Android Studio com Build → Make Project ou execute a task do módulo no diretório do projeto:

./gradlew :library:assembleRelease

No Windows, execute gradlew.bat :library:assembleRelease. Substitua library pelo nome real do módulo. A saída normalmente fica em library/build/outputs/aar/, por exemplo, library-release.aar. Use a task de debug somente quando um AAR de debug for especificamente necessário.

Como lidar com um ZIP que já é um AAR

Abra o arquivo com o 7-Zip ou outro utilitário de arquivos e inspecione seu nível superior. Se ele tiver a estrutura de um AAR, incluindo AndroidManifest.xml, classes.jar, res/ e R.txt, talvez tenha recebido a extensão incorreta. Faça uma cópia e renomeie-a:

mv library.zip library.aar

No Windows:

ren library.zip library.aar

Se os arquivos estiverem aninhados dentro de um diretório extra, reempacote o conteúdo para que essas entradas fiquem na raiz do arquivo. Renomear ou reempacotar não compila o código-fonte, processa recursos, gera R.txt nem adiciona um manifesto. Teste o AAR resultante em uma aplicação Android pequena.

Como lidar com código-fonte ou arquivos arbitrários

Um ZIP que contenha apenas .java, .kt, .class, documentos ou pastas arbitrárias não pode ser convertido de forma confiável por um conversor de arquivos. Crie ou abra um módulo de biblioteca Android, coloque o código-fonte em src/main/java/ ou src/main/kotlin/, coloque os recursos em src/main/res/, coloque os assets em src/main/assets/, configure o manifesto e as dependências e execute assembleRelease.

Os arquivos nativos devem usar os diretórios de ABI esperados, como src/main/jniLibs/arm64-v8a/. O Android Gradle Plugin precisa compilar o código e os recursos; um utilitário ZIP genérico não pode executar essas etapas.

Ferramentas para desktop e online

Android Studio com Gradle é a opção apropriada para desktop quando o ZIP contém código-fonte ou um projeto Gradle. 7-Zip, Finder, File Explorer e os comandos de linha de comando unzip ou zip são adequados para inspeção e reempacotamento simples.

Serviços de arquivos online, como CloudConvert ou Zamzar, podem oferecer suporte ao reempacotamento genérico de ZIP ou à conversão de extensão, mas não conseguem resolver dependências Android nem fazer o build de um AAR. Use um serviço online somente para um arquivo não confidencial que já tenha o conteúdo correto de um AAR; não faça upload de código-fonte proprietário, SDKs, material de assinatura ou bibliotecas privadas.

Verificações de compatibilidade

Antes de distribuir o resultado, abra o AAR como um ZIP e verifique o manifesto, o classes.jar, os recursos, as bibliotecas nativas, os assets e as regras para consumidores. Teste-o com o Android Gradle Plugin, o compile SDK, a versão do Kotlin e as ABIs de dispositivos compatíveis do projeto consumidor.

Um AAR não inclui automaticamente todas as dependências externas do Maven. Os consumidores talvez precisem declarar essas dependências separadamente, e uma dependência de arquivo local não fornece os metadados de dependência que uma publicação Maven oferece. Adicione um AAR local com uma dependência Gradle, como implementation files('libs/library-release.aar'), ou publique o AAR em um repositório Maven com seu POM e os metadados do módulo.