Převod souboru TGZ do APK

Zařízení Android přijímá APK, nikoli TGZ, takže TGZ může vyžadovat zpracování, pokud byla aplikace dodána jako archiv nebo pokud má projekt Android vytvořit instalovatelný balíček. Správnou operací je extrakce a v případě potřeby kompilace; změnou přípony souboru se soubor nepřevede.

Co je formát TGZ

TGZ je archiv tar komprimovaný pomocí gzip, zapisovaný také jako .tar.gz. Nástroje Unix a Linux, repozitáře zdrojového kódu, build systémy a pracovní postupy vývoje pro Android jej používají k zabalení adresářů při zachování cest a případně také oprávnění.

TGZ v kontextu vývoje pro mobilní zařízení může obsahovat projekt Android Studio se souborem settings.gradle nebo settings.gradle.kts, build soubory Gradle, gradlew, soubor AndroidManifest.xml, zdrojový kód, prostředky a nativní knihovny. Může také obsahovat hotový APK nebo nesouvisející soubory. Přípona archivu neurčuje jeho obsah.

Co je formát APK

APK je instalovatelný aplikační balíček systému Android. Jedná se o balíček založený na ZIP, který obsahuje zkompilovaný kód aplikace, prostředky, manifest, volitelné nativní knihovny a podpisová data systému Android. Správce balíčků systému Android před instalací kontroluje podpis APK, požadovaná oprávnění, požadavky na minimální a cílovou verzi SDK, zásady zařízení a kompatibilní architekturu CPU.

APK je výstup buildu, nikoli archiv projektu Android. Android Gradle Plugin kompiluje zdrojový kód a prostředky, balí je a podepisuje výsledný soubor. Archiv obsahující zdrojový kód proto musí být sestaven; archiv obsahující existující APK vyžaduje pouze extrakci. APK podporuje přímé testování a sideloading včetně offline instalace, ale pro publikování v Play Store se obvykle používá Android App Bundle (.aab).

Jak zpracovat TGZ obsahující APK

1. Extrahujte TGZ pomocí desktopového nástroje, jako je 7-Zip nebo PeaZip, případně pomocí příkazového řádku:

tar -xzf package.tgz -C extracted

2. V extrahovaném adresáři vyhledejte soubory končící na .apk. Pro výběr požadované varianty, například debug, release nebo buildu pro konkrétní zařízení, zkontrolujte název a umístění souboru.
3. Zkopírujte APK do zařízení a otevřete jej, nebo jej nainstalujte pomocí Android Debug Bridge:

adb install path/to/app-release.apk

Při sideloadingu prostřednictvím správce souborů povolte instalaci v příslušném nastavení neznámých zdrojů a neinstalujte APK z nedůvěryhodného zdroje. Pokud správce balíčků instalaci odmítne, zkontrolujte podpis, verzi Androidu, architekturu CPU, zásady zařízení a to, zda již neexistuje jiná instalace s odlišným podpisovým klíčem.

Příponu .apk obnovte pouze tehdy, pokud je soubor skutečně APK, jehož název byl změněn. TGZ obsahuje data TAR komprimovaná pomocí gzip; přejmenování na .apk z něj neudělá instalovatelný soubor. Skutečné APK je založené na ZIP a lze je identifikovat podle struktury souboru nebo otevřením pomocí archivačního nástroje, ale samotné přejmenování by se nemělo používat k obcházení bezpečnostních mechanismů.

Jak sestavit APK z projektu Android

1. Nainstalujte Android Studio, verzi JDK požadovanou projektem Android Gradle Plugin a potřebné komponenty Android SDK. Extrahujte TGZ do adresáře, do kterého lze zapisovat.
2. Otevřete extrahovaný projekt v Android Studio pomocí File → Open. Vyberte adresář obsahující settings.gradle nebo settings.gradle.kts, nikoli samotný soubor TGZ.
3. Nechte dokončit synchronizaci Gradle. Nainstalujte požadované platformy SDK a build tools a vyřešte závislosti z repozitářů deklarovaných projektem. Projekt s chybějícími zdrojovými soubory, nedostupnými privátními závislostmi nebo nekompatibilními verzemi Gradle a pluginu nelze bez úprav sestavit.
4. Pro testovací build vyberte Build → Generate App Bundles or APKs → Generate APKs a zvolte požadovaný modul a variantu. Android Studio obvykle umístí výsledek do app/build/outputs/apk/, ačkoli název modulu a produktové varianty mohou tuto cestu změnit.
5. Pro distribuci použijte Build → Generate App Bundles or APKs → Generate Signed App Bundle or APK, vyberte APK a podepište release variantu pomocí privátního keystore. Keystore a hesla uchovávejte odděleně od TGZ a zdrojového repozitáře.

Ekvivalentní příkazy Gradle spuštěné z adresáře projektu jsou:

./gradlew assembleDebug
./gradlew assembleRelease

V systému Windows použijte gradlew.bat assembleDebug nebo gradlew.bat assembleRelease. Projekty s variantami mohou vyžadovat úlohu, jako je assembleFreeRelease; dostupné úlohy zobrazíte pomocí ./gradlew tasks.

Výběr online a desktopových nástrojů

7-Zip a PeaZip jsou vhodné desktopové nástroje pro extrakci souborů TGZ. Android Studio s wrapperem Gradle projektu je vhodným lokálním nástrojem pro build; použití wrapperu zachovává verzi Gradle očekávanou projektem.

Neexistuje spolehlivý obecný online převodník TGZ na APK: webová služba nedokáže odvodit, jak kompilovat libovolný zdrojový kód, poskytnout privátní závislosti, vybrat kompatibilní verze SDK ani bezpečně vytvořit podpis release verze. Pro cloudový build může služba založená na repozitáři, například GitHub Actions nebo Codemagic, spustit build projektu Gradle, ale konfiguraci workflow, SDK, závislostí, podpisových tajemství a zpracování artefaktů si musíte zajistit sami. Nenahrávejte proprietární zdrojový kód ani keystory do neověřeného převodníku.

Omezení kompatibility a kvality

TGZ obsahující libovolné soubory, binární soubory Linuxu, neúplný zdrojový kód nebo pouze modul knihovny Android automaticky nevytvoří APK. Úspěšný build nezaručuje instalaci: balíček může vyžadovat novější verzi Androidu, nepodporované ABI, nedostupný hardware, oprávnění blokovaná zásadami nebo podpisový klíč, který je v konfliktu s nainstalovanou verzí.

Debug APK jsou podepsána debug klíčem a jsou určena k testování. Release APK vyžadují řízený podpisový klíč a jeho změna znemožní aktualizaci existující instalace podepsané původním klíčem. Pokud projekt podporuje několik architektur nebo verzí Androidu, sestavte příslušné varianty nebo použijte konfiguraci balení zdokumentovanou projektem.