Převod souboru HTML do ANDROID

Webová stránka nebo offline HTML balíček vyžaduje tuto konverzi, pokud musí být nainstalován a spuštěn jako Android aplikace namísto otevření v prohlížeči. Použitelné výstupy pro Android jsou APK k instalaci nebo AAB pro Google Play, nikoli dokument .android.

Co je formát HTML

HTML je značkovací jazyk pro strukturování webových stránek a webových aplikací. Soubory obvykle používají příponu .html nebo .htm a vytvářejí se v textových editorech, nástrojích pro vývoj webu, systémech pro správu obsahu a nástrojích pro export webových stránek.

Dokument HTML může odkazovat na CSS, JavaScript, obrázky, fonty, video a další soubory. Prohlížeč tyto zdroje vykresluje přímo; aplikace pro Android je musí zobrazovat v komponentě prohlížeče, jako je WebView, zabalit pomocí hybridního frameworku nebo nahradit části rozhraní nativním kódem Androidu.

Co je formát Androidu

Neexistuje žádný standardní formát aplikací pro Android s názvem .android. Aplikace pro Android používají APK (balíček Androidu) k instalaci a AAB (Android App Bundle) pro publikování v Google Play. APK lze nainstalovat na kompatibilní zařízení; AAB je balíček pro nahrání, ze kterého Google Play generuje optimalizované soubory APK, a běžně se neinstaluje přímo.

Oba formáty obsahují zkompilovaný kód, zdroje, manifest a metadata aplikace. Nepřevádějí stránku HTML na nativní ovládací prvky Androidu. Aplikace založená na HTML obvykle obsahuje WebView, který načítá přibalené soubory nebo vzdálený web HTTPS.

Zabalení místního HTML pomocí Android Studio

Android Studio poskytuje největší kontrolu nad offline soubory, oprávněními, podepisováním a nativními funkcemi:

1. Vytvořte projekt Android s aktivitou založenou na Views a přidejte do jejího rozvržení WebView.
2. Vytvořte app/src/main/assets/www a zkopírujte do něj index.html, šablony stylů, skripty, obrázky, fonty a další prostředky; zachovejte přitom relativní cesty.
3. Dejte přednost WebViewAssetLoader před neomezenými adresami URL file://. Minimální nastavení v Kotlinu je:

val assetLoader = WebViewAssetLoader.Builder()
    .addPathHandler("/assets/", WebViewAssetLoader.AssetsPathHandler(this))
    .build()

webView.webViewClient = object : WebViewClient() {
    override fun shouldInterceptRequest(
        view: WebView,
        request: WebResourceRequest
    ) = assetLoader.shouldInterceptRequest(request.url)
}

webView.settings.javaScriptEnabled = true
webView.loadUrl("https://appassets.androidplatform.net/assets/www/index.html")

JavaScript povolte pouze v případě, že jej stránka potřebuje. Oprávnění INTERNET do souboru AndroidManifest.xml přidejte pouze tehdy, když aplikace přistupuje ke vzdáleným stránkám, rozhraním API nebo prostředkům; zcela místní balíček síťové oprávnění nepotřebuje.

Otestujte odkazy, načítání prostředků, chování tlačítka Zpět, otáčení obrazovky, zadávání pomocí klávesnice, stahování, oprávnění, úložiště a různé úrovně Android API v emulátoru i na fyzickém zařízení. Pomocí Build → Generate Signed Bundle / APK vytvořte produkční APK nebo AAB. Příkaz ./gradlew assembleDebug vytvoří debug APK podepsaný vývojovým klíčem; je určen k testování, nikoli k vydání v Google Play.

Použití hybridního frameworku

Capacitor a Cordova zabalí webový projekt do prostředí Androidu a poskytují pluginy pro vybrané funkce zařízení. Typický projekt s Capacitor používá nakonfigurovaný výstupní adresář webu a následně příkazy, jako jsou:

npm run build
npx cap add android
npx cap sync android
npx cap open android

Android Studio poté vytvoří a podepíše vygenerovaný projekt. Capacitor ani Cordova automaticky neposkytují nativní chování pro přístup ke kameře, oznámení, práci na pozadí, platby nebo práci se soubory; přidejte a nakonfigurujte příslušné pluginy a každou funkci otestujte.

Použití online PWA nebo obalu aplikace

U veřejné stránky HTTPS, která již funguje jako progresivní webová aplikace, může PWABuilder ověřit manifest a service worker a vygenerovat soubory pro balení Androidu pomocí nástrojů Trusted Web Activity. Výsledný projekt stále vyžaduje podepsání a testování v Androidu; PWABuilder není konvertor libovolného offline HTML.

Komerční služby pro převod webu na aplikaci, jako jsou Median nebo GoNative, mohou zabalit hostovaný web a podle tarifu mohou podporovat místní webové prostředky. Před použitím služby pro důvěrný obsah ověřte, zda se soubory nahrávají, která oprávnění a mosty JavaScriptu se přidávají, jak se nakládá s podpisovými klíči a zda služba podporuje požadované offline chování.

Omezení kvality a kompatibility

WebView používá webový engine založený na Chromium, jehož chování a dostupná webová API se liší podle verze Android System WebView v daném zařízení. Nepřevádí rozvržení CSS ani JavaScript na nativní widgety Androidu, takže responzivní rozvržení, přístupnost, výkon, navigace a dotykové ovládání vyžadují samostatné testování.

Vzdálené fonty, rozhraní API, analytika, obrázky, video a vložené služby bez síťového připojení selžou. Místní obsah může narazit na omezení související s požadavky mezi zdroji, service workery, úložištěm prohlížeče, stahováním a adresami URL se schématem file. Používejte relativní cesty k prostředkům a pro offline provoz přibalte všechny požadované prostředky.

Nevystavujte neomezené nativní mosty JavaScriptu nedůvěryhodným vzdáleným stránkám. Ověřujte adresy URL a omezte navigaci, pokud aplikace kombinuje přibalený obsah s externími weby. Produkční APK a AAB musí být podepsány; ztráta podpisového klíče může zabránit aktualizacím stávající aplikace. Google Play také posuzuje zabalené weby z hlediska užitečných funkcí, oprávnění a nakládání s uživatelskými údaji.