Konwertuj APK na CSV

System inwentaryzacji aplikacji lub arkusz kalkulacyjny może wymagać nazw pakietów, wersji, poziomów SDK lub uprawnień w formacie CSV. Ponieważ APK jest pakietem Android, a nie tabelą, praktycznym rozwiązaniem jest wyodrębnienie wybranych metadanych lub osadzonego pliku danych, a nie konwertowanie całego pakietu.

Czym jest format APK

APK to instalowalny pakiet używany przez Android. Android Studio, Gradle i inne systemy kompilacji Android tworzą pliki APK, które są rozpowszechniane przez deweloperów, dostawców aplikacji, administratorów przedsiębiorstw, testerów i użytkowników za pośrednictwem Google Play, zarządzanych systemów wdrażania lub bezpośrednich pobrań.

APK jest kontenerem opartym na formacie ZIP, który zwykle zawiera AndroidManifest.xml, skompilowany kod bajtowy Dalvik lub ART w pliku classes.dex, zasoby, biblioteki natywne, zasoby aplikacji oraz dane podpisu. Może zawierać osadzony plik CSV lub inny dokument, ale baza danych używana w czasie działania aplikacji oraz dane utworzone przez użytkownika zwykle znajdują się oddzielnie na urządzeniu Android.

Czym jest format CSV

CSV przechowuje rekordy w postaci rozdzielanych tekstowych wierszy i kolumn. Microsoft Excel, LibreOffice Calc, Google Sheets, bazy danych, skrypty i systemy inwentaryzacji mogą importować ten format bez konieczności używania oryginalnej aplikacji.

CSV sprawdza się w przypadku pól takich jak nazwa pakietu, kod wersji, nazwa wersji, etykieta aplikacji, minimalny SDK, docelowy SDK, uprawnienia, ścieżki plików lub jeden rekord na APK. Nie może zachować kodu wykonywalnego, podpisów, obrazów, zasobów ani pełnej struktury katalogów w postaci użytecznej pojedynczej tabeli.

Wyodrębnianie metadanych APK za pomocą narzędzi Android

1. Zainstaluj Android SDK Build-Tools i zlokalizuj aapt2. Dodaj katalog Build-Tools z odpowiednią wersją do ścieżki poleceń lub wywołuj plik wykonywalny za pomocą pełnej ścieżki.
2. Sprawdź pakiet za pomocą aapt2 dump badging app.apk. Przekieruj wynik do badging.txt, jeśli potrzebujesz również czytelnego dla człowieka raportu.
3. Wyodrębnij wybrane pola do jednego wiersza CSV za pomocą skryptu takiego jak poniższy, zapisanego jako 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)

Uruchom go za pomocą python apk_metadata_csv.py app.apk app.csv. Wynik zawiera jeden wiersz nagłówka i jeden wiersz metadanych. Uruchom skrypt raz dla każdego pliku APK i dołącz wiersze danych do pliku z tym samym nagłówkiem podczas tworzenia inwentaryzacji.

Wyodrębnianie osadzonego pliku CSV

Otwórz APK za pomocą 7-Zip lub innego narzędzia do obsługi plików ZIP i sprawdź katalogi assets, res/raw oraz inne katalogi. Użyj 7-Zip → Extract to… i otwórz bezpośrednio dowolny istniejący plik .csv; konwersja formatu nie jest potrzebna. Plik o innej strukturze, taki jak JSON lub SQLite, wymaga własnego parsera lub procedury eksportu.

Użyj Apktool, gdy potrzebujesz zdekodowanych zasobów lub czytelnego manifestu, a JADX, gdy potrzebujesz widoków zdekompilowanego kodu aplikacji przypominających kod Java. Żadne z tych narzędzi nie konwertuje kompletnego APK na znaczące rekordy CSV. Ponowna kompilacja APK po zdekodowaniu może unieważnić jego oryginalny podpis, chyba że zostanie podpisany ponownie.

Opcje online i desktopowe

Nie istnieje renomowana usługa online ogólnego przeznaczenia, która mogłaby wywnioskować znaczący schemat CSV z każdego pliku APK. Narzędzia desktopowe, takie jak Android SDK Build-Tools, 7-Zip, Apktool i JADX, pozwalają uniknąć przesyłania zastrzeżonego kodu, certyfikatów lub osadzonych danych. Internetowy analizator APK może być przydatny w przypadku niewrażliwej próbki, jeśli wyraźnie opisuje eksport metadanych lub raportów, ale przed przesłaniem sprawdź, czy wynik jest rzeczywiście plikiem CSV, i zapoznaj się z zasadami przechowywania danych.

Ograniczenia jakości i zgodności

Metadane mogą być niekompletne, gdy wartości są zaciemnione, zlokalizowane, zakodowane w zasobach binarnych lub niedostępne za pomocą wybranego narzędzia. Aplikacja dzielona może składać się z bazowego APK oraz plików APK konfiguracji i funkcji; jeśli inwentaryzacja ma przedstawiać zainstalowaną aplikację, sprawdź cały zestaw.

Podczas importowania wyniku wybierz UTF-8 i użyj przecinka jako separatora, chyba że system odbierający określa inny separator. Traktuj nazwy pakietów i kody wersji jako tekst, aby oprogramowanie arkusza kalkulacyjnego ich nie przeformatowało. Ujmuj w cudzysłowy pola zawierające przecinki, cudzysłowy lub podziały wiersza; writer CSV w Pythonie obsługuje to automatycznie.

Wyodrębnianie danych nie konwertuje ani nie modyfikuje oryginalnego APK. Nie przesyłaj prywatnych, podpisanych, zastrzeżonych ani będących próbkami złośliwego oprogramowania pakietów do usługi online, ponieważ analiza może ujawnić kod aplikacji, osadzone sekrety, dane użytkownika lub informacje o podpisie.