Convertir HTML en ANDROID

Un site web ou un package HTML hors ligne nécessite cette conversion lorsqu’il doit être installé et lancé comme une application Android au lieu d’être ouvert dans un navigateur. Les formats Android utilisables sont un APK pour l’installation ou un AAB pour Google Play, et non un document .android.

Qu’est-ce que le format HTML ?

HTML est un langage de balisage destiné à structurer les pages web et les applications web. Les fichiers utilisent généralement l’extension .html ou .htm et sont produits par des éditeurs de texte, des outils de développement web, des systèmes de gestion de contenu et des outils d’exportation de sites web.

Un document HTML peut référencer des fichiers CSS, JavaScript, des images, des polices, des vidéos et d’autres fichiers. Un navigateur affiche directement ces ressources ; une application Android doit les afficher dans un composant de navigateur tel que WebView, les intégrer avec un framework hybride ou remplacer certaines parties de l’interface par du code Android natif.

Qu’est-ce que le format Android ?

Il n’existe pas de format d’application Android standard nommé .android. Les applications Android utilisent un APK (package Android) pour l’installation et un AAB (Android App Bundle) pour la publication sur Google Play. Un APK peut être installé sur un appareil compatible ; un AAB est un bundle envoyé à Google Play, qui génère des APK optimisés, et il n’est normalement pas installé directement.

Les deux formats regroupent du code compilé, des ressources, un manifest et les métadonnées de l’application. Ils ne transforment pas une page HTML en contrôles Android natifs. Une application basée sur HTML contient généralement un WebView qui charge des fichiers intégrés ou un site HTTPS distant.

Intégrer du HTML local avec Android Studio

Android Studio offre le meilleur contrôle sur les fichiers hors ligne, les autorisations, la signature et les fonctionnalités natives :

1. Créez un projet Android avec une activity basée sur Views et ajoutez un WebView à sa mise en page.
2. Créez app/src/main/assets/www et copiez-y index.html, les feuilles de style, les scripts, les images, les polices et les autres ressources, tout en préservant les chemins relatifs.
3. Privilégiez WebViewAssetLoader aux URL file:// sans restriction. Une configuration Kotlin minimale est la suivante :

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")

Activez JavaScript uniquement si la page en a besoin. Ajoutez l’autorisation INTERNET à AndroidManifest.xml uniquement lorsque l’application accède à des pages, des API ou des ressources distantes ; un package entièrement local n’a pas besoin d’une autorisation réseau.

Testez les liens, le chargement des ressources, le comportement du bouton Retour, la rotation de l’écran, la saisie au clavier, les téléchargements, les autorisations, le stockage et les différents niveaux d’API Android sur un émulateur et un appareil physique. Utilisez Build → Generate Signed Bundle / APK pour créer un APK ou un AAB de production. ./gradlew assembleDebug crée un APK de débogage signé avec la clé de développement ; il est destiné aux tests et non à une publication sur Google Play.

Utiliser un framework hybride

Capacitor et Cordova intègrent un projet web dans une enveloppe Android et fournissent des plugins pour certaines fonctionnalités de l’appareil. Avec Capacitor, un projet classique utilise un répertoire de sortie web configuré, suivi de commandes telles que :

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

Android Studio compile et signe ensuite le projet généré. Capacitor ou Cordova ne fournissent pas automatiquement de comportement natif pour l’accès à la caméra, les notifications, les tâches en arrière-plan, les paiements ou la gestion des fichiers ; ajoutez et configurez les plugins appropriés, puis testez chaque fonctionnalité.

Utiliser une PWA en ligne ou une enveloppe d’application

Pour un site HTTPS public qui fonctionne déjà comme une progressive web app, PWABuilder peut valider le manifest et le service worker, puis générer des fichiers de packaging Android à l’aide des outils Trusted Web Activity. Le projet obtenu doit toujours être signé et testé sur Android ; PWABuilder n’est pas un convertisseur de HTML hors ligne quelconque.

Les services commerciaux de conversion web vers application, tels que Median ou GoNative, peuvent encapsuler un site web hébergé et prendre en charge les ressources web locales, selon l’offre choisie. Vérifiez si les fichiers sont téléversés, quelles autorisations et quels ponts JavaScript sont ajoutés, comment les clés de signature sont gérées et si le service prend en charge le comportement hors ligne requis avant de l’utiliser pour du contenu confidentiel.

Limitations de qualité et de compatibilité

Un WebView utilise le moteur web basé sur Chromium d’Android, dont le comportement et les API web disponibles varient selon la version de WebView du système Android installée sur l’appareil. Il ne convertit pas les mises en page CSS ou JavaScript en widgets Android natifs : la mise en page responsive, l’accessibilité, les performances, la navigation et le comportement tactile nécessitent donc des tests distincts.

Les polices distantes, les API, les outils d’analyse, les images, les vidéos et les services intégrés échouent sans accès réseau. Le contenu local peut rencontrer des restrictions concernant les requêtes cross-origin, les service workers, le stockage du navigateur, les téléchargements et les URL de fichiers. Utilisez des chemins de ressources relatifs et intégrez toutes les ressources nécessaires au fonctionnement hors ligne.

N’exposez pas de ponts JavaScript natifs sans restriction à des pages distantes non fiables. Validez les URL et limitez la navigation lorsque l’application mélange du contenu intégré et des sites externes. Les APK et AAB de production doivent être signés ; la perte de la clé de signature peut empêcher les mises à jour d’une application existante. Google Play évalue également les sites web encapsulés en fonction de leur utilité, de leurs autorisations et de leur gestion des données utilisateur.