Android

Mise en place de l'environnement de développement

Quasar utilise Cordova et Gradle pour générer les applications Android. Ci-après les documentations officielles :

• https://quasar.dev/quasar-cli/developing-cordova-apps/preparation

• https://cordova.apache.org/docs/en/latest/guide/platforms/android/#installing-the-requirements

Pour Windows

1. Installer Android studio, ou installer la dernière mise à jour.

2. Installer ou mettre à jour les éléments suivant depuis "Configure" > "SDK Manager"

   1. "SDK Platform" for API level android-25

   2. "Android SDK Platform-tools (latest)

   3. "Android SDK Build-tools" (latest)

3. Créer un appareil virtuel : AVD (Android Virtual Device)

   1. "Configure" > "AVD Manager"

   2. "+ Create Virtual Device..."

   3. Choisir un modèle sans le "Play Sotore". Par exemple Pixel 2 XL

   4. "Next"

   5. Choisi un des derniers systèmes et le télécharger (API 30, Q, ... )

   6. "Next"

   7. Dans la fenêtre "Verify Configuration"

      1. "Show Advanceed Settings"

      2. Choisir "Cold boot", diminue le risque d'erreurs au démarrage

   8. "Finish"

   9. Démarrer l'AVD pour voir s'il fonctionne.

      1. Si l'AVD ne démarre pas, modifier les paramètres (icône crayon) de l'AVD et choisir l'option "Software" dans Emulated Performance > Graphics.

   10. Éteindre et fermer l'AVD

4. Accepter les licences

   1. Aller dans le dossier suivant : C:\Users\[nom utilisateur]\AppData\Local\Android\Sdk\tools\bin

   2. L'ouvrir dans le terminal (taper cmd dans la barre d'adresse de l'explorateur de fichier Windows)

   3. Exécuter la commande suivante : sdkmanager --licenses

   4. Accepter toutes les licences

5. Java et variables d'environnement

   1. Installer Java 8

   2. Vérifier que vous avez une variable d'environnement système JAVA_HOME référençant la version JDK 1.8.X

   3. Installer Gradle :

      1. Télécharger Gradle verson 4.10 : https://downloads.gradle-dn.com/distributions/gradle-4.10.3-all.zip

      2. Créer un dossier c:\Gradle\ et y décompresser l'archive

      3. Ajouter gradle au PATH : C:\Gradle\gradle-4.10.3\bin\

      4. Ouvrir un nouveau terminal, fermer l'ancien si ouvert, et tester avec gradle -v

   4. Variable d'environnement Android

      1. S'assurer que la variable d'environnement ANDROID_HOME existe et pointe vers C:\Users\[nom utilisateur]\AppData\Local\Android\Sdk

      2. Assurez vous que les dossiers suivant sont dans le PATH :

         1. %ANDROID_HOME%\tools

         2. %ANDROID_HOME%\tools\bin

         3. %ANDROID_HOME%\platform-tools

   5. Installer Cordova

   # Installer Cordova 
   npm install -g cordova
   
   cordova -v
   # 9.0.0 (cordova-lib@9.0.1)

Pour Mac (doc à venir ... )

Attention !!! Depuis macOs Big Sur, c'est le fichier .zprofile qui est chargé par défaut pour configurer les variables d'environnement. Il faut donc y ajouter le code suivant pour qu'il appelle .bash_profile

[[ -e ~/.bash_profile ]] && emulate sh -c 'source ~/.bash_profile'

Créer un fichier .bash_profile avec le code suivant à la racine de votre dossier utilisateur :

#Modifier les libraireis dans .bashrc
if [ -f ~/.bashrc ]; then
   source ~/.bashrc
fi

Créer le fichier qui .bashrc contiendra vos variables :

# Java
export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)

# Android
export ANDROID_HOME=$HOME/Library/Android/sdk

export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/emulator #doit être avant /tools
export PATH=$PATH:$ANDROID_HOME/tools
# export PATH=$PATH:$ANDROID_HOME/build-tools/28.0.2

ou :

export ANDROID_SDK_ROOT="$HOME/Library/Android/sdk"
export ANDROID_HOME=$ANDROID_SDK_ROOT

PATH="$ANDROID_SDK_ROOT/tools:$PATH"
PATH="$ANDROID_SDK_ROOT/emulator:$PATH"
PATH="$ANDROID_SDK_ROOT/platform-tools:$PATH"

https://quasar.dev/quasar-cli/developing-cordova-apps/preparationquasar.dev

The New Quick Share App for Windows | Androidwww.android.com

Ajouter Android au projet Quasar

Ouvrir le dossier du projet Quasar dans le terminal et exécuter les commandes suivantes :

# Ajouter cordova au projet
quasar mode add cordova

# Aller dans le nouveau dossier src-cordova
cd src-cordova

# Ajouter Android au projet Cordova
cordova platform add android

# Tester l'environnement de développement
cordova requirements
# Requirements check results for android:
# Java JDK: installed 1.8.0
# Android SDK: installed true
# Android target: installed android-29,android-25
# Gradle: installed C:\Gradle\gradle-4.10.3\bin\gradle

Démarrer l'application en mode développement

quasar dev -m cordova -T android

Créer l'application finale

quasar build -m android