Converter APK para CSV

Um sistema de inventário de aplicações ou uma planilha pode exigir nomes de pacotes, versões, níveis de SDK ou permissões no formato CSV. Como um APK é um pacote Android, e não uma tabela, a operação prática consiste em extrair metadados selecionados ou um arquivo de dados incorporado, não em converter o pacote inteiro.

O que é o formato APK

Um APK é o pacote instalável usado pelo Android. Android Studio, Gradle e outros sistemas de build do Android criam arquivos APK, que desenvolvedores, fornecedores de aplicações, administradores corporativos, testadores e usuários distribuem por meio do Google Play, sistemas de implantação gerenciada ou downloads diretos.

Um APK é um contêiner baseado em ZIP que normalmente inclui AndroidManifest.xml, bytecode compilado do Dalvik ou ART em classes.dex, recursos, bibliotecas nativas, assets e dados de assinatura. Ele pode conter um CSV incorporado ou outro documento, mas o banco de dados de runtime da aplicação e os dados criados pelo usuário normalmente ficam armazenados separadamente no dispositivo Android.

O que é o formato CSV

CSV armazena registros como linhas e colunas de texto delimitadas. Microsoft Excel, LibreOffice Calc, Google Sheets, bancos de dados, scripts e sistemas de inventário podem importá-lo sem exigir a aplicação original.

CSV funciona para campos como nome do pacote, version code, version name, application label, SDK mínimo, SDK de destino, permissões, caminhos de arquivos ou um registro por APK. Ele não pode preservar código executável, assinaturas, imagens, recursos ou a estrutura completa de diretórios como uma única tabela útil.

Extrair metadados do APK com ferramentas do Android

1. Instale o Android SDK Build-Tools e localize aapt2. Adicione o diretório versionado do Build-Tools ao caminho de comandos ou chame o executável usando seu caminho completo.
2. Inspecione o pacote com aapt2 dump badging app.apk. Redirecione o resultado para badging.txt se também precisar de um relatório legível.
3. Extraia os campos selecionados para uma linha CSV com um script como o seguinte, salvo como apk_metadata_csv.py:

import csv
import re
import subprocess
import sys

apk = sys.argv[1]
outfile = sys.argv[2]
text = subprocess.check_output(
    ['aapt2', 'dump', 'badging', apk],
    text=True,
    errors='replace'
)

def find(pattern):
    match = re.search(pattern, text)
    return match.group(1) if match else ''

row = {
    'file': apk,
    'package': find(r"package: name='([^']+)"),
    'version_code': find(r"versionCode='([^']*)"),
    'version_name': find(r"versionName='([^']*)"),
    'label': find(r"application-label:'([^']*)"),
    'min_sdk': find(r"sdkVersion:'([^']*)"),
    'target_sdk': find(r"targetSdkVersion:'([^']*)")
}

with open(outfile, 'w', newline='', encoding='utf-8') as file:
    writer = csv.DictWriter(file, fieldnames=row)
    writer.writeheader()
    writer.writerow(row)

Execute-o com python apk_metadata_csv.py app.apk app.csv. O resultado terá uma linha de cabeçalho e uma linha de metadados. Execute o script uma vez por APK e anexe as linhas de dados a um arquivo com o mesmo cabeçalho ao criar um inventário.

Extrair um CSV incorporado

Abra o APK com o 7-Zip ou outro utilitário ZIP e inspecione assets, res/raw e outros diretórios. Use 7-Zip → Extract to… e abra diretamente qualquer arquivo .csv existente; nenhuma conversão de formato é necessária. Um arquivo com uma estrutura diferente, como JSON ou SQLite, exige seu próprio parser ou procedimento de exportação.

Use o Apktool quando precisar de recursos decodificados ou de um manifest legível, e o JADX quando precisar de visualizações semelhantes a Java do código de aplicação descompilado. Nenhuma dessas ferramentas converte o APK completo em registros CSV significativos. Reconstruir um APK após a decodificação pode invalidar sua assinatura original, a menos que ele seja assinado novamente.

Opções online e para desktop

Não existe um serviço online geral e confiável que consiga inferir um esquema CSV significativo de qualquer APK. Ferramentas para desktop, como Android SDK Build-Tools, 7-Zip, Apktool e JADX, evitam o upload de código proprietário, certificados ou dados incorporados. Um analisador de APK online pode ser útil para uma amostra não sensível se documentar explicitamente a exportação de metadados ou relatórios, mas verifique se a saída é realmente CSV e analise sua política de retenção antes de fazer o upload.

Limites de qualidade e compatibilidade

Os metadados podem estar incompletos quando os valores estão ofuscados, localizados, codificados em recursos binários ou indisponíveis na ferramenta selecionada. Uma aplicação dividida pode consistir em um APK base e APKs de configuração e de recursos; inspecione o conjunto completo quando o inventário precisar representar a aplicação instalada.

Ao importar o resultado, selecione UTF-8 e use uma vírgula como delimitador, a menos que o sistema receptor especifique outro separador. Trate nomes de pacotes e version codes como texto para que o software de planilha não os reformate. Coloque entre aspas os campos que contenham vírgulas, aspas ou quebras de linha; o writer de CSV do Python gerencia essa colocação entre aspas automaticamente.

Extrair dados não converte nem altera o APK original. Não faça upload de pacotes privados, assinados, proprietários ou amostras de malware para um serviço online, pois a análise pode expor código da aplicação, segredos incorporados, dados do usuário ou informações de assinatura.