Réalisé sous Windows 11.
¶ 🪛 Pré-requis
- Android Studio - obligatoire pour avoir les SDK
- Java JDK - Vérifier que la version de Java et compatible avec Gradle
- Avoir configurer les variables d'environnement
JAVA_HOMEetANDROID_HOME
¶ 🤖 Android Studio
- Installation Android Studio - pas besoin d'installer AVD (Android Virtual Device) - et lancez-le.
- Au premier lancement, on séléctionne
customet on déséléctionne encoreAndroid Virtual Device, continuez pour lancer le téléchargement des outils nécessaire.
- Au premier lancement, on séléctionne
¶ JAVA JDK
Attention à la version de Java JDK, certaines ne sont pas compatibles avec Gradle, voir : https://docs.gradle.org/current/userguide/compatibility.html
- Téléchargez et installez Java JDK : https://www.oracle.com/java/technologies/downloads/
¶ 🔍 Variables d'environnement
Si les variables JAVA_HOME et ANDROID_HOME ne sont pas configurées, ajouter dans les variables d'environnement systèmes :
JAVA_HOMEqui pointe surC:\Program Files\Java\jdk-xxANDROID_HOMEqui pointe surC:\Users\xxxxx\AppData\Local\Android\Sdk
- Dans la variable
Pathajouter%JAVA_HOME%\bin - Dans la variable
Pathajouter%ANDROID_HOME%\platform-tools
Pour tester si les variables ont été prises en compte, fermez tous les terminaux, rouvrez-en une et tapez adb. S'il ne connait pas la commande, c'est pas bon, si le help s'affiche, c'est OK.
¶ 🔧 Installer Capacitor
npm install @capacitor/core @capacitor/cli
¶ Initialisez Capacitor dans le projet
npx cap init
¶ Ajout de la plateforme Android, ça va créer le dossier Android au projet
npm install @capacitor/android
npx cap add android
¶ Synchronisation de Capacitor avec le projet
npm run build
npx cap sync
Le fichier capacitor.settings.gradle est créé.
¶ 📦 Build de l'APK
npm run build
¶ Copie des fichiers du build Vue.js (dist) dans le projet Android
npx cap copy
cd android
gradlew assembleDebug
Et l'APK sera dans
android/app/build/outputs/apk
¶ Erreur Gradle
Si erreur Unsupported class file major version 67 c'est que la version de gradle n'est pas compatible avec la version de java JDK.
Il faut changer la version de gradle dans le fichier : android/gradle/wrapper/gradle-wrapper.properties.
- https://docs.gradle.org/current/userguide/compatibility.html pour récupérer le numéro de version adéquat par rapport à votre version de JAVA JDK.
- https://services.gradle.org/distributions/ pour voir toutes les version dispo si besoin.
Normalement en générant l'apk il va le mettre à jour
./gradlew assembleDebug
sinon on force avec
./gradlew wrapper --gradle-version x.x
Et si besoin, on peut clean le cache
./gradlew clean