Tuto - Déployer une application mobile

• tester réellement l'application, toutes les fonctionnalités (comme la carte par exemple) étant disponibles.
• déployer l'application sur les mobiles.

1. Affichez la page d'accueil de WINDEV (Ctrl + <).
2. Dans la page d'accueil, cliquez sur "Tutoriel" puis dans la zone "Tuto - Développement d'une application Android/iOS", double-cliquez sur "Gestion de produits Android/iOS - Corrigé".

Génération de 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 tuto, choisissez l'option "Générer pour un déploiement libre (store privé, flotte d'entreprise, etc.)". Passez à l'étape suivante.
6. L'assistant vérifie la présence des 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.
    
    

    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.
      
      

      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.

Si l'appareil n'est pas connecté au poste de développement, il suffit de :

1. Connecter l'appareil au poste de développement.
2. 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".
3. Copier le fichier apk dans le dossier "Download" du matériel.
4. Débrancher le matériel.
5. Lancer l'application de gestion de fichiers sur le matériel.
6. Aller dans le répertoire "Download" et exécuter le fichier apk. L'application s'installe automatiquement.

Présentation

• Déploiement via Google Play (ou un autre market).
• Déploiement sur un serveur Web.
• Déploiement depuis le PC via ADB.
• Déploiement par copie du fichier apk.
• Déploiement via le Store Privé fourni avec WINDEV Mobile.

Déploiement via Google Play

• Lors de la première publication, il est nécessaire de s'enregistrer auprès du service Google Play à l'aide d'un compte Google. Une fois enregistré, il est possible de publier ou de mettre à jour autant d'applications que l'on souhaite autant de fois que nécessaire.
• L'application publiée doit être signée avec une clé cryptographique privée. Il est possible de signer soi-même sa propre application : le recours à un organisme tiers n'est pas obligatoire. La période de validité du certificat doit se terminer après le 23 octobre 2033.
  Les applications générées par WINDEV Mobile sont automatiquement signées en utilisant les informations fournies dans l'assistant de génération (étape "Signature de l'application") avec une durée de validité suffisante.
  Attention : L'application publiée ne doit pas avoir été signée en utilisant une clé générique (dont l'utilisation doit se limiter aux tests en mode GO).
• Une icône doit avoir été associée à l'application. L'assistant de génération de WINDEV Mobile permet de définir l'icône à utiliser.
  Remarque : Google Play est l'application la plus connue mais il en existe également d'autres.

Déploiement via un serveur Web

1. Copier le fichier "apk" de l'application sur le serveur Web hébergeant la page proposant le téléchargement de l'application.
   Rappel : le fichier "apk" est créé par WINDEV Mobile lors de la génération de l'application Android.
2. Ajouter un lien dans la page Web de téléchargement. Ce lien est de la forme :
   
   <a href='Chemin du fichier apk sur le serveur'>Lien</a>
3. Sur le serveur, ajouter le type MIME suivant : application/vnd.android.package-archive

Déploiement depuis le PC

Attention : L'activation du débogage USB est nécessaire pour utiliser le Centre de Contrôle Android. Si cette opération n'est pas effectuée, le téléphone ne sera pas détecté par le Centre de Contrôle Android.

Pour activer le débogage USB :

1. Sur le téléphone, sélectionnez le menu "Paramètres".
2. Sélectionnez le choix "A propos de l'appareil".
3. Cliquez plusieurs fois sur l'option "Numéro de build" pour activer le mode développeur.
4. Remontez d'un niveau.
5. Le choix "Option de développement" apparaît. Sélectionnez cette option.
6. Cochez l'option "Débogage USB".

Remarque : Selon la version du téléphone et sa marque, les manipulations à effectuer peuvent varier. Par exemple, pour un matériel de type Samsung Galaxy Notes 3, il est nécessaire de "tapoter" plusieurs fois le champ "Numéro de version" de l'option "A propos de l'appareil" afin d'activer le choix "Option de développement". Dans tous les cas, une recherche Google avec "débogage usb <nom périphérique>" permet d'avoir le mode opératoire adapté au matériel utilisé.

1. Connectez le téléphone au PC.
2. Lancez le Centre de Contrôle Android : sous le volet "Outils", dans le groupe "Outils Mobile", cliquez sur "CCAndroid".
3. Affichez l'onglet "Application". Cet onglet permet de lister les applications présentes sur le périphérique mais aussi d'installer une application (fichier APK présent sur le PC).

Copier l'application sur l'appareil Mobile

1. Connecter l'appareil au PC par USB.
2. Copier le fichier apk de l'application sur l'appareil (mémoire externe par exemple).
   Rappel : le fichier "apk" est créé par WINDEV Mobile lors de la génération de l'application Android.
3. Sur l'appareil, utiliser un explorateur de fichiers pour se rendre dans le répertoire où le fichier apk a été copié et cliquer sur le fichier pour lancer son installation.

Déploiement via le Store Privé fourni avec WINDEV Mobile