Convertir HTML en APK

Un APK est nécessaire lorsque le contenu HTML doit être installé, lancé et géré comme une application Android plutôt qu'ouvert dans un navigateur. Le résultat n'est pas une conversion directe de fichier : le code de l'application Android empaquette les fichiers web, l'icône de l'application, le manifest, les autorisations et les informations de signature.

Qu'est-ce que le HTML ?

HTML (HyperText Markup Language) est un langage de balisage en texte brut qui définit la structure des pages web et des interfaces basées sur un navigateur. Il est utilisé par les développeurs web, les systèmes de gestion de contenu, les créateurs de sites web et les éditeurs tels que Visual Studio Code et Adobe Dreamweaver.

Un projet HTML comprend généralement une page d'entrée telle que index.html, des feuilles de style CSS, du JavaScript, des images, des polices et d'autres ressources. Le HTML n'est pas un logiciel Android exécutable ; la création d'un APK nécessite un wrapper Android, contenant généralement une WebView qui affiche l'application web empaquetée.

Qu'est-ce qu'un APK ?

APK (Android Package Kit) est un package d'application Android installable. Il contient le manifest Android, le code compilé, les ressources, les ressources web incluses le cas échéant et une signature cryptographique qui identifie l'éditeur de l'application.

Les APK sont utiles pour tester des appareils, effectuer une distribution interne, réaliser un déploiement en entreprise, utiliser des appareils kiosque et effectuer une installation directe en dehors de Google Play. Android peut demander à l'utilisateur d'autoriser le navigateur ou le gestionnaire de fichiers utilisé à installer un APK provenant de sources inconnues.

Google Play exige généralement que les nouvelles applications soient importées sous la forme d'un .aab Android App Bundle, et non sous la forme d'un APK. Android Studio peut générer les deux formats à partir du même projet ; Google Play crée des APK optimisés pour chaque appareil à partir d'un Android App Bundle.

Empaqueter du HTML local avec Capacitor

Capacitor avec Android Studio est une option de bureau pratique pour un projet HTML, CSS et JavaScript local. Elle conserve les fichiers source et la clé de signature sous le contrôle du développeur et peut utiliser les fonctionnalités Android via des plugins Capacitor lorsque cela est nécessaire.

1. Créez un dossier de projet avec un sous-dossier www. Placez index.html, le CSS, le JavaScript, les images, les polices et les autres ressources locales dans www.
2. Utilisez des chemins relatifs tels que images/logo.png et ./styles.css. Ne faites pas référence à des fichiers présents sur l'ordinateur de développement, tels que C:\site\logo.png.
3. Ajoutez une balise viewport à index.html : <meta name="viewport" content="width=device-width, initial-scale=1">.
4. Testez les fichiers web dans un navigateur. L'empaquetage ne corrige pas les ressources manquantes, le JavaScript défectueux ou les API de navigateur non prises en charge.
5. Installez une version LTS actuelle de Node.js et Android Studio. Dans Android Studio, installez une plateforme Android SDK et les Build Tools via Tools → SDK Manager.
6. Ouvrez un terminal dans le dossier du projet et exécutez npm init -y, puis npm install @capacitor/core @capacitor/cli @capacitor/android.
7. Initialisez Capacitor avec npx cap init MyApp com.example.myapp --web-dir=www. Remplacez com.example.myapp par un ID d'application unique en notation reverse-domain.
8. Créez et synchronisez le projet Android : npx cap add android, puis npx cap sync android.
9. Ouvrez-le dans Android Studio avec npx cap open android.

Générer et signer l'APK

1. Attendez la fin de la synchronisation Gradle et installez les composants Android SDK demandés par Android Studio.
2. Créez un APK de test via Build → Build Bundle(s) / APK(s) → Build APK(s). Le fichier de débogage se trouve généralement à l'emplacement android/app/build/outputs/apk/debug/app-debug.apk.
3. Créez un APK release distribuable via Build → Generate Signed Bundle / APK → APK.
4. Créez ou sélectionnez un keystore, saisissez son alias de clé et ses mots de passe, sélectionnez la variante release, puis terminez la génération.

Conservez le keystore et ses identifiants dans une sauvegarde sécurisée. Les mises à jour utilisant le même ID d'application doivent être signées avec la même clé ; la perte de cette clé empêche les mises à jour normales des copies déjà installées. Après avoir modifié les fichiers dans www, exécutez npx cap sync android avant de générer une nouvelle version.

Option PWA hébergée

PWABuilder est une option web reconnue pour une progressive web app déjà déployée. Il peut produire un package Android basé sur une Trusted Web Activity lorsque le site utilise HTTPS et dispose d'un manifest web valide, d'un service worker et d'une vérification de domaine Digital Asset Links.

Une Trusted Web Activity charge le site web en ligne dans un fournisseur de navigateur tel que Chrome ; elle n'empaquette pas des fichiers HTML locaux arbitraires pour une utilisation hors ligne. Utilisez Capacitor ou un projet Android WebView natif lorsque les fichiers doivent être inclus dans l'APK ou que l'application doit fonctionner sans connexion.

Compatibilité et limites de qualité

Les applications Capacitor sont rendues via Android System WebView, qui peut différer de Chrome pour ordinateur. Testez la version Android la plus ancienne que vous prenez en charge, notamment la mise en page CSS, le comportement du clavier, la lecture multimédia, l'envoi et le téléchargement de fichiers, les fenêtres pop-up, l'accès à la caméra et les API JavaScript.

Les fichiers locaux inclus fonctionnent hors ligne uniquement lorsque toutes les ressources nécessaires sont incluses. Les API distantes, les scripts d'analyse, les polices web, les vidéos, les images et les scripts JavaScript externes nécessitent toujours un accès réseau. Les configurations Android modernes bloquent généralement le trafic http:// non chiffré ; les services distants doivent donc utiliser HTTPS.

La caméra, les notifications, l'accès aux fichiers, le partage et les fonctions similaires de l'appareil nécessitent des plugins Capacitor ou du code Android natif. Ces fonctionnalités peuvent également nécessiter des déclarations dans le manifest et des demandes d'autorisation au moment de l'exécution. Évitez les convertisseurs en ligne génériques « HTML to APK » pour les fichiers confidentiels ou les versions de production, car ils peuvent importer le code source, contrôler la clé de signature et offrir une maintenance limitée pour les évolutions d'Android.