Převod souboru HTML do APK

APK je potřeba, když má být obsah HTML nainstalován, spuštěn a spravován jako aplikace pro Android namísto otevření v prohlížeči. Výsledkem není přímá konverze souboru: kód aplikace pro Android zabalí webové soubory, ikonu aplikace, manifest, oprávnění a informace o podepisování.

Co je HTML

HTML (HyperText Markup Language) je značkovací jazyk v prostém textu, který definuje strukturu webových stránek a rozhraní založených na prohlížeči. Používají ho weboví vývojáři, systémy pro správu obsahu, nástroje pro tvorbu webů a editory, jako jsou Visual Studio Code a Adobe Dreamweaver.

Projekt HTML obvykle obsahuje vstupní stránku, například index.html, šablony stylů CSS, JavaScript, obrázky, fonty a další assety. HTML není spustitelný software pro Android; vytvoření APK vyžaduje obálku pro Android, která obvykle obsahuje WebView zobrazující zabalenou webovou aplikaci.

Co je APK

APK (Android Package Kit) je instalovatelný balíček aplikace pro Android. Obsahuje manifest Androidu, zkompilovaný kód, prostředky, přibalené webové assety, pokud jsou relevantní, a kryptografický podpis, který identifikuje vydavatele aplikace.

APK jsou užitečné pro testování na zařízeních, interní distribuci, nasazení v podnicích, kiosk zařízení a přímou instalaci mimo Google Play. Android může vyžadovat, aby uživatel povolil prohlížeči nebo správci souborů použitým k instalaci APK instalaci z neznámých zdrojů.

Google Play obecně vyžaduje, aby nové aplikace byly nahrány jako .aab Android App Bundle, nikoli jako APK. Android Studio dokáže ze stejného projektu vygenerovat oba formáty; Google Play z Android App Bundle vytvoří optimalizované APK pro jednotlivá zařízení.

Zabalení lokálního HTML pomocí Capacitor

Capacitor s Android Studio je praktická desktopová možnost pro lokální projekt HTML, CSS a JavaScriptu. Zdrojové soubory a podpisový klíč zůstávají pod kontrolou vývojáře a v případě potřeby lze prostřednictvím pluginů Capacitoru využívat funkce Androidu.

1. Vytvořte složku projektu s podsložkou www. Do složky www umístěte index.html, CSS, JavaScript, obrázky, fonty a další lokální assety.
2. Používejte relativní cesty, například images/logo.png a ./styles.css. Neodkazujte na soubory v počítači používaném k vývoji, například C:\site\logo.png.
3. Do souboru index.html přidejte značku viewportu: <meta name="viewport" content="width=device-width, initial-scale=1">.
4. Otestujte webové soubory v prohlížeči. Zabalení neopraví chybějící assety, nefunkční JavaScript ani nepodporovaná API prohlížeče.
5. Nainstalujte aktuální verzi Node.js LTS a Android Studio. V Android Studio nainstalujte platformu Android SDK a Build Tools prostřednictvím Tools → SDK Manager.
6. Otevřete terminál ve složce projektu a spusťte npm init -y a poté npm install @capacitor/core @capacitor/cli @capacitor/android.
7. Inicializujte Capacitor pomocí npx cap init MyApp com.example.myapp --web-dir=www. Nahraďte com.example.myapp jedinečným ID aplikace ve formátu obrácené domény.
8. Vytvořte a synchronizujte projekt Androidu: npx cap add android a poté npx cap sync android.
9. Otevřete jej v Android Studio pomocí npx cap open android.

Sestavení a podepsání APK

1. Počkejte na dokončení synchronizace Gradle a nainstalujte všechny komponenty Android SDK, které Android Studio vyžádá.
2. Vytvořte testovací APK prostřednictvím Build → Build Bundle(s) / APK(s) → Build APK(s). Debug soubor se obvykle nachází v android/app/build/outputs/apk/debug/app-debug.apk.
3. Vytvořte distribuovatelné release APK prostřednictvím Build → Generate Signed Bundle / APK → APK.
4. Vytvořte nebo vyberte keystore, zadejte jeho alias klíče a hesla, vyberte variantu release a dokončete sestavení.

Keystore a jeho přihlašovací údaje bezpečně zálohujte. Aktualizace pod stejným ID aplikace musí být podepsány stejným klíčem; ztracený klíč znemožní běžné aktualizace již nainstalovaných kopií. Po změně souborů ve složce www spusťte před opětovným sestavením npx cap sync android.

Možnost hostované PWA

PWABuilder je renomovaná webová možnost pro již nasazenou progresivní webovou aplikaci. Dokáže vytvořit balíček pro Android založený na Trusted Web Activity, pokud web používá HTTPS a má platný webový manifest, service worker a ověření domény pomocí Digital Asset Links.

Trusted Web Activity načítá živý web v poskytovateli prohlížeče, jako je Chrome; nezabaluje libovolné lokální soubory HTML pro offline použití. Pokud musí být soubory přibaleny v APK nebo musí aplikace fungovat bez připojení, použijte Capacitor nebo projekt nativního Android WebView.

Omezení kompatibility a kvality

Aplikace Capacitoru se vykreslují prostřednictvím Android System WebView, který se může lišit od desktopového Chrome. Otestujte nejstarší podporovanou verzi Androidu, zejména rozložení CSS, chování klávesnice, přehrávání médií, nahrávání a stahování souborů, vyskakovací okna, přístup ke kameře a JavaScriptová API.

Přibalené lokální soubory fungují offline pouze tehdy, když jsou zahrnuty všechny požadované assety. Vzdálená API, analytické skripty, webové fonty, videa, obrázky a externí JavaScript stále vyžadují síťový přístup. Moderní konfigurace Androidu běžně blokují nešifrovaný provoz http://, proto by vzdálené služby měly používat HTTPS.

Přístup ke kameře, oznámení, přístup k souborům, sdílení a podobné funkce zařízení vyžadují pluginy Capacitoru nebo nativní kód Androidu. Tyto funkce mohou také vyžadovat deklarace v manifestu a žádosti o oprávnění za běhu. Vyhněte se obecným online převaděčům „HTML na APK“ u důvěrných souborů nebo produkčních vydání, protože mohou nahrávat zdrojový kód, mít pod kontrolou podpisový klíč a poskytovat omezenou údržbu při změnách Androidu.