Převod souboru HTM do APK

Stránka HTM potřebuje APK, pokud ji uživatelé musí instalovat ze zařízení Android, spouštět z ikony aplikace nebo používat přibalené webové soubory offline. Převod stránku zabalí do Android WebView; nepřevede HTML na nativní kód Androidu.

Co je formát HTM

HTM je třípísmenná přípona názvu souboru dokumentu HTML; .htm a .html představují stejný formát. Soubory HTM interpretují prohlížeče, jako jsou Chrome, Edge, Firefox a Safari, zatímco textové editory, webové editory a systémy pro správu obsahu je vytvářejí.

Soubor HTM může záviset na přidružených souborech CSS, JavaScript, obrázků, písem, zvuku nebo videa, případně načítat resources z webových URL. Zkopírování pouze hlavního souboru do aplikace proto může způsobit chybějící styly, nefunkční skripty nebo prázdné oblasti médií.

Co je formát APK

APK je instalovatelný formát aplikačních balíčků systému Android. Obsahuje manifest Androidu, zkompilovaný kód aplikace, resources, assets, oprávnění a informace o podpisu. Android může APK nainstalovat přímo, pokud je povoleno sideloading; Google Play obecně přijímá Android App Bundles a vytváří optimalizované APK pro jednotlivá zařízení.

Obal APK poskytuje ikonu aplikace, vstupní bod pro spuštění v Androidu, volitelné offline assets a řízený přístup k Android API. Automaticky však neposkytuje nativní UI, offline fungování ani kompatibilitu s pluginy určenými pouze pro prohlížeče a desktopovým JavaScript.

Jak vytvořit APK z lokálního souboru HTM

Android Studio je nejlépe kontrolovatelná desktopová metoda, protože stránka a její assets zůstávají lokální a projekt lze testovat proti vybraným verzím Androidu.

1. Nainstalujte Android Studio a požadované components Android SDK.
2. Vytvořte projekt pomocí New Project → Empty Views Activity. Vyberte Kotlin, nastavte application ID a zvolte minimální verzi Androidu vhodnou pro podporovaná zařízení.
3. Vytvořte app/src/main/assets/. Zkopírujte do něj hlavní soubor jako index.htm a zachovejte všechny relativní cesty k CSS, JavaScript, obrázkům, písmům a médiím. Zkopírujte také odkazované adresáře.
4. Přidejte WebView do layoutu activity, například s ID webView, a poté načtěte přibalenou stránku z activity:

val webView = findViewById<WebView>(R.id.webView)
webView.settings.javaScriptEnabled = true
webView.settings.domStorageEnabled = true
webView.loadUrl("file:///android_asset/index.htm")

JavaScript a DOM storage povolte pouze tehdy, když je stránka vyžaduje. Pokud stránka požaduje resources HTTPS nebo HTTP, přidejte do AndroidManifest.xml toto:

<uses-permission android:name="android.permission.INTERNET" />

Android 9 a novější blokuje cleartext HTTP u aplikací cílících na moderní úrovně SDK, pokud není nakonfigurována úzce vymezená výjimka network security. Upřednostňujte HTTPS. Odkazy, stahování, nahrávání souborů, přístup ke kameře, oprávnění, externí navigace a přehrávání médií mohou vyžadovat další WebViewClient, WebChromeClient, oprávnění Androidu nebo zpracování intentů.

5. Spusťte projekt na emulátoru a fyzickém zařízení Android. Otestujte posouvání, orientaci, škálování viewportu, JavaScript, local storage, odkazy, média, formuláře a všechny cesty k assets.
6. Vytvořte testovací APK pomocí Build → Build Bundle(s) / APK(s) → Build APK(s). Debug APK se obvykle nachází v app/build/outputs/apk/debug/.
7. Pro distribuci použijte Build → Generate Signed Bundle / APK, vyberte APK, vytvořte nebo vyberte release keystore a chraňte jeho hesla. Budoucí aktualizace musí používat stejnou signing identity.

Online a hostované alternativy

U veřejného webu nebo progressive web app může PWABuilder zkontrolovat web app manifest a service worker a vygenerovat Android packaging založený na nástrojích Trusted Web Activity. Web by měl používat HTTPS, být veřejně dostupný a splňovat požadované podmínky PWA. PWABuilder není obecný konvertor pro soukromý lokální soubor HTM.

Hostované služby pro převod webu na aplikaci, jako jsou AppsGeyser a Appilix, a komerční platformy, jako je Median.co, mohou z URL vygenerovat Android packages založené na WebView. Jsou vhodné pouze tehdy, pokud je přijatelné nahrát web nebo zdrojový kód; ověřte jejich aktuální podmínky exportu, brandingu, offline režimu, ochrany soukromí a signing. Obal URL stále vyžaduje, aby web zůstal online, pokud služba výslovně nepřibalí všechny resources.

Omezení kvality a kompatibility

Výsledkem je aplikace WebView, nikoli nativní přepis. Browser API, cross-origin requests, skripty určené pouze pro desktop, nepodporované pluginy, vložené přihlašovací údaje, chování service workeru, písma, media codecs a cookies třetích stran se mohou lišit od desktopových prohlížečů. Testujte na verzích Androidu, velikostech obrazovek a podmínkách sítě, na kterých záleží.

Pro skutečné offline použití přibalte všechny požadované resources a odstraňte síťové závislosti, případně použijte offline architekturu kompatibilní s Androidem a podle potřeby service worker. APK je obvykle větší než soubor HTM, protože obsahuje obal Androidu a přibalené assets.

Neznámé online konvertory mohou zpřístupnit soukromé HTML, skripty, přihlašovací údaje a odkazované assets. Pro důvěrné nebo lokální stránky použijte Android Studio a distribuujte APK podepsané pro release namísto debug buildu.