Převod souboru ZIP do APK

Instalační program pro Android vyžaduje soubor .apk, když stažení aplikace dorazí jako soubor .zip nebo když je projekt Android nutné zabalit pro testování či sideloading. Správný výsledek závisí na tom, zda archiv obsahuje existující APK, projekt, který lze sestavit, dekódované soubory APK, nebo pouze nesouvisející soubory.

Co je formát ZIP

ZIP je kompresní archiv pro obecné použití, který sdružuje soubory a složky pro stahování, sdílení, zálohování a ukládání. Windows File Explorer, macOS Archive Utility, 7-Zip, WinRAR, Android Studio a systémy sestavení mohou vytvářet archivy ZIP.

Soubor ZIP dodaný se softwarem pro Android může obsahovat projekt Android Studio, zdrojový kód, obrázky, knihovny, dekompilovanou aplikaci nebo soubor APK uložený v jiném archivu. Archivy projektů při přenosu zachovávají požadovanou strukturu složek; aplikacemi se stanou až po kompilaci zdrojového kódu.

Co je formát APK

APK je formát aplikačních balíčků systému Android. Interně používá kontejnery ZIP, ale instalovatelný balíček obvykle obsahuje zkompilovaný soubor AndroidManifest.xml, zkompilované prostředky, například resources.arsc, bajtkód DEX, například classes.dex, a podle potřeby nativní knihovny ve složce lib/.

Balíčky Android musí být podepsané. Ladicí soubory APK obvykle používají ladicí klíč Android Studio; vydané soubory APK používají podpisový klíč spravovaný vývojářem. Soubory APK jsou určeny k instalaci do systému Android, testování, sideloadingu a distribuci mimo Google Play. Google Play obvykle přijímá Android App Bundles (.aab), které nejsou přímo instalovatelnými soubory APK.

Jak sestavit APK ze souboru ZIP

Pokud ZIP obsahuje projekt Android Studio

1. Rozbalte archiv pomocí 7-Zip nebo archivačního nástroje operačního systému. Příponu nejprve neměňte.
2. Otevřete Android Studio a zvolte File → Open. Vyberte rozbalený adresář obsahující settings.gradle, settings.gradle.kts nebo aplikační modul.
3. Nechte Gradle provést synchronizaci. Nainstalujte platformu Android SDK, build tools a další verze vyžadované projektem.
4. Pro testovací balíček zvolte Build → Generate App Bundles or APKs → Generate APKs. Pro distribuci zvolte Build → Generate Signed App Bundle or APK, vyberte APK a zadejte podpisový klíč.
5. Zkontrolujte cestu, například app/build/outputs/apk/debug/app-debug.apk nebo app/build/outputs/apk/release/app-release.apk.

V adresáři projektu spusťte v systému macOS nebo Linux příkaz ./gradlew assembleDebug, nebo v systému Windows příkaz gradlew.bat assembleDebug. Vydaná sestavení obvykle vyžadují konfiguraci podpisu; příkaz assembleRelease použijte až po konfiguraci keystore a nastavení podpisu.

Pokud ZIP obsahuje existující APK

Rozbalte archiv a vyhledejte soubor s příponou .apk. Před instalací ověřte jeho zdroj a podpis. Pokud byl původní soubor APK přejmenován na .zip, změňte příponu zpět na .apk; jeho obsah nerozbalujte, znovu nekomprimujte ani neupravujte.

Pokud ZIP obsahuje dekódované soubory APK

Archiv vytvořený pomocí APKTool lze znovu sestavit pomocí APKTool, libovolný soubor ZIP však nikoli. Po instalaci APKTool spusťte příkaz apktool b extracted-app -o rebuilt.apk. Výsledek zarovnejte a podepište pomocí Android SDK Build Tools:

1. zipalign -v -p 4 rebuilt.apk aligned.apk
2. apksigner sign --ks release-key.jks --out signed.apk aligned.apk
3. apksigner verify signed.apk

Chcete-li vytvořit aktualizaci, použijte stejný podpisový klíč jako u původní aplikace; balíček podepsaný jiným klíčem nemůže nahradit existující instalaci. Opětovné sestavení aplikace jiného vývojáře může porušovat její licenci nebo pravidla ochrany před zásahy.

Pokud ZIP obsahuje pouze zdrojové soubory nebo prostředky

Nejde o převod formátu souboru. Vytvořte nebo otevřete projekt Android, umístěte povolené prostředky do příslušných adresářů app/src/main, přidejte kód aplikace a platný manifest, nakonfigurujte závislosti a oprávnění a poté projekt sestavte a podepište pomocí Android Studio nebo Gradle.

Online a desktopové nástroje

Žádný renomovaný online konvertor na jedno kliknutí nedokáže změnit libovolný soubor ZIP na funkční APK: nedokáže vytvořit chybějící kód Android, spolehlivě zkompilovat neznámý projekt ani podepsat výsledek vaším soukromým klíčem. Desktopová aplikace Android Studio s Gradle je vhodným nástrojem pro zdrojové projekty; APKTool je vhodný pouze pro opětovné sestavení souborů APK dekódovaných pomocí APKTool; nástroje zipalign a apksigner dokončují proces vydání.

U projektu, který lze sestavit neinteraktivně, je renomovanou online možností soukromý pracovní postup GitHub Actions spouštějící úlohu Gradle projektu. Přihlašovací údaje pro podpis ukládejte jako šifrovaná tajemství repozitáře, omezte přístup k pracovnímu postupu a neodesílejte proprietární zdrojový kód, keystores ani soukromé soubory APK na obecné konverzní weby. Online archivační služby mohou soubor ZIP rozbalit, ale rozbalení není vytvořením APK.

Omezení kompatibility a kvality

Přejmenování .zip na .apk nezkompiluje zdrojový kód, nevytvoří manifest, nevygeneruje soubory DEX, nezabalí prostředky, nezarovná soubory ani nepodepíše balíček. Obecný soubor ZIP může mít podobnou strukturu kontejneru, ale přesto může být pro Android nepoužitelný.

Sestavení musí používat verze SDK a build tools kompatibilní s projektem. Instalace může také záviset na úrovni Android API zařízení, architektuře CPU, názvu balíčku, oprávněních a schématu podpisu. APK obsahující pouze vybrané nativní architektury nemusí fungovat na zařízeních s jinou architekturou, zatímco APK zaměřené na nekompatibilní platformu může odmítnout instalaci nebo se chovat nesprávně.