• Génération de l'application Android.
• Génération de l'application iOS.

	Durée estimée : 20 mn

• Pour générer l'application Android :
  1. Sélectionnez si nécessaire la plateforme Android dans le volet "Explorateur de projet".
  2. Sous le volet "Projet", dans le groupe "Génération", cliquez sur "Générer" (vous pouvez également cliquer sur parmi les boutons d'accès rapide).
  3. L'assistant de génération d'une application Android se lance.
  4. Si nécessaire, choisissez la première fenêtre de l'application (FEN_Menu par exemple) et validez.
  5. La première étape de l'assistant consiste à demander le mode de génération de l'application. En effet, selon le mode choisi, le format de génération n'est pas le même.
     Pour ce cours, choisissez l'option "Générer pour un déploiement libre (store privé, flotte d'entreprise, etc.)". Passez à l'étape suivante.
  6. L'étape suivante de l'assistant consiste à vérifier les outils nécessaires à la génération de l'application Android.
     
     L'assistant propose de :
     • Télécharger et installer automatiquement le SDK Android et Gradle : dans ce cas, vous devez uniquement valider la licence. WINDEV Mobile s'occupe de tout. Si une mise à jour est disponible, l'assistant de génération vous proposera automatiquement de réaliser les mises à jour nécessaires. Seule une connexion Internet est nécessaire.
     • Utiliser les outils installés automatiquement. Cette option est disponible uniquement si vous avez téléchargé et installé les outils lors d'une précédente génération.
     • Spécifier l'emplacement des outils déjà installés sur votre poste. Dans ce cas, il suffit de préciser les chemins d'installation de Gradle et du SDK Android.
  7. Sélectionnez l'option correspondant à votre configuration et passez à l'étape suivante.
     Remarque : Si vous avez choisi de télécharger et installer les outils, le passage à l'étape suivant peut être relativement long et demander la validation de la licence.
  8. Passez à l'étape suivante en cliquant sur les touches fléchées au bas de l'assistant. L'étape suivante de l'assistant permet de :
     • définir le nom de l'application (affiché sous l'icône permettant de lancer l'application) et le package correspondant.
     • sélectionner l'icône de l'application dans le catalogue d'images de WINDEV Mobile (par exemple, "stock" dans le thème "Flat Soft").
     • définir l'adresse email utilisée par défaut si un rapport d'erreur doit être envoyé.
       
  9. Passez à l'étape suivante. Cette étape permet de définir :
     • le splash screen de l'application,
     • les informations enregistrées dans le manifeste,
     • le mode de lancement de l'application (lancement au démarrage du périphérique ou non).
  10. Passez à l'étape suivante. L'assistant permet de définir le numéro de version de l'application.
  11. Passez à l'étape suivante. Cette étape permet de signer l'application. L'assistant propose par défaut une signature générique, utilisable pour les tests de l'application. Pour une diffusion de l'application, il est nécessaire de posséder une signature spécifique.
      Pour plus de détails, consultez Génération d'une application pour Android.
  12. Passez à l'étape suivante. Comme nous avons choisi de générer l'application pour une flotte d'appareils, l'assistant propose de choisir le type d'appareils concernés. Conservez les options par défaut.
      

      	Note	Si vous possédez un appareil branché au PC, utilisez l'option "Détecter le matériel automatiquement". Ainsi, lors des prochaines générations, votre type d'appareil sera automatiquement sélectionné.
  13. L'étape suivante permet d'intégrer les fichiers de données dans l'application. Pour notre exemple, des fichiers de données HFSQL préremplis sont disponibles. Nous allons les livrer avec l'application. Dans ce cas, il est nécessaire de les indiquer dans l'étape "Intégration de fichiers".
      • Cliquez sur le bouton "Ajouter".
      • Sélectionnez les fichiers de données (.fic, .ndx et .mmo) présents dans le répertoire "EXE\\Application Android" du projet. La liste des fichiers apparaît.
      • Validez.
        

        	Note	Si votre projet utilise uniquement la plateforme Android, les fichiers sont à sélectionner dans le répertoire EXE du projet.
  14. Pour chaque fichier, cochez la case "Ecriture" (nécessaire pour pouvoir modifier les données depuis l'application).
      
  15. Passez à l'étape suivante.
  16. Validez les étapes suivantes jusqu'à l'étape "Configuration" qui permet de configurer les options du SDK Android et l'emplacement de l'installation.
      
  17. Passez à l'étape suivante.
  18. Cette étape est spécifique à l'utilisation du champ Carte. Elle permet de saisir la clé nécessaire à l'utilisation du champ Carte. Si vous possédez une clé Google Maps API, saisissez-la. Dans le cas contraire, cliquez sur "Obtenir une clé".
      
  19. Passez à l'étape suivante.
  20. Terminez l'assistant. La génération est automatiquement effectuée en tâche de fond.
      • Trois petits points (...) apparaissent dans la barre de titre de WINDEV Mobile pour indiquer que la génération est en cours. Une fenêtre de type popup est également affichée, précisant les étapes de la génération.
        
  21. A la fin de la génération, la fenêtre popup permet de copier et d'exécuter l'application directement sur l'appareil relié au poste ou sur un émulateur (bouton "Déployer").
      
  22. Une nouvelle fenêtre apparaît permettant de sélectionner le périphérique d'exécution. Si vous possédez un appareil Android connecté au poste de développement, sélectionnez le matériel connecté au PC.

	Note	Si l'appareil n'est pas connecté au poste de développement, il suffit de : Connecter l'appareil au poste de développement. Ouvrir sous l'explorateur le répertoire de génération du fichier apk correspondant à l'application Android : sous le volet "Accueil", dans le groupe "Général", déroulez l'option et sélectionnez "Ouvrir le répertoire de génération". Copier le fichier apk dans le dossier "Download" du matériel. Débrancher le matériel. Lancer l'application de gestion de fichiers sur le matériel. Aller dans le répertoire "Download" et exécuter le fichier apk. L'application s'installe automatiquement.

• Pour générer l'application iOS :
  1. Sélectionnez si nécessaire la plateforme iOS via le volet "Explorateur de projet".
  2. Sous le volet "Projet", dans le groupe "Génération", cliquez sur "Générer" (vous pouvez également cliquer sur parmi les boutons d'accès rapide).
  3. Si nécessaire, choisissez la première fenêtre de l'application (FEN_Menu par exemple) et validez.
  4. L'assistant de génération d'une application iOS se lance.
  5. L'assistant permet de :
     • définir le nom de l'application, la société et le copyright.
     • saisir l'identifiant du bundle.
       

       	Note	Cet identifiant est l'identifiant unique de votre application auprès de Apple. Il se définit et s'enregistre sur le compte développeur Apple. Cet identifiant permettra d'enregistrer votre application pour pouvoir la tester et la déployer. Par défaut, WINDEV Mobile propose automatiquement un identifiant respectant les normes de développement Apple actuelles. Vous pouvez modifier cet identifiant.
     • définir l'adresse email utilisée par défaut si un rapport d'erreur doit être envoyé.
       
  6. Passez à l'étape suivante.
  7. Vous pouvez indiquer le chemin des différentes icônes de l'application pour chaque type de matériel.
  8. Passez à l'étape suivante.
  9. Indiquez les caractéristiques de l'écran de lancement (Splash Screen).
  10. Passez à l'étape suivante.
  11. Indiquez le numéro de version de l'application générée.
  12. Passez à l'étape suivante.
  13. Cette étape permet d'intégrer des fichiers spécifiques (fichiers de données, images, ...).
      • Cliquez sur le bouton "Ajouter".
      • Sélectionnez les fichiers de données (.fic, .ndx et .mmo) présents dans le répertoire "EXE\\Application iOS" du projet. La liste des fichiers apparaît.
        
  14. Indiquez que ces fichiers de données doivent être en écriture : cochez la case "Ecriture".
  15. Passez à l'étape suivante.
  16. L'assistant vous permet d'indiquer :
      • si l'application est autorisée à être redimensionnée ou non (Split View). Cette option permet notamment à l'utilisateur final d'afficher deux fenêtres de deux applications différentes côte à côte sur certains matériels.
      • si le partage des fichiers avec iTunes est possible. Si cette option est cochée, il sera possible de récupérer les fichiers de l'application sur le Mac lors de la synchronisation. Par exemple, si des fichiers de données ont été livrés avec l'application, l'application iTunes permettra de récupérer ces fichiers.
      • la version minimale nécessaire d'iOS pour exécuter l'application.
        
  17. Passez à l'étape suivante. Cette étape permet d'indiquer les options de signature pour Xcode.
      Pour plus de détails, consultez Signature des applications iOS.
  18. Validez l'assistant.
  19. La génération est réalisée dans le dossier EXE du répertoire du projet. Le répertoire contenant les sources à utiliser sur le Mac s'appelle "Nom_du_projet.xcode.gen" (pour notre exemple "WM Gestion Produits.xcode.gen"). C'est ce répertoire qui doit être copié sur le Mac. Cliquez sur le bouton "Ouvrir le répertoire de génération".
      

      	Note	A tout moment, le répertoire de génération de la configuration de projet en cours peut être affiché : sous le volet "Accueil", dans le groupe "Général", déroulez l'option et sélectionnez "Ouvrir le répertoire de génération".

Transférer le projet WINDEV Mobile sur le Mac

• Pour transférer le projet WINDEV Mobile sur le Mac :
  1. Copiez le dossier complet généré dans le répertoire EXE sur un support externe (clé USB, disque dur externe, répertoire partagé avec le Mac sur le réseau). Ce répertoire a pour nom <Nom du projet>.xcode.gen.
  2. Collez ce dossier sur le Mac qui va compiler l'application.
  3. Ouvrez le dossier sur le Mac et ouvrez le fichier nommé "Nom_du_projet.xcodeproj".
  4. Le projet s'ouvre dans Xcode.

Compiler le projet sous Xcode

• Pour compiler le projet sous Xcode :
  1. Dans la liste déroulante en haut à gauche, sélectionnez les options de compilation. Sélectionnez le scheme correspondant à votre application puis la cible de compilation (appareil actuellement connecté ou un simulateur).
  2. Pour lancer la compilation, cliquez sur l'option de menu "Product .. Clean" puis sur l'option de menu "Product .. Build".
  3. Un compte-rendu de compilation apparaît en haut ("Succeeded" ou sinon le nombre de warnings et d'erreurs). Vous pouvez cliquer sur ces symboles pour voir la liste des erreurs/warnings.
  4. Une fois le programme compilé sans erreurs, vous pouvez lancer la simulation (Option "Product .. Run"). La fenêtre de simulation apparaît avec l'application.